Aracılığıyla paylaş

Duyarlı Reklam Kaydı - Toplu

  • Makale

Toplu dosyada indirilebilen ve karşıya yüklenebilen duyarlı bir reklam tanımlar.

Duyarlı reklamlar, hedef kitle reklam biçimlerinin boyutlarını ve şekillerini karşılayacak şekilde otomatik olarak ayarlanır. Bu reklamlar, eylem çağrıları yerine bilgilendirici metinlerle en iyi şekilde çalışır.

Not

Bu özellik şu anda ABD, Kanada, Birleşik Krallık ve Avustralya'da kullanılabilir. ABD, Kanada, Birleşik Krallık veya Avustralya'da reklam ve hedef kitle reklamlarına katılmayı tercih ediyorsanız desteğe başvurun.

Not

Aynı reklam grubunda yinelenen duyarlı reklamlara izin verilir.

Hesaptaki tüm Responsive Ad kayıtlarını DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine ResponsiveAdsDownloadEntity değerini ekleyerek indirebilirsiniz. Ayrıca indirme isteğinin EntityData kapsamını içermesi gerekir. En iyi yöntemler de dahil olmak üzere Toplu hizmet hakkında daha fazla ayrıntı için bkz. Toplu İndirme ve Karşıya Yükleme.

Aşağıdaki Toplu CSV örneği, geçerli bir Ebeveyn Kimliği değeri sağlanırsa yeni bir duyarlı reklam ekler.

Type,Status,Id,Parent Id,Campaign,Ad Group,Sync Time,Client Id,Modified Time,Tracking Template,Final Url Suffix,Custom Parameter,Final Url,Mobile Final Url,Text,Business Name,Device Preference,Ad Format Preference,Name,Call To Action,Headline,Long Headline,Images
Format Version,,,,,,,,,,,,,,,,,,6.0,,,,
Responsive Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,{_promoCode}=PROMO1; {_season}=summer,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,Find New Customers & Increase Sales! Start Advertising on Contoso Today.,Contoso,,,,,Short Headline Here,Long Headline Here,"[{""id"":1234567890000,""subType"":""LandscapeImageMedia""}]"

.NET, Java veya Python için Bing Ads SDK'larını kullanıyorsanız, hizmet işlemlerini doğrudan çağırmak ve toplu dosyadaki her alanı ayrıştırmak için özel kod yazmak yerine BulkServiceManager kullanarak BulkResponsiveAd nesnesini karşıya yükleyip indirebilirsiniz.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkResponsiveAd
var bulkResponsiveAd = new BulkResponsiveAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ResponsiveAd object of the Campaign Management service.
    ResponsiveAd = new ResponsiveAd
    {
        // 'Call To Action' column header in the Bulk file
        CallToAction = CallToAction.AddToCart,
        // 'Mobile Final Url' column header in the Bulk file
        FinalMobileUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://mobile.contoso.com/womenshoesale"
        },
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://www.contoso.com/womenshoesale"
        },
        // 'Headline' column header in the Bulk file
        Headline = "Short Headline Here",
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Images' column header in the Bulk file
        Images = new[]
        {
            // Each AssetLink is represented as a JSON list item in the Bulk file.
            new AssetLink
            {
                Asset = new ImageAsset
                {
                    CropHeight = null,
                    CropWidth = null,
                    CropX = null,
                    CropY = null,
                    Id = landscapeImageMediaId,
                    SubType = "LandscapeImageMedia"
                },
            },
        },
        // 'Long Headline' column header in the Bulk file
        LongHeadlineString = "Long Headline Here",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales! Start Advertising on Contoso Today.",
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
};

uploadEntities.Add(bulkResponsiveAd);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Duyarlı Reklam kaydı için Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları kullanılabilir.

Reklam Grubu

Reklamı içeren reklam grubunun adı.

Eklemek: Salt okunur ve Gerekli
Güncelleştirmek: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

Not

Ekleme, güncelleştirme ve silme için Üst Kimlik veya Ad Grubu alanını belirtmeniz gerekir.

İş Adı

İşletmenin adı.

Hedef kitle reklamınızın yerleşimlerine bağlı olarak, işletmenizin adı reklamınızın içinde görünebilir.

Dizenin uzunluğu 25 karakterle sınırlıdır.

Eklemek: Gerekli
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Eyleme Çağır

Müşterilerin şu anda reklamınızı tıklaması için kısa ve yumruklu bir neden.

Arama multimedya reklamları için kullanılabilecek eylemlere yönelik çağrı:

Eylem çağrısı
Şimdi Davran
Şimdi Uygula
Şimdi Bahis Oyna
Şimdi TeklifLe
Araba rezervasyonu
Book Hotel
Şimdi Rezervasyon
Şimdi Derle
Şimdi Satın Al
Şimdi Sohbet Edin
Karşılaştırmak
Bize Ulaşın
Bayi
Yol Tarifleri
Bağışlamak
İndir
Şimdi E-posta Gönder
Şimdi Kaydet
Şimdi Dosyala
İş Bul
Mağaza Bul
Ücretsiz Oyun
Ücretsiz Teklif
Ücretsiz deneme
Kupon Al
Anlaşmaları Edinin
Tanıtım Al
Şimdi Edinin
Teklif alma
Teklif Al
Tanıtıma git
Hemen katıl
Daha Fazla Bilgi Edinin
Şimdi Dinle
Oturum aç
Şimdi Sipariş Ver
Oyun Oyna
Şimdi Oynat
İşi Deftere Naklettiğinde
Kaydol
Şimdi yenile
Araba kiralama
Şimdi kiralayın
Sipariş
Ayırmak
Şimdi kaydet
Tarife
Bkz. tanıtım
Bkz. menü
Modelleri görme
Teklife bakın
Teklifleri görme
Satışa bakın
Şimdi sat
Şimdi alışveriş yapın
Gösteri zamanları
Oturum açın
Kaydolma
Şimdi başlayın
Abone olun
Test sürüşü
Şimdi deneyin
Araçları görüntüleme
Tanıtım görüntüleme
Planları görüntüleme
Mağazayı ziyaret edin
Şimdi oy verin
İzle
Daha fazla izleyin
Şimdi izleyin

Eklemek: Hedef kitle reklamları için geçerli değildir.
Güncelleştirmek: Salt okunur
Silmek: Salt okunur

Eyleme Çağrı Langauge

Eylem çağrısının sunulduğu dil.

Kampanyanın dil ayarları ne olursa olsun eylem çağrısı her zaman bu dilde sunulur.

Arama multimedya reklamları için kullanılabilecek eylem dillerine çağrı:

Eylem çağrısı
Dil.Arnavut dili
Language.Arapça
Language.Bosnian
Dil.Bulgarca
Dil.Hırvat dili
Language.Czech
Language.Danca
Language.Dutch
Language.English
Language.Estonya dili
Dil.Fince
Language.French
Language.Almanca
Language.Yunanca
Language.İbranice
Language.Macarca
Language.İzlanda dili
Language.Italian
Language.Japonca
Language.Letonca
Language.Litvanca
Dil.Makedon dili
Language.Maltese
Language.Norveç dili
Language.Polish
Language.Portekizce
Language.Rumence
Dil.Rusça
Language.Serbian
Language.Slovak
Language.Slovenya dili
Language.İspanyolca
Dil.İsveççe
Language.TraditionalChinese
Language.Turkish

Eklemek: Hedef kitle reklamları için geçerli değildir; Multimedya reklamları için gereklidir.
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Kampanya

Reklam grubunu ve reklamı içeren kampanyanın adı.

Eklemek: Salt okunur
Güncelleştirmek: Salt okunur
Silmek: Salt okunur

İstemci Kimliği

Toplu karşıya yükleme dosyasındaki kayıtları sonuç dosyasındaki kayıtlarla ilişkilendirmek için kullanılır. Bu alanın değeri sunucu tarafından kullanılmaz veya depolanmaz; yalnızca karşıya yüklenen kayıttan ilgili sonuç kaydına kopyalanır. Uzunluğu 100'e kadar olan geçerli bir dize olabilir.

Eklemek: Opsiyonel
Güncelleştirmek: Opsiyonel
Silmek: Salt okunur

Özel Parametre

URL izleme için özel anahtar ve değer parametreleri koleksiyonunuz.

Toplu bir dosyada, özel parametrelerin listesi aşağıdaki gibi biçimlendirilir.

  • Her özel parametre çiftini Key=Value olarak biçimlendirin, örneğin {_promoCode}=PROMO1.

  • Microsoft Advertising, dahil ettiğiniz ilk 8 özel parametre anahtarı ve değer çiftini kabul eder ve 8'den fazla özel parametre eklerseniz hata döndürülür. Her anahtar ve değer çifti noktalı virgül ve boşlukla ("; "), örneğin {_promoCode}=PROMO1; {_season}=summer.

  • Anahtar noktalı virgül içeremez. Bir Değer noktalı virgül içeriyorsa , '\;' olarak kaçış olmalıdır. Buna ek olarak, Değer ters eğik çizgi içeriyorsa , '\' olarak da kaçılmalıdır.

  • Anahtar 16 UTF-8 bayt'ı ve Değer 250 UTF-8 bayt'ı aşamaz. Anahtar gereklidir ve Değer isteğe bağlıdır. Anahtarın en büyük boyutu ayraçları ve alt çizgiyi (örneğin, '{', '_' ve '}' içermez.

    Not

    Toplu hizmet ile Anahtar çevresindeki küme ayraçlarıyla ve baştaki bir alt çizgiyle biçimlendirilmelidir; örneğin Anahtar promoCode ise {_promoCode} olarak biçimlendirilmelidir. Kampanya Yönetimi hizmetiyle, çevresindeki ayraçları ve alt çizgiyi belirtemezsiniz.

Eklemek: Opsiyonel
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Tüm özel parametreleri kaldırmak için bu alanı delete_value olarak ayarlayın. delete_value anahtar sözcüğü önceki ayarı kaldırır. Özel parametrelerin bir alt kümesini kaldırmak için, saklamak istediğiniz özel parametreleri belirtin ve saklamak istemediğiniz parametreleri atlarsınız. Yeni özel parametre kümesi, önceki özel parametre kümelerinin yerini alır.
Silmek: Salt okunur

Açıklama

Hedef kitle reklamınızın yerleşimine bağlı olarak, bu metin reklamınızın uzun veya kısa başlığının altında veya yanında görünür.

Reklam metninde çalışmak için başlıktan daha fazla karakter alanınız vardır. Bu nedenle, görüntü ve başlık potansiyel bir müşterinin dikkatini çektikten sonra reklam metninin onu tıklamaya ikna etmesi gerekir. Ürününüzü veya hizmetinizi birbirinden ayıran nedir?

Metin en az bir sözcük içermelidir.

Açıklamaların üst sınırı 5'tir. Dizenin uzunluğu 90 karakterle sınırlıdır. Başlıkların veri biçimi aşağıdaki örnek JSON'a eklenmiştir.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Eklemek: Hedef kitle reklamları ve multimedya reklamları için gereklidir. Video reklamları için geçerli değildir. Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Silmek: Salt okunur

Editoryal İtiraz Durumu

Editör incelemesinde bulunan sorunlara itiraz edip etmeyeceğinizi belirler.

Olası değerler aşağıdaki tabloda açıklanmıştır.

Değer Açıklama
Çekici Editörlük sorunu caziptir.
AppealPending Editörlük sorunu itiraz edilebilir ve bir itirazda bulundu.
NotAppealable Editörlük sorunu cazip değildir.

Eklemek: Salt okunur
Güncelleştirmek: Salt okunur
Silmek: Salt okunur

Editoryal Konum

Editoryal incelemede başarısız olan reklamın bileşeni veya özelliği.

Eklemek: Salt okunur
Güncelleştirmek: Salt okunur
Silmek: Salt okunur

Editoryal Neden Kodu

Hatanın nedenini tanımlayan bir kod. Olası neden kodlarının listesi için bkz . Editoryal Neden Kodları.

Eklemek: Salt okunur
Güncelleştirmek: Salt okunur
Silmek: Salt okunur

Editoryal Durum

Reklamın editoryal durumu.

Olası değerler aşağıdaki tabloda açıklanmıştır.

Değer Açıklama
Etkin Reklam, editoryal incelemeden geçti.
ActiveLimited Reklam, bir veya daha fazla pazarda editoryal incelemeden geçti ve reklamın bir veya daha fazla öğesi başka bir pazarda editoryal incelemeden geçiyor. Örneğin, reklam Kanada için editoryal incelemeden geçmiştir ve abd'de gözden geçirmeyi beklemeye devam etmektedir.
Onaylanmadı Reklam, editoryal incelemede başarısız oldu.
Tembel Reklamın bir veya daha fazla öğesi editör tarafından inceleniyor.

Eklemek: Salt okunur
Güncelleştirmek: Salt okunur
Silmek: Salt okunur

Editoryal Terim

Editoryal incelemede başarısız olan terim.

Hataya bir terim birleşimi neden olursa veya hata bir ilke ihlaline dayandıysa bu alan ayarlanmaz.

Eklemek: Salt okunur
Güncelleştirmek: Salt okunur
Silmek: Salt okunur

Son Url

Giriş sayfası URL'si.

URL'nin etki alanı bölümü, yol 1 ve yol 2 dizeleriyle birlikte 67 karakteri aşamaz.

Son URL'ler ve Son Mobil URL'ler için aşağıdaki doğrulama kuralları geçerlidir.

  • URL'nin uzunluğu 2.048 karakterle sınırlıdır. HTTP veya HTTPS protokol dizesi 2.048 karakter sınırına doğru sayılır.

  • Hem Son URL'ler hem de Son Mobil URL'ler için en fazla 10 öğe belirtebilirsiniz; ancak, teslimat için her listedeki yalnızca ilk öğe kullanılır. Hizmet, olası ileriye dönük uyumluluk için en fazla 10'a kadar izin verir.

  • Her URL noktalı virgül ve boşluk ("; ") ile sınırlandırılır.

  • '{' ve '}' kullanımı yalnızca etiketlerin (örneğin, "{lpurl}") çizgisini belirlemeye izin verilir.

  • Her URL, http:// veya https:// ile başlayan iyi biçimlendirilmiş bir URL olmalıdır.

  • Son Mobil URL'leri belirtirseniz Son Url'yi de belirtmeniz gerekir.

ayrıca İzleme Şablonu veya Özel Parametre alanları ayarlanırsa en az bir Son URL'nin gerekli olduğunu unutmayın.

Not

Bu URL yalnızca anahtar sözcüğü son URL'yi belirtmiyorsa kullanılır.

Eklemek: Gerekli
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Son Url Soneki

Son URL soneki, giriş sayfası URL'nizin sonuna eklenecek izleme parametrelerini içerebilir. Müşterilerinizin her zaman giriş sayfanıza gönderilmesi için giriş sayfanızın gerektirdiği izleme parametrelerini son URL son ekine yerleştirmenizi öneririz. Daha fazla ayrıntı ve doğrulama kuralları için teknik kılavuzlardaki Son URL Son Eki'ne bakın.

Eklemek: Opsiyonel
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Bu alanı delete_value dizesi olarak ayarlarsanız, önceki ayar kaldırılır.
Silmek: Salt okunur
k

Başlık

Bu, video reklamlarınızda görünebilecek iki olası başlıktır.

Video reklamları esnek olduğundan, çeşitli yayıncılar ve yerleşimler arasında esnek bir şekilde hizmet vermeleri için birden çok başlık gerekir.

Dizenin uzunluğu 30 karakterle sınırlıdır.

Eklemek: Video reklamları için gereklidir. Multimedya reklamları ve hedef kitle reklamları için geçerli değildir. Güncelleştirmek: Opsiyonel. Multimedya ve hedef kitle reklamları için kullanım dışıdır. Bunun yerine Başlıklar'a bakın.
Silmek: Salt okunur

Başlık

Hedef kitle reklamları duyarlı olduğundan, çeşitli yayıncılar ve yerleşimler arasında esnek bir şekilde hizmet vermeleri için birden çok başlık gerekir.

Başlıkların üst harfi 15'tir. Her başlığın uzunluğu 30 karakterle sınırlıdır. Başlıkların veri biçimi aşağıdaki örnek JSON'a eklenmiştir.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Eklemek: Multimedya reklamları ve hedef kitle reklamları için gereklidir. Video reklamları için geçerli değildir. Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Kimlik

Reklamın sistem tarafından oluşturulan tanımlayıcısı.

Eklemek: Opsiyonel. Bu alanı boş bırakmanız veya negatif bir tanımlayıcı belirtmeniz gerekir. Daha sonra, duyarlı ad etiketi gibi bağımlı kayıt türlerinin Üst Kimlik alanında reklam için negatif bir tanımlayıcı kümesine başvurulabilir. Aynı Toplu dosyaya yeni reklamlar ve yeni bağımlı kayıtlar ekliyorsanız bu önerilir. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
Güncelleştirmek: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

Görüntü

Hedef kitle reklamları duyarlı olduğundan, farklı boyutlarda ve en boy oranlarında birden çok görüntü varlığı oluşturarak çeşitli yayıncılar ve yerleşimler arasında esnek bir şekilde görüntülemelerini sağlayabilirsiniz.

Not

Şu andan itibaren SubType OriginalImage, Hedef Kitle Kampanyasının ResponsiveAd değeri için varsayılan görüntü olarak LandscapeImageMedia rolünün yerini alır.

Yalnızca bir OriginalImage varlığı sağlamanız gerekir; bu alan , subType değeri OriginalImage olarak ayarlanmış bir görüntü varlığı içermelidir. OriginalImage için önerilen boyutlar 1200 genişlik x 628 yüksekliktir. İsteğe bağlı olarak, desteklenen her alt tür için bir görüntü varlığı gibi ek varlık bağlantıları ekleyebilirsiniz. Açıkça ayarlamadığınız tüm görüntü varlığı alt türleri için Microsoft Advertising, OriginalImage'ı kırparak otomatik olarak görüntü varlığı bağlantıları oluşturur.

Not

Bu alan ayarlanırsa (boş değilse), Yatay Görüntü Medya Kimliği ve Kare Görüntü Medya Kimliği yoksayılır.

Görüntü varlıkları toplu dosyada JSON dizesi olarak temsil edilir. Aşağıdaki örnek JSON'a dokuz görüntü eklenmiştir ve yalnızca OriginalImage subType kırpılmaz. id, varlığın cropHeightbir özelliğiyken , cropWidth, cropX, cropYve subType varlık bağlantısının özellikleridir; örneğin, varlık ile reklam arasındaki ilişkidir. Daha fazla ayrıntı için aşağıdaki cropHeight, cropWidth, cropX, cropY, id ve subType'a bakın.

[{
	"id": 1234567890000,
	"subType": "OriginalImage"
},
{
	"id": 1234567890000,
	"subType": "LandscapeLogoMedia",
	"cropX": 0,
	"cropY": 0,
	"cropWidth": 512,
	"cropHeight": 128
},
{
	"id": 1234567890000,
	"subType": "SquareLogoMedia",
	"cropX": 0,
	"cropY": 0,
	"cropWidth": 128,
	"cropHeight": 128
},
{
	"id": 1234567890000,
	"subType": "SquareImageMedia",
	"cropX": 286,
	"cropY": 0,
	"cropWidth": 628,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia169X100",
	"cropX": 70,
	"cropY": 0,
	"cropWidth": 1061,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia93X100",
	"cropX": 308,
	"cropY": 0,
	"cropWidth": 584,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia15X10",
	"cropX": 129,
	"cropY": 0,
	"cropWidth": 942,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia155X100",
	"cropX": 114,
	"cropY": 0,
	"cropWidth": 973,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia133X100",
	"cropX": 183,
	"cropY": 0,
	"cropWidth": 835,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia178X100",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 1118,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia172X100",
	"cropX": 60,
	"cropY": 0,
	"cropWidth": 1080,
	"cropHeight": 628
}]

Not

Virgülle ayrılmış toplu dosyada varlık bağlantıları listesini, her öznitelik anahtarını ve her öznitelik dizesi değerini fazladan bir çift tırnak kümesiyle çevrelemeniz gerekir. Örneğin, Yukarıdaki JSON dizesi "[{""id"":1234567890000,""subType"":""OriginalImage""},{""id"":1234567890000,""subType"":""LandscapeLogoMedia olarak yazılır",""cropX"":0,""cropY"":0,"cropWidth"":512,""cropHeight"":128},{""id"":1234567890000, ""subType"":""SquareLogoMedia"",""cropX"":0,""cropY"":0,""cropWidth"":128,""cropHeight"":128},{""id"":1234567890000,"""subType":""SquareImageMedia"",""cropX"":286,""cropY"":0,""cropWidth"":628,""cropHeight"":628},{""id"":1234567890000,"""subType"":""ImageMedia169X100"",""cropX"":70,""cropY"":0,"cropWidth"":1061,""cropHeight"":628},{""id"":1234567890000,""subType"":"ImageMedia93X100"",""cropX"":308,""cropY"":0,""cropWidth"":584,""cropHeight"":628},{""id"":1234567890000,""subType"":""ImageMedia15X10"",""cropX"":129,""cropY"":0,""cropWidth"":942,""cropHeight":":628},{""id"":1234567890000,""subType"":""ImageMedia155X100"",""cropX"":114,""cropY"":0,"cropWidth"":973,"""cropHeight"":628},{""id"":1234567890000,""subType"":""ImageMedia133X100"",""cropX"":183,""cropY"":0,"cropWidth""":835,""cropHeight"":628},{""id"":1234567890000,"subType":"""ImageMedia178X100"","cropX"":41,""cropY"":0,"" cropWidth"":1118,""cropHeight"":628},{""id"":1234567890000,""subType"":""ImageMedia172X100",""cropX"":60,""cropY"":0,""cropWidth"":1080,""cropHeight"":628}]".".

Yukarıdaki karşıya yükleme yanıtı JSON örneği göz önünde bulundurulduğunda lütfen aşağıdakileri not alın:

  • Otomatik olarak oluşturulan tüm görüntü varlığı alt türleri için aynı görüntü varlığı tanımlayıcısı (örneğin, 1234567890000) kullanılır. Kırpılan görüntüleri Microsoft Advertising'in otomatik olarak oluşturmasına izin verseniz de, kimliğin aynı reklama bağlı görüntü varlıkları arasında benzersiz olması gerekmez.
  • Bu örnekteki reklam OriginalImage görüntü varlığı alt türü için kırpma ayarları olmadan oluşturulduğundan, OriginalImage ile ilişkili görüntü dışında tüm görüntü varlıkları kırpılır.
  • OriginalImage'ın kendi kırpma ayarları olsun veya olmasın, Microsoft Advertising tüm varsayılan kırpma ayarları için OriginalImage ile ilişkilendirilmiş görüntünün gerçek yüksekliğini kullanır. Bu örnekte, sistem tarafından oluşturulan tüm görüntü varlıkları için kırpma yüksekliği 628'dir ve 1,91:1 en boy oranına sahip OriginalImage (OriginalImage alt türü) genişliğinin ve yüksekliğinin 1200x628 olduğunu çıkarabiliriz. OriginalImage varlık bağlantısı 703x368 gibi kırpma ayarlarıyla oluşturulmuş olsa bile, otomatik olarak oluşturulan görüntü varlıklarının kırpma ayarları OriginalImage'ın tam boyutlarını temel alır (yine bu örnekte 1200x628 olur).
  • Bing Ads API'si sürüm 12'de Yatay Görüntü Medya Kimliği ve Kare Görüntü Medya Kimliği'ni kullanabilirsiniz ancak bu alanlar kullanım dışıdır ve gelecekteki bir sürümde kaldırılacaktır. Resimler alanı aracılığıyla kırpılan görüntüler üzerinde daha fazla esnekliğe ve denetime sahip olursunuz.

cropHeight

Kırpma konumundan başlayıp yukarı doğru hareket ederek görüntü varlığı kaynağından kullanılacak piksel sayısı.

cropWidth

CropX konumundan başlayıp sağa doğru hareket ederek görüntü varlığı kaynağından kullanılacak piksel sayısı.

cropX

Görüntü varlığı kaynağının sol alt köşesinden başlayarak, cropWidth'i uygulamadan önce x ekseninde sağa atlanması gereken piksel sayısıdır.

kırpma

Görüntü varlığı kaynağının sol alt köşesinden başlayarak, cropHeight uygulanmadan önce y ekseninde yukarı doğru atlanması gereken piksel sayısıdır.

id

id özniteliği, bir Microsoft Advertising hesabındaki varlık için benzersiz bir Microsoft Advertising tanımlayıcısıdır.

Aynı görüntü varlığı tanımlayıcısı, farklı en boy oranları için aynı reklamda birden çok kez kullanılabilir ve aynı Microsoft Advertising hesabındaki birden çok reklam tarafından da kullanılabilir. SubType değeri LandscapeImageMedia olarak ayarlanmış görüntü varlığının tanımlayıcısı, aynı reklamdaki otomatik olarak oluşturulan tüm görüntü varlığı alt türleri için kullanılır. Kırpılan görüntüleri Microsoft Advertising'in otomatik olarak oluşturmasına izin verseniz de, kimliğin aynı reklama bağlı görüntü varlıkları arasında benzersiz olması gerekmez.

Hızlı yanıt veren reklamlar için Görüntü toplu kaydı aracılığıyla resimler oluşturabilirsiniz. Ardından, döndürülen medya tanımlayıcısını görüntü varlığı kimliği olarak kullanabilirsiniz. Eklediğiniz görüntünün en boy oranı, görüntü varlığı alt Türü için desteklenmelidir.

Alt

özniteliği, subType bu görüntü varlığının en boy oranını temsil eder.

Hesap düzeyinde medya kitaplığında depolanan Görüntünün gerçek en boy oranı, sonuçta elde edilen boyutlar alt tür başına beklenen en boy oranına neden olduğu sürece değişebilir. Kırpma ayarlarını belirtmezseniz, hizmet otomatik olarak görüntünün ortasından mümkün olan en yüksek alana kadar kırpılır. Örneğin, 1.91:1 en boy oranı için 1000x1000 piksellik bir görüntü kullanıldığında, otomatik kırpma ayarı cropWidth=1000, cropHeight=524, cropX=0 ve cropY=238 olur.

Olası alt tür değerleri OriginalImage'ı içerir. LandscapeLogoMedia, SquareLogoMedia, LandscapeImageMedia, SquareImageMedia, ImageMedia4x1, ImageMedia1x2, ImageMedia169X100, ImageMedia201X100, ImageMedia120X100, ImageMedia200X100, ImageMedia124X100 ve ImageMedia153X100. Gelecekte yeni alt türler eklenebilir, bu nedenle sabit bir değer kümesine bağımlılık almamalısınız.

Alt Tür En boy oranı Piksel cinsinden minimum boyutlar
OriginalImage Yok 703 genişlik x 368 yükseklik
LandscapeImageMedia 1.91:1 300 genişlik x 157 yükseklik
SquareImageMedia 1:1 114 genişlik x 114 yükseklik
ImageMedia4x1 4:1 608 genişlik x 152 yükseklik
ImageMedia1x2 1:2 470 genişlik x 940 yükseklik
ImageMedia201X100 2.01:1 612 genişlik x 304 yükseklik
ImageMedia120X100 1.2:1 300 genişlik x 250 yükseklik
ImageMedia200X100 2:1 200 genişlik x 100 yükseklik
ImageMedia169X100 1.69:1 628 genişlik x 372 yükseklik
ImageMedia124X100 1.24:1 104 genişlik x 84 yükseklik
ImageMedia153X100 1.53:1 306 genişlik x 200 yükseklik

Eklemek:Yatay Görüntü Medya Kimliği boşsa gereklidir. Her varlık bağlantısı için yalnızca kimlik ve alt Tür gereklidir.
Güncelleştirmek: Opsiyonel. Var olan tüm varlık bağlantılarını korumak için bu alanı boş bırakın veya ayarlayın. Bu alanı ayarlarsanız, daha önce bu reklama bağlı olan tüm resimler değiştirilir. Bu alanı ayarlarsanız, her varlık bağlantısı için yalnızca kimlik ve alt Tür gereklidir.
Silmek: Salt okunur

gösterim izleme url'leri

1x1 gösterim izleme pikselleri için URL'ler. Her piksel, Microsoft Audience Network gösterimlerini üçüncü taraf reklam raporlama aracınıza bildirir.

Her duyarlı reklam için en fazla 2 gösterim izleme URL'sini ekleyebilirsiniz. Her URL noktalı virgül ve boşluk ("; ") ile sınırlandırılır.

Her URL'nin erişilebilir olması gerekir. URL'nin uzunluğu 2.048 karakterle sınırlıdır. HTTP veya HTTPS protokol dizesi 2.048 karakter sınırına doğru sayılır.

Microsoft, her Microsoft Audience Network gösterimi için URL'ye ping atarak üçüncü taraf reklam raporlama aracınızda gösterim izlemeyi etkinleştirir. Tanımlama bilgilerine veya IP adreslerine göre dönüştürme izleme veya izleme gibi ileri düzey kullanıcı izleme desteklenmez.

Eklemek: Opsiyonel
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Bu alanı delete_value dizesi olarak ayarlarsanız, önceki ayar kaldırılır.
Silmek: Salt okunur

Yatay Görüntü Medya Kimliği

Hedef kitlenizin reklamlarında görünebilecek 1.91:1 en boy oranına sahip yatay görüntüler için kullanılan görüntü varlığının tanımlayıcısı.

Görüntü varlığı kırpma ayarları bu alan için desteklenen en boy oranına neden olduğu sürece, depolanan görüntü medyasının en boy oranı farklılık gösterebilir. Kırpma ayarlarıyla etkili en boy oranını onaylamak için Görüntüler alanını kullanın.

Not

Bing Ads API'si sürüm 12'de Yatay Görüntü Medya Kimliği ve SquareImageMediaId kullanabilirsiniz ancak bu alanlar kullanım dışıdır ve gelecekteki bir sürümde kaldırılacaktır. Resimler alanı aracılığıyla kırpılan görüntüler üzerinde daha fazla esnekliğe ve denetime sahip olursunuz.

Eklemek:Görüntüler ayarlanmadıysa gereklidir. Görüntüler ayarlanırsa, bu alan yoksayılır.
Güncelleştirmek: Opsiyonel. Görüntüler ayarlanırsa, bu alan yoksayılır. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Yatay Logo Medya Kimliği

Bu alan dahili kullanım için ayrılmıştır ve Bing Ads API'sinin gelecek bir sürümünden kaldırılacaktır.

Eklemek: Opsiyonel
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Uzun Başlık

Bu, hedef kitle reklamlarınızda görünebilecek iki olası başlıktır.

Hedef kitle reklamları duyarlı olduğundan, çeşitli yayıncılar ve yerleşimler arasında esnek bir şekilde hizmet vermeleri için birden çok başlık gerekir.

Dizenin uzunluğu 90 karakterle sınırlıdır.

Eklemek: Gerekli
Güncelleştirmek: Kaldırıl -mış. Bunun yerine Uzun Başlıklar kullanın.
Silmek: Salt okunur

Uzun Başlıklar

Hedef kitle reklamları duyarlı olduğundan, çeşitli yayıncılar ve yerleşimler arasında esnek bir şekilde hizmet vermeleri için birden çok başlık gerekir.

Uzun başlıkların üst harfi 5'tir. Her başlığın uzunluğu 90 karakterle sınırlıdır. Uzun başlıkların veri biçimi aşağıdaki örnek JSON'a eklenmiştir.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Eklemek: Multimedya reklamları ve hedef kitle reklamları için gereklidir. Video reklamları için geçerli değildir. Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Uzun Başlık Dizesi

Başlıklar, reklamınızda görünen en belirgin metindir, bu nedenle kullanılabilir karakterlerden en iyi şekilde yararlanmalısınız. Hedef kitle reklamları duyarlı olduğundan, çeşitli yayıncılar ve yerleşimler arasında esnek bir şekilde hizmet vermeleri için birden çok başlık gerekir.

Her başlığın uzunluğu 90 karakterle sınırlıdır. Uzun başlıkların veri biçimi aşağıdaki örnek JSON'a eklenmiştir.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Eklemek: Hedef kitle reklamları ve video reklamları için gereklidir. Multimedya reklamları için geçerli değildir. Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Mobil Son Url

Mobil giriş sayfası URL'si.

Son URL'ler ve Son Mobil URL'ler için aşağıdaki doğrulama kuralları geçerlidir.

  • URL'nin uzunluğu 2.048 karakterle sınırlıdır. HTTP veya HTTPS protokol dizesi 2.048 karakter sınırına doğru sayılır.

  • Hem Son URL'ler hem de Son Mobil URL'ler için en fazla 10 öğe belirtebilirsiniz; ancak, teslimat için her listedeki yalnızca ilk öğe kullanılır. Hizmet, olası ileriye dönük uyumluluk için en fazla 10'a kadar izin verir.

  • Her URL noktalı virgül ve boşluk ("; ") ile sınırlandırılır.

  • '{' ve '}' kullanımı yalnızca etiketlerin (örneğin, "{lpurl}") çizgisini belirlemeye izin verilir.

  • Her URL, http:// veya https:// ile başlayan iyi biçimlendirilmiş bir URL olmalıdır.

  • Son Mobil URL'leri belirtirseniz Son Url'yi de belirtmeniz gerekir.

Not

Bu URL yalnızca anahtar sözcüğü bir Mobil Son Url belirtmiyorsa kullanılır.

Eklemek: Opsiyonel
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Bu alanı delete_value dizesi olarak ayarlarsanız, önceki ayar kaldırılır.
Silmek: Salt okunur

Değiştirme Zamanı

Varlığın son güncelleştirildiği tarih ve saat. Değer Eşgüdümlü Evrensel Saat (UTC) içindedir.

Not

Tarih ve saat değeri, istemcide değil sunucudaki tarih ve saati yansıtır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndeki dateTime girdisine bakın.

Eklemek: Salt okunur
Güncelleştirmek: Salt okunur
Silmek: Salt okunur

Üst Kimlik

Reklamı içeren reklam grubunun sistem tarafından oluşturulan tanımlayıcısı.

Bu toplu alan, Ad Grubu kaydının Kimlik alanına eşler.

Eklemek: Salt okunur ve Gerekli. Mevcut bir reklam grubu tanımlayıcısı belirtmeniz veya üst Ad Grubu kaydının Kimlik alanına eşit bir negatif tanımlayıcı belirtmeniz gerekir. Aynı Toplu dosyadaki yeni bir reklam grubuna yeni reklamlar ekliyorsanız bu önerilir. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
Güncelleştirmek: Salt okunur
Silmek: Salt okunur

Not

Ekleme, güncelleştirme ve silme için Üst Kimlik veya Ad Grubu alanını belirtmeniz gerekir.

Yayımcı Ülkeleri

Editör yönergeleri belirtilen terime izin verilmeyen yayımcı ülkelerinin veya bölgelerinin listesi.

Toplu dosyada, yayımcı ülke veya bölge listesi noktalı virgülle (;)) sınırlandırılır.

Eklemek: Salt okunur
Güncelleştirmek: Salt okunur
Silmek: Salt okunur

Durum

Reklamın durumu.

Olası değerler Etkin, Duraklatılmış veya Silinmiş olabilir.

Eklemek: Opsiyonel. Varsayılan değer Etkin'dir.
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Gerekli. Durum , Silinmiş olarak ayarlanmalıdır.

Kare Resim Medya Kimliği

İzleyici reklamlarınızda 1:1 en boy oranına sahip kare görüntüler için kullanılan görüntü varlığının tanımlayıcısı.

Görüntü varlığı kırpma ayarları bu alan için desteklenen en boy oranına neden olduğu sürece, depolanan görüntü medyasının en boy oranı farklılık gösterebilir. Kırpma ayarlarıyla etkili en boy oranını onaylamak için Görüntüler alanını kullanın.

Not

Bing Ads API'si sürüm 12'de Yatay Görüntü Medya Kimliği ve SquareImageMediaId kullanabilirsiniz ancak bu alanlar kullanım dışıdır ve gelecekteki bir sürümde kaldırılacaktır. Resimler alanı aracılığıyla kırpılan görüntüler üzerinde daha fazla esnekliğe ve denetime sahip olursunuz.

Eklemek: Opsiyonel. Görüntüler ayarlanırsa, bu alan yoksayılır ve Microsoft Advertising, LandscapeImageMedia görüntü varlığını kırparak otomatik olarak yeni bir kare görüntü varlığı oluşturur. Görüntüler ayarlanmadıysa ve bu alanı ayarlamazsanız, Microsoft Advertising Yatay Görüntü Medya Kimliği'ni kırparak otomatik olarak yeni bir kare görüntü varlığı oluşturur.
Güncelleştirmek: Opsiyonel. Görüntüler ayarlanırsa, bu alan yoksayılır ve Microsoft Advertising, LandscapeImageMedia görüntü varlığını kırparak otomatik olarak yeni bir kare görüntü varlığı oluşturur. Görüntüler ayarlanmadıysa ve bu alanı ayarlamazsanız, Microsoft Advertising Yatay Görüntü Medya Kimliği'ni kırparak otomatik olarak yeni bir kare görüntü varlığı oluşturur. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Kare Logo Medya Kimliği

Bu alan dahili kullanım için ayrılmıştır ve Bing Ads API'sinin gelecek bir sürümünden kaldırılacaktır.

Eklemek: Opsiyonel
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Metin

Video reklamınızın yerleşimine bağlı olarak, bu metin reklamınızın uzun veya kısa başlığının altında veya yanında görünür.

Reklam metninde çalışmak için başlıktan daha fazla karakter alanınız vardır. Bu nedenle, görüntü ve başlık potansiyel bir müşterinin dikkatini çektikten sonra reklam metninin onu tıklamaya ikna etmesi gerekir. Ürününüzü veya hizmetinizi birbirinden ayıran nedir?

Metin en az bir sözcük içermelidir.

Dizenin uzunluğu 90 karakterle sınırlıdır.

Metin yeni satır (\n) karakterini içeremez.

Eklemek: Video reklamları için gereklidir. Hedef kitle reklamları veya multimedya reklamları için geçerli değildir. Güncelleştirmek: Video reklamları için isteğe bağlı. İzleyici reklamları veya multimedya reklamları (kullanım dışı) için bunun yerine Açıklamalar'ı kullanın.
Silmek: Salt okunur

İzleme Şablonu

FinalUrls ile belirtilen URL için varsayılan olarak kullanılacak izleme şablonu.

Aşağıdaki doğrulama kuralları, izleme şablonları için geçerlidir. Desteklenen şablonlar ve parametreler hakkında daha fazla ayrıntı için Hangi izleme veya URL parametrelerini kullanabilirim? Microsoft Advertising yardım makalesine bakın.

  • Düşük düzeyli varlıklar için tanımlanan izleme şablonları(ör. reklamlar, kampanya gibi daha üst düzey varlıklar için ayarlananları geçersiz kılar). Daha fazla bilgi için bkz . Varlık Sınırları.

  • İzleme şablonunun uzunluğu 2.048 karakterle sınırlıdır. HTTP veya HTTPS protokol dizesi 2.048 karakter sınırına doğru sayılır.

  • İzleme şablonu aşağıdakilerden biriyle başlayan iyi biçimlendirilmiş bir URL olmalıdır: http://, https://, {lpurl}, veya {unescapedlpurl}.

  • Microsoft Advertising, özel parametrelerin mevcut olup olmadığını doğrulamaz. İzleme şablonunuzda özel parametreler kullanıyorsanız ve bunlar yoksa, giriş sayfası URL'si değiştirme olmadan özel parametrelerinizin anahtar ve değer yer tutucularını içerir. Örneğin, izleme şablonunuz https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}ise ve kampanya, reklam grubu, ölçüt, anahtar sözcük veya reklam düzeyinde {_season} veya {_promocode} tanımlanmamışsa, giriş sayfası URL'si aynı olur.

Eklemek: Opsiyonel
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Bu alanı delete_value dizesi olarak ayarlarsanız, önceki ayar kaldırılır.
Silmek: Salt okunur