El Ilanı Uzantısı Kaydı - Toplu
Toplu dosyaya indirilebilen ve karşıya yüklenebilecek bir el ilanı reklam uzantısı tanımlar.
El Ilanı Uzantıları, reklamverenlerin ürün veya mağaza kataloglarını (el ilanları) potansiyel müşterilere dağıtmasını sağlar.
"Haftalık fırsatlar" veya "haftalık satışlar" gibi geniş sorgularda belirgin bir şekilde görüntülenebilir ve böylece alışveriş yapanları yarışma yerine reklamınızı tıklamaya teşvik ederler. Doğası gereği, arama yapanları daha iyi bilgilendirmeye yardımcı olur ve sonuç olarak kullanıcı katılımını artırır; örneğin, hıza tıklama.
Not
El Ilanı Uzantıları özellik pilotundaki müşteriler tarafından kullanılabilir (GetCustomerPilotFeatures 802 döndürür).
Bir el ilanı reklam uzantısını hesapla veya hesaptaki kampanyalar ve reklam gruplarıyla ilişkilendirebilirsiniz. Her varlık (hesap, kampanya veya reklam grubu) en fazla 3 el ilanı reklam uzantısıyla ilişkilendirilebilir. El ilanı reklam uzantısı ilişkilendirmelerini yönetmek için Hesap El İlanı Reklam Uzantısı, Reklam Grubu El İlanı Reklam Uzantısı ve Kampanya El İlanı Reklam Uzantısı kayıtlarını kullanın.
DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine FlyerAdExtensionsDownloadEntity değerini ekleyerek hesaptaki tüm El Ilanı 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 El Ilanı Reklam Uzantısı ekler.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Store Id,Name,Ad Schedule,Use Searcher Time Zone,Flyer Name,Description,Final Url,Mobile Final Url,Media Ids,Media Urls
Format Version,,,,,,,,,,,6.0,,,,,,
Flyer Ad Extension,Active,-18,0,,,ClientIdGoesHere,,,12/31/2020,,,(Monday[09:00-21:00]),FALSE,Flyer name goes here, Flyer description goes here,https://www.contoso.com/one; https://www.contoso.com/two; https://www.contoso.com/three,https://mobile.contoso.com/one; https://mobile.contoso.com/two; https://mobile.contoso.com/three,12345678,
.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 BulkFlyerAdExtension nesnesini karşıya yükleyip indirebilirsiniz.
// Map properties in the Bulk file to the BulkFlyerAdExtension
var bulkFlyerAdExtension = new BulkFlyerAdExtension
{
// '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
// FlyerAdExtension object of the Campaign Management service.
FlyerAdExtension = new FlyerAdExtension
{
// 'Description' column header in the Bulk file
Description = "Flyer description",
// 'Id' column header in the Bulk file
Id = flyerAdExtensionIdKey,
// '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/one",
"https://www.contoso.com/two",
"https://www.contoso.com/three"
},
// '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/one",
"https://mobile.contoso.com/two",
"https://mobile.contoso.com/three"
},
// 'Flyer Name' column header in the Bulk file
FlyerName = "Flyer name",
// 'Media Ids' column header in the Bulk file
ImageMediaIds = new[] {
(long)12345678,
},
// 'Media Urls' column header in the Bulk file
ImageMediaUrls = null,
// 'Store Id' column header in the Bulk file
StoreId = 12345678,
// '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"
},
}
},
// 'Ad Schedule' column header in the Bulk file
Scheduling = new Schedule
{
// Each day and time range is delimited by a semicolon (;) in the Bulk file
DayTimeRanges = new[]
{
// Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
new DayTime
{
Day = Day.Monday,
StartHour = 9,
StartMinute = Minute.Zero,
EndHour = 21,
EndMinute = Minute.Zero,
},
},
// 'End Date' column header in the Bulk file
EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
{
Month = 12,
Day = 31,
Year = DateTime.UtcNow.Year + 1
},
// 'Start Date' column header in the Bulk file
StartDate = null,
// 'Use Searcher Time Zone' column header in the Bulk file
UseSearcherTimeZone = false,
},
// 'Status' column header in the Bulk file
Status = AdExtensionStatus.Active,
},
};
uploadEntities.Add(bulkFlyerAdExtension);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
El İlanı Reklam Uzantısı kaydı için Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları kullanılabilir.
- Reklam Zamanlaması
- İstemci Kimliği
- Açıklama
- Editoryal Konum
- Editoryal Neden Kodu
- Editoryal Durum
- Editoryal Terim
- Bitiş Tarihi
- Son Url
- El İlanı Adı
- Kimlik
- Medya Kimlikleri
- Medya Url'leri
- Mobil Son Url
- Değiştirme Zamanı
- Üst Kimlik
- Yayımcı Ülkeleri
- Başlangıç Tarihi:
- Durum
- Mağaza Kimliği
- Arama Saat Dilimini Kullanma
- Sürüm
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.
Ad Schedule ve Use Searcher Saat Dilimi alanları birbirine bağlıdır ve birlikte güncelleştirilir. Güncelleştirme sırasında bu alanların ikisini de boş bırakırsanız, ikisi de güncelleştirilmez. Bu alanlardan herhangi biri için değerler eklerseniz, bu alanların her biri için önceki değerler kaldırılır veya değiştirilir.
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
Açıklama
Reklam veren, ajans veya hesap yöneticisi tarafından el ilanı uzantılarını izlemek, etiketlemek veya yönetmek için kullanılabilecek açıklama.
Bu açıklama reklam veya resimle birlikte görüntülenmez.
Bu öğe için uzunluk üst sınırı 1.024 karakterdir.
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
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.
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.
Bitiş Tarihi, Başlangıç Tarihinden itibaren 30 gün içinde olmalıdır.
Ekle: Gerekli
Güncelleştirme: Isteğe bağlı. Başlangıç tarihi ayarlanmadığı veya yeni bitiş tarihinden en fazla 30 gün önce gerçekleştiği sürece bitiş tarihi kısaltılabilir veya uzatılabilir.
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: 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
El İlanı Adı
El ilanı adı.
Bu öğe için uzunluk üst sınırı 150 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
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 Group Flyer Ad Extension ve Campaign Flyer Ad Extension 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
Medya Kimlikleri
Reklama eklenecek resmin tanımlayıcısı.
Yalnızca bir medya kimliği ayarlayabilirsiniz.
Her medya kimliği, "GenericImage" alt türünün görüntüsüne karşılık gelir.
Görüntünün en az genişliği ve yüksekliği 220 piksel, dosya boyutu üst sınırı ise 3,9 MB olmalıdı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
Medya Url'leri
Zaten eklediğiniz medyanın URL'si.
Ekle: Salt okunur
Güncelleştirme: Salt okunur
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.
Bitiş Tarihi, Başlangıç Tarihinden itibaren 30 gün içinde olmalıdır.
Ekle: Gerekli
Güncelleştirme: Isteğe bağlı. Bitiş tarihi ayarlanmadığı veya yeni başlangıç tarihinden 30 gün sonra gerçekleştiği sürece başlangıç tarihi kısaltılabilir veya uzatılabilir.
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.
Mağaza Kimliği
Ürün reklamları için kullanılan bir Microsoft Merchant Center mağazasının benzersiz tanımlayıcısı.
Ekle: Isteğe bağlı
Güncelleştirme: Salt okunur. Mağaza kimliği ayarlandıktan sonra güncelleştirilemez.
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.
Ad Schedule ve Use Searcher Saat Dilimi alanları birbirine bağlıdır ve birlikte güncelleştirilir. Güncelleştirme sırasında bu alanların ikisini de boş bırakırsanız, ikisi de güncelleştirilmez. Bu alanlardan herhangi biri için değerler eklerseniz, bu alanların her biri için önceki değerler kaldırılır veya değiştirilir.
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