Aracılığıyla paylaş

Resim Reklam Uzantısı Kaydı - Toplu

  • Makale

Toplu bir dosyaya indirilebilen ve karşıya yüklenebilen bir resim reklam uzantısı tanımlar.

Bir resim reklam uzantısını hesapla veya hesaptaki kampanyalar ve reklam gruplarıyla ilişkilendirebilirsiniz. Her hesapta en fazla 250.000 kampanya resmi uzantısı ilişkisi ve 250.000'e kadar reklam grubu resim uzantısı ilişkilendirmesi olabilir. Her varlık (hesap, kampanya veya reklam grubu) en fazla 25 resim reklam uzantısıyla ilişkilendirilebilir. Resim reklam uzantısı ilişkilendirmelerini yönetmek için Hesap Görüntüsü Reklam Uzantısı, Ad Grubu Resim Reklam Uzantısı ve Kampanya Görüntüsü Reklam Uzantısı kayıtlarını kullanın.

DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine ImageAdExtensionsdownloadEntity değerini ekleyerek hesaptaki tüm Görüntü Reklam Uzantısı kayıtlarını 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, hesabın paylaşılan kitaplığına yeni bir Resim Reklam Uzantısı ekler.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Alternative Text,Media Ids,Final Url Suffix
Format Version,,,,,,,,,,,6.0,,,,,
Image Ad Extension,Active,-14,0,,,ClientIdGoesHere,,,,,,,FALSE,ImageAdExtension Alternative Text,ImageMediaIdHere,

.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 BulkImageAdExtension nesnesini karşıya yüklemek ve indirmek için BulkServiceManager'ı kullanarak zaman kazanabilirsiniz.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkImageAdExtension
var bulkImageAdExtension = new BulkImageAdExtension
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // ImageAdExtension object of the Campaign Management service.
    ImageAdExtension = new ImageAdExtension
    {
        // 'Alternative Text' column header in the Bulk file
        AlternativeText = "ImageAdExtension Alternative Text",
        // 'Destination Url' column header in the Bulk file
        DestinationUrl = null,
        // 'Id' column header in the Bulk file
        Id = imageAdExtensionIdKey,
        // 'Media Ids' column header in the Bulk file
        ImageMediaIds = new long[] { ImageMediaIdHere },
        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,
    },
};

uploadEntities.Add(bulkImageAdExtension);

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

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

Görüntü Reklam Uzantısı kaydı için Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları kullanılabilir.

Reklam Zamanlaması

Reklam uzantısının reklamlarınızla birlikte görüntülenmesini istediğiniz gün ve zaman aralıklarının listesi. Her gün ve zaman aralığı haftanın zamanlanmış gününü, başlangıç/bitiş saatini ve başlangıç/bitiş dakikasını içerir. Her gün ve zaman aralığı sol ve sağ parantez içine alınır ve diğer gün ve zaman aralıklarından noktalı virgülle (;) sınırlayıcı) ayrılır. Her gün ve zaman aralığında biçim Day[StartHour:StartMinue-EndHour:EndMinute] şeklindedir.

StartHour'un olası değerleri 00 ile 23 arasındadır ve burada 00 12:00 ve 12 12:00'dir.

EndHour'un olası değerleri 00 ile 24 arasındadır; burada 00 12:00 ve 12 de 12:00'dir.

StartMinute ve EndMinute değerlerinin olası değerleri 00 ile 60 arasında değişir.

Aşağıdaki örnekte hafta içi 09:00 ile 21:00 saatleri arasında gün ve saat aralıkları gösterilmektedir: (Pazartesi[09:00-21:00]);( Salı[09:00-21:00]); (Çarşamba[09:00-21:00]); (Perşembe[09:00-21:00]); (Cuma[09:00-21:00])

