Aracılığıyla paylaş

Otel Reklam Kaydı - Toplu

  • Makale

Toplu dosyada indirilebilen ve karşıya yüklenebilecek bir otel reklamı tanımlar.

Teslim edilen reklam kopyası için doğrudan otel reklamı kullanılmaz. Bunun yerine, teslimat motoru müşterinin Microsoft Merchant Center mağaza kataloğunda bulduğu otel ayrıntılarından otel reklamları oluşturur.

DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğinde HotelAds'inDownloadEntity değerini ekleyerek hesaptaki tüm Hotel Ad 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, geçerli bir Ebeveyn Kimliği değeri sağlanırsa yeni bir otel reklamı ekler.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,
Hotel Ad,Active,,-1112,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,,,Find New Customers & Increase Sales!,,,,,,,,,,,,,

.NET, Java veya Python için Bing Ads SDK'larını kullanıyorsanız, bulkservicemanager kullanarak bulkhotelad nesnesini karşıya yükleyip indirmek için zaman kazanabilirsiniz. Bunun yerine, hizmet işlemlerini doğrudan çağırabilir ve toplu dosyadaki her alanı ayrıştırmak için özel kod yazabilirsiniz.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkHotelAd
var bulkHotelAd = new BulkHotelAd
{
    // '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 
    // HotelAd object of the Campaign Management service.
    HotelAd = new HotelAd
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Promotion' column header in the Bulk file
        PromotionalText = "Find New Customers & Increase Sales!",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
    },
};

uploadEntities.Add(bulkHotelAd);

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

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

Bir Hotel Ad kaydı için Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları bulunur.

Reklam Grubu

Reklamı içeren reklam grubunun adı.

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

Kampanya

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

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

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

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

Editoryal Konum

Editoryal incelemede başarısız olan reklamı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ı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 Birleşik Devletler incelemeyi beklemeye devam etmektedir.
Onaylanmadı Reklam, editoryal incelemede başarısız oldu.
Etkin olmayan Reklamı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

Kimlik

Reklamı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 ad için negatif tanımlayıcı kümesine, Hotel Ad Label gibi bağımlı kayıt türlerinin Üst Kimlik alanında 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ştirme: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

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ı 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.

Ekle: 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ştirme: 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.

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

Durum

Reklamın durumu.

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

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.