Aracılığıyla paylaş

Ad Grubu Yapılandırılmış Kod Parçacığı Ad Uzantısı Kaydı - Toplu

  • Makale

Bir Reklam Grubu ile Yapılandırılmış Kod Parçacığı Ad Uzantısı arasında toplu dosyaya yüklenip indirilebilen bir ilişkilendirme kaydı tanımlar. Reklam grubunu veya yapılandırılmış kod parçacığı reklam uzantısını karşıya yüklemek veya indirmek için Ad Grubu veya Yapılandırılmış Kod Parçacığı Ad Uzantısı kaydını kullanın.

AdGroupStructuredSnippetAdExtensions'ınDownloadEntity değerini DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine ekleyerek hesaptaki tüm Ad Grubu Yapılandırılmış Kod Parçacığı 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 Ebeveyn Kimliği değerleri sağlandığında yapılandırılmış kod parçacığı reklam uzantısını bir reklam grubuyla ilişkilendirir.

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

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

var uploadEntities = new List<BulkEntity>();

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

uploadEntities.Add(bulkAdGroupStructuredSnippetAdExtension);

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

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

Bir Ad Grubu Yapılandırılmış Kod Parçacığı Ad Uzantısı kaydı için, Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları kullanılabilir.

Reklam Grubu

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

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

Not

Ekleme ve silme için Üst Kimlik veya Reklam Grubu ve Kampanya alanlarının ikisini de belirtmeniz gerekir.

Kampanya

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

Ekle: Salt okunur
Silmek: Salt okunur

Not

Ekleme ve silme için Üst Kimlik veya Reklam Grubu ve Kampanya alanlarının ikisini de 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

Reklam grubuyla ilişkili veya reklam grubundan kaldırılan reklam uzantısının tanımlayıcısı.

Bu toplu alan, Yapılandırılmış Kod Parçacığı Ad 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 Yapılandırılmış Kod Parçacığı Ad Uzantısı kaydının Kimlik alanına eşit negatif bir 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ığı reklam grubunun 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. Bu, reklam uzantılarını aynı Toplu dosyadaki yeni bir reklam grubuyla ilişkilendiriyorsanız ö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 Kimlik veya Reklam Grubu ve Kampanya alanlarının ikisini de 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

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

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

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