Ekle: Isteğe bağlı. Bu alanı ayarlamazsanız, reklam uzantısı takvim başlangıç ve bitiş tarihleri sırasında zamanlamaya uygun olacaktır.
Güncelleştirme: Isteğe bağlı. Tek tek gün ve zaman aralıkları güncelleştirilemez. Önceki kümenin yerini alması gereken yeni bir küme göndererek gün ve saat aralıklarını etkili bir şekilde güncelleştirebilirsiniz. Reklam Zamanlaması, Bitiş Tarihi, Başlangıç Tarihi ve Arama Saat DilimiNi Kullan alanları birbirine bağlıdır ve birlikte güncelleştirilir. Güncelleştirme sırasında bu alanların tümünü boş bırakırsanız, hiçbiri güncelleştirilmez. Bu alanlardan herhangi birinin değerlerini eklerseniz, bu alanların tümüne ait önceki değerler kaldırılır veya değiştirilir. Önceki tüm zamanlama ayarlarını kaldırmak için bu alanların her birini delete_value olarak ayarlayın.
Silmek: Salt okunur

Alternatif Metin

Kullanılabilirlik için görüntü medyasının alternatif açıklaması. Resim görüntülenemediyse bunun yerine alternatif metin kullanılır.

Bu alan için uzunluk üst sınırı 90 karakterdir.

Ekle: Gerekli
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
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.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı
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 3 özel parametre anahtarı ve değer çiftini kabul eder ve ek özel parametreler yoksayılır. Özel Parametreler Sınırı Artış Aşaması 3 pilotundaki müşteriler için (GetCustomerPilotFeatures 635 döndürür), Microsoft Advertising dahil ettiğiniz ilk 8 özel parametre anahtarını 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 200 UTF-8 bayt'ı aşamaz. Özel Parametreler Sınırı Artış Aşaması 3 pilotundaki müşteriler için (GetCustomerPilotFeatures 635 döndürür), Değer sınırı 250 UTF-8 bayt'a çıkar. 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.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı. 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

Hedef URL

Kullanıcıyı resme tıkladığında götürecek web sayfasının URL'si.

URL, {keyword} gibi dinamik metin dizeleri içerebilir. Daha fazla bilgi için bkz . Hangi izleme veya URL parametrelerini kullanabilirim?.

URL en fazla 1.024 karakter içerebilir. URL bir protokol belirtmezse, kullanıcı reklama tıkladığında sistem HTTP protokolunu kullanır. Bir reklam eklediğinizde URL HTTP protokolunu belirtirse, hizmet http:// protokol dizesini kaldırır (HTTP protokol dizesi 1.024 karakter sınırına göre sayılmaz); ancak, hizmet URL'den bir HTTPS protokol dizesini (https://) kaldırmaz.

Not

Resim reklam uzantısı için URL belirtilmezse, reklamın URL'si kullanılır.

Ekle: Isteğe bağlı. Not: Bu alan, çok resimli reklam uzantıları için gereklidir. Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Not: Bu alan, çok resimli reklam uzantıları için gereklidir.
Silmek: Salt okunur

Metin Görüntüle

Görüntü uzantınızın görüntüleme metni.

Bu alan için uzunluk üst sınırı 35 karakterdir.

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

Editoryal Konum

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

Ekle: Salt okunur
Güncelleştirme: 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ı.

Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur

Editoryal Durum

Reklam uzantısının editoryal durumu.

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

Değer Açıklama
Etkin Reklam uzantısı, editoryal incelemeden geçti.
ActiveLimited Reklam uzantısı bir veya daha fazla pazarda editoryal incelemeden geçmiştir ve reklam uzantısının bir veya daha fazla öğesi başka bir pazarda editoryal incelemeden geçiriliyor. Örneğin, reklam uzantısı Kanada için editoryal incelemeden geçmiştir ve Birleşik Devletler hala gözden geçirmeyi bekliyor.
Onaylanmadı Reklam uzantısı editoryal incelemede başarısız oldu.
Etkin olmayan Reklam uzantısının bir veya daha fazla öğesi editör tarafından inceleniyor.

