Aracılığıyla paylaş

Ürün Reklam Kaydı - Toplu

  • Makale

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

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

DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine ProductAds'inDownloadEntity değerini ekleyerek hesaptaki tüm Product 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 ürün 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,,,,,,,,,,
Product 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, hizmet işlemlerini doğrudan çağırmak ve toplu dosyadaki her alanı ayrıştırmak için özel kod yazmak yerine BulkServiceManager kullanarak BulkProductAd nesnesini karşıya yükleyip indirebilirsiniz.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkProductAd
var bulkProductAd = new BulkProductAd
{
    // '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 
    // ProductAd object of the Campaign Management service.
    ProductAd = new ProductAd
    {
        // '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(bulkProductAd);

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

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

Ürün Reklam kaydı için, Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları bulunur.

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.

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

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 Birleşik Devletler incelemeyi 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

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 reklam için negatif tanımlayıcı kümesine Ürün Reklam Etiketi 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ştirmek: 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.

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.

Not

3 Aralık 2024 itibarıyla silme işlemi artık ürün reklam kayıtları için Toplu API'de desteklenmeyecektir. Bunun nedeni ürün reklam varlığının sistem tarafından oluşturulmasıdır.

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.