Aracılığıyla paylaş

Hesap Yükseltme Reklam Uzantısı Kaydı - Toplu

  • Makale

Bir Hesap ile Promosyon Reklam Uzantısı arasında toplu bir dosyaya yüklenip indirilebilen bir ilişkilendirme kaydı tanımlar. Hesap veya promosyon reklam uzantısını karşıya yüklemek veya indirmek için Hesap veya Promosyon Reklam Uzantısı kaydını kullanın.

Not

Yükseltme Uzantıları özellik pilotundaki müşteriler tarafından kullanılabilir (GetCustomerPilotFeatures 720 döndürür).

Hesaptaki tüm Hesap Yükseltme Reklam Uzantısı kayıtlarını, DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine AccountPromotionAdExtensionsDownloadEntity değerini ekleyerek 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 sağlanmışsa bir promosyon reklam uzantısını bir hesapla ilişkilendirir.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name
Format Version,,,,,,6.0
Account Promotion Ad Extension,Active,-11,,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 BulkAccountPromotionAdExtension nesnesini karşıya yükleyip indirebilirsiniz.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAccountPromotionAdExtension
var bulkAccountPromotionAdExtension = new BulkAccountPromotionAdExtension
{
    // 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 = promotionAdExtensionIdKey,
        // 'Parent Id' column header in the Bulk file
        EntityId = accountIdKey,
    },
                
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active,
};

uploadEntities.Add(bulkAccountPromotionAdExtension);

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

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

Hesap Yükseltme Reklam Uzantısı kaydı için Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları bulunur.

İ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

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

Bu toplu alan, Promosyon Reklam Uzantısı 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 Promosyon Reklam 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ı.
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
Silmek: Salt okunur

Üst Kimlik

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

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

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

Durum

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

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

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