Ekle: Salt okunur
Güncelleştirme: 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.

Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur

Bitiş Tarihi

Reklam uzantısı, AA/GG/YYYY olarak biçimlendirilmiş zamanlanmış bitiş tarihi dizesidir.

Bitiş tarihi kapsayıcıdır. Örneğin, bu alanı 31.12.2020 olarak ayarlarsanız, reklam uzantıları 31.12.2020 tarihinde saat 23:59'da gösterilmeyi durdurur.

Ekle: Isteğe bağlı. Bir bitiş tarihi belirtmezseniz ilişkili kampanyaları, reklam gruplarını veya reklamları duraklatmadığınız sürece reklam uzantısı yayınlanmaya devam eder.
Güncelleştirme: Isteğe bağlı. Başlangıç tarihi null olduğu veya yeni bitiş tarihinden önce gerçekleştiği sürece bitiş tarihi kısaltılabilir veya uzatılabilir. Bu alanı delete_value dizesi olarak ayarlarsanız, bitiş tarihini etkili bir şekilde kaldıracaksınız. Reklam Zamanlaması, Bitiş Tarihi, Başlangıç Tarihi ve Arama Saat DilimiNi Kullan alanları birbirine bağlıdır ve birlikte güncelleştirilir. Güncelleştirme sırasında bu alanların tümünü boş bırakırsanız, hiçbiri güncelleştirilmez. Bu alanlardan herhangi birinin değerlerini eklerseniz, bu alanların tümüne ait önceki değerler kaldırılır veya değiştirilir. Önceki tüm zamanlama ayarlarını kaldırmak için bu alanların her birini delete_value olarak ayarlayın.
Silmek: Salt okunur

Son Url

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 hem de Mobil Son Url için en fazla 10 liste öğesi 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 liste öğesine 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.
  • Son URL'lerin her biri http:// veya https:// ile başlayan iyi biçimlendirilmiş bir URL olmalıdır.
  • Mobil Son Url'yi belirtirseniz Son Url'yi de belirtmeniz gerekir.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı. 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.

Not

Bu özellik yalnızca Son URL Soneki 3. Aşama pilotundaki müşteriler tarafından kullanılabilir (GetCustomerPilotFeatures 636 döndürür). Pilotta değilseniz bu özellik yoksayılır ve hata döndürülür.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı. 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

Kimlik

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

Ekle: Isteğe bağlı. Bu alanı boş bırakmanız veya negatif bir tanımlayıcı belirtmeniz gerekir. Daha sonra reklam uzantısı için negatif tanımlayıcı kümesine Ad Grubu Resim Reklam Uzantısı ve Kampanya Resmi Reklam Uzantısı gibi bağımlı kayıt türlerinin Kimlik alanında başvurulabilir. Aynı Toplu dosyaya yeni reklam uzantıları ve yeni bağımlı kayıtlar ekliyorsanız bu önerilir. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
Güncelleştirme: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

Görüntü

Farklı boyutlara ve en boy oranlarına sahip görüntü varlıkları, çeşitli yayımcılar ve yerleştirmeler arasında esnek bir şekilde görüntülenebilir.

Yalnızca bir yatay görüntü varlığı sağlamanız gerekir; bu alan, alt Türü LandscapeImageMedia olarak ayarlanmış bir görüntü varlığı içermelidir. LandscapeImageMedia 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, LandscapeImageMedia'yı kırparak otomatik olarak görüntü varlığı bağlantıları oluşturur.

Görüntü varlıkları toplu dosyada JSON dizesi olarak temsil edilir. Aşağıdaki örnek JSON'a yedi resim eklenmiştir ve yalnızca LandscapeImageMedia 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": "LandscapeImageMedia"
},
{
	"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"":""LandscapeImageMedia""},{""id"":1234567890000,"subType"":"SquareImageMedia olarak yazılabilir",""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"":""ResimMedia172X100"",""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, LandscapeImageMedia görüntü varlığı alt türü için kırpma ayarları olmadan oluşturulduğundan, özgün yatay resim dışında tüm görüntü varlıkları kırpılır.
  • Yatay görüntünün kendi kırpma ayarları olsa da olmasa da, Microsoft Advertising varsayılan kırpma ayarlarının tümü için yatay 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 yatay görüntünün (LandscapeImageMedia alt türü) genişliği ve yüksekliğinin 1200x628 olduğunu çıkarabiliriz. Yatay görüntü varlığı bağlantısı kırpma ayarlarıyla (örneğin, 703x368) oluşturulmuş olsa bile, otomatik olarak oluşturulan görüntü varlıklarının kırpma ayarları yatay görüntünün tam boyutlarını temel alır (yine bu örnekte 1200x628 olur).

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.

Kimliği

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.

Görüntü toplu kaydı aracılığıyla resim reklam uzantıları için 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 Şunlardır: LandscapeImageMedia, SquareImageMedia, ImageMedia169X100, ImageMedia93X100, ImageMedia15X10, ImageMedia155X100, ImageMedia133X100, ImageMedia178X100 ve ImageMedia172X100. 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 Piksel cinsinden minimum boyutlar
LandscapeImageMedia 703 genişlik x 368 yükseklik
En boy radyo 1.91:1
SquareImageMedia 300 genişlik x 300 yükseklik
En boy radyo 1:1
ImageMedia169X100 622 genişlik x 368 yükseklik
En boy radyo 1.69:1
ImageMedia93X100 311 genişlik x 333 yükseklik
En boy radyo 0.93:1
ImageMedia15X10 300 genişlik x 200 yükseklik
En boy radyo 1.5:1
ImageMedia155X100 300 genişlik x 194 yükseklik
En boy radyo 1.55:1
ImageMedia133X100 100 genişlik x 75 yükseklik
En boy radyo 1.33:1
ImageMedia178X100 624 genişlik x 350 yükseklik
En boy radyo 1.78:1
ImageMedia172X100 300 genişlik x 174 yükseklik
En boy radyo 1.72:1

Ekle: Gerekli. Her varlık bağlantısı için yalnızca kimlik ve alt Tür gereklidir.
Güncelleştirme: Isteğe bağlı. 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

Düzen

Uygun görüntü düzenlerinin listesi.

Desteklenen değerler SearchSingle ve SearchMultiple'dır. Gelecekte yeni düzenler eklenebilir, bu nedenle sabit bir değer kümesine bağımlılık almamalısınız.

Toplu dosyada, düzen dizeleri listesi noktalı virgülle (;)) sınırlandırılır.

Ekle: Isteğe bağlı. Bu alanı ayarlamazsanız, tüm geçerli ve gelecekte desteklenen düzenler varsayılan olarak ayarlanır.
Güncelleştirme: Isteğe bağlı. 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

Medya Kimlikleri

Reklama eklenecek görüntülerin tanımlayıcıları. Aynı en boy oranına sahip birden fazla görüntü için medya tanımlayıcıları belirtemeyebilirsiniz. Başka bir deyişle, başvuruda bulunan görüntülerin her birinin farklı en boy oranları olmalıdır.

En fazla dört (4) görüntü tanımlayıcısı belirtebilirsiniz. Gereken minimum değer bir resim medya kimliği olsa da, tüm reklam yerleşimlerine uygun olmak için dört görüntü medyası tanımlayıcısı sağlamanız gerekir.

Toplu dosyada, medya tanımlayıcıları listesi noktalı virgülle (;)) sınırlandırılır.

Ekle: Gerekli
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Mobil Son Url

Mobil cihazlar için 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 hem de Mobil Son Url için en fazla 10 liste öğesi 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 liste öğesine 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.
  • Son URL'lerin her biri http:// veya https:// ile başlayan iyi biçimlendirilmiş bir URL olmalıdır.
  • Mobil Son Url'yi belirtirseniz Son Url'yi de belirtmeniz gerekir.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı. 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.

Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur

Üst Kimlik

Reklam uzantısını içeren hesabın sistem tarafından oluşturulan tanımlayıcısı.

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

Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur

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.

Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur

Başlangıç Tarihi:

Reklam uzantısı, AA/GG/YYYY olarak biçimlendirilmiş zamanlanmış başlangıç tarihi dizesidir.

Başlangıç tarihi dahil. Örneğin , StartDate değerini 5/5/2020 olarak ayarlarsanız reklam uzantıları 5/5/2020 tarihinde saat 12:00'de gösterilmeye başlar.

Ekle: Isteğe bağlı. Başlangıç tarihi belirtmezseniz, reklam uzantısı hemen zamanlamaya uygundur.
Güncelleştirme: Isteğe bağlı. Bitiş tarihi null olduğu veya yeni başlangıç tarihinden sonra gerçekleştiği sürece başlangıç tarihi kısaltılabilir veya uzatılabilir. Bu alanı delete_value dizesi olarak ayarlarsanız başlangıç tarihini etkin bir şekilde kaldırmış olursunuz ve reklam uzantısı hemen zamanlamaya uygundur. Reklam Zamanlaması, Bitiş Tarihi, Başlangıç Tarihi ve Arama Saat DilimiNi Kullan alanları birbirine bağlıdır ve birlikte güncelleştirilir. Güncelleştirme sırasında bu alanların tümünü boş bırakırsanız, hiçbiri güncelleştirilmez. Bu alanlardan herhangi birinin değerlerini eklerseniz, bu alanların tümüne ait önceki değerler kaldırılır veya değiştirilir. Önceki tüm zamanlama ayarlarını kaldırmak için bu alanların her birini delete_value olarak ayarlayın.
Silmek: Salt okunur

Durum

Reklam uzantısının durumu.

Olası değerler Etkin veya Silinmiş değerlerdir.

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

İzleme Şablonu

Yükseltme URL'leriniz için 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.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı. 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

Arama Saat Dilimini Kullanma

Hesap saat diliminin mi yoksa reklamların gönderilebileceği arama kullanıcısının saat diliminin mi kullanılacağını belirler.

Reklam uzantılarının arama kullanıcısının saat diliminde gösterilmesini istiyorsanız bu özelliği TRUE olarak ayarlayın ve aksi takdirde FALSE olarak ayarlayın.

Ekle: Isteğe bağlı. Bu alanı belirtmezseniz veya boş bırakırsanız, FALSE varsayılan değeri ayarlanır ve hesap saat dilimi kullanılır.
Güncelleştirme: Isteğe bağlı. Bu alanı delete_value dizesi olarak ayarlarsanız, etkin bir şekilde VARSAYıLAN YANLIŞ değerine sıfırlarsınız. Reklam Zamanlaması, Bitiş Tarihi, Başlangıç Tarihi ve Arama Saat DilimiNi Kullan alanları birbirine bağlıdır ve birlikte güncelleştirilir. Güncelleştirme sırasında bu alanların tümünü boş bırakırsanız, hiçbiri güncelleştirilmez. Bu alanlardan herhangi birinin değerlerini eklerseniz, bu alanların tümüne ait önceki değerler kaldırılır veya değiştirilir. Önceki tüm zamanlama ayarlarını kaldırmak için bu alanların her birini delete_value olarak ayarlayın.
Silmek: Salt okunur

Sürüm

Reklam uzantısının içeriğinin güncelleştirildiği sayı. Uzantıyı eklediğinizde sürüm 1 olarak ayarlanır ve her düzeltildiğinde artırılır.

Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur