Aracılığıyla paylaş

Kampanya Çağrısı Reklam Uzantısı Kaydı - Toplu

  • Makale

Kampanya ile Arama Reklam Uzantısı arasında toplu dosyaya yüklenebilecek ve indirilebilen bir ilişkilendirme kaydı tanımlar. Kampanyayı karşıya yüklemek veya indirmek ya da reklam uzantısını çağırmak için Kampanya veya Arama Reklam Uzantısı kaydını kullanın.

DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine CampaignCallAdExtensionsDownloadEntity değerini ekleyerek hesaptaki tüm Campaign Call Ad 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, geçerli Kimlik ve Üst Kimlik değerleri sağlandığında bir çağrı reklam uzantısını kampanyayla ilişkilendirir.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name
Format Version,,,,,,,,6.0
Campaign Call Ad Extension,Active,-11,-1111,,,ClientIdGoesHere,,

.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 BulkCampaignCallAdExtension nesnesini karşıya yükleyip indirebilirsiniz.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignCallAdExtension
var bulkCampaignCallAdExtension = new BulkCampaignCallAdExtension
{
    // Map properties in the Bulk file to the 
    // AdExtensionIdToEntityIdAssociation object of the Campaign Management service.
    AdExtensionIdToEntityIdAssociation = new AdExtensionIdToEntityIdAssociation
    {
        // 'Id' column header in the Bulk file
        AdExtensionId = callAdExtensionIdKey,
        // 'Parent Id' column header in the Bulk file
        EntityId = campaignIdKey,
    },
                
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active,
};

uploadEntities.Add(bulkCampaignCallAdExtension);

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

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

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

Kampanya

Bu reklam uzantısının ilişkilendirildiği veya kaldırıldığı kampanyanın adı.

Ekle: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

Not

Ekleme ve silme için Üst Kimliği veya Kampanya'yı belirtmeniz gerekir.

İ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ı
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
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
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
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
Silmek: Salt okunur

Kimlik

Kampanyayla ilişkili veya kampanyadan kaldırılan reklam uzantısının tanımlayıcısı.

Bu toplu alan, Ad UzantısıNı Çağır kaydının Kimlik alanına eşler.

Ekle: Salt okunur ve Gerekli. Mevcut bir reklam uzantısı tanımlayıcısı belirtmeniz veya üst Arama Adı Uzantısı kaydının Kimlik alanına eşit bir negatif tanımlayıcı belirtmeniz gerekir. Aynı Toplu dosyaya yeni reklam uzantıları ve ilişkilendirmeler ekliyorsanız bu önerilir. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
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
Silmek: Salt okunur

Üst Kimlik

Bu reklam uzantısının ilişkilendirildiği veya kaldırıldığı kampanyanın tanımlayıcısı.

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

Ekle: Salt okunur ve Gerekli. Mevcut bir kampanya tanımlayıcısı belirtmeniz veya üst Kampanya kaydının Kimlik alanına eşit bir negatif tanımlayıcı belirtmeniz gerekir. Reklam uzantılarını aynı Toplu dosyadaki yeni bir kampanyayla ilişkilendiriyorsanız bu önerilir. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
Silmek: Salt okunur ve Gerekli

Not

Ekleme ve silme için Üst Kimliği veya Kampanya'yı 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
Silmek: Salt okunur

Durum

Kampanya ile reklam uzantısı arasındaki ilişkilendirme durumunu temsil eder.

Olası değerler Etkin ve Silinmiş'tir. Reklam uzantısı kampanyayla ilişkiliyse, bu alanın değeri Etkin olur.

Ekle: Salt okunur
Silmek: Gerekli. Durum , Silinmiş olarak ayarlanmalıdır.