Kampanya Etiketi Kaydı - Toplu

Makale
12/21/2023

Kampanya ile Etiket arasında toplu dosyaya yüklenip indirilebilen bir ilişkilendirme kaydı tanımlar. Kampanyayı veya etiketi karşıya yüklemek veya indirmek için Kampanya veya Etiket kaydını kullanın.

DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine CampaignLabels'inDownloadEntity değerini ekleyerek hesaptaki tüm Kampanya Etiketi 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ğlanmışsa kampanyaya bir etiket uygular.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Campaign Label,,-22,-111,,,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 BulkCampaignLabel nesnesini karşıya yükleyip indirebilirsiniz.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignLabel
var bulkCampaignLabel = new BulkCampaignLabel
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // LabelAssociation object of the Campaign Management service.
    LabelAssociation = new LabelAssociation
    {
        // 'Parent Id' column header in the Bulk file
        EntityId = campaignIdKey,
        // 'Id' column header in the Bulk file
        LabelId = labelIdKey
    },

    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignLabel);

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

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

Kampanya Etiketi kaydı için, Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları kullanılabilir.

Kampanya
İstemci Kimliği
Kimlik
Değiştirme Zamanı
Üst Kimlik
Durum

Kampanya

Bu etiketin uygulandığı veya kaldırıldığı kampanyayı içeren kampanyanın adı.

Ekle: Salt okunur
Silmek: Salt okunur

Not

Ekleme ve silme için Üst Kimliği veya Kampanya'yı belirtmeniz gerekir. Toplu indirme için Kampanya alanı döndürülmedi.

İ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

Kimlik

Kampanyaya uygulanan veya kampanyadan kaldırılan etiketin tanımlayıcısı.

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

Ekle: Salt okunur ve Gerekli. Var olan bir etiket tanımlayıcısı belirtmeniz veya üst Etiket kaydının Kimlik alanına eşit negatif bir tanımlayıcı belirtmeniz gerekir. Aynı Toplu dosyadaki kampanyalara yeni etiketler uyguluyorsanı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 etiketin uygulandığı 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. Aynı Toplu dosyada yeni bir kampanyaya etiket uyguluyorsanı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. Toplu indirme için Kampanya alanı döndürülmedi.

Durum

Kampanya ile etiket arasında uygulanan durumu temsil eder.

Olası değerler Etkin ve Silinmiş'tir. Etiket kampanyaya uygulanırsa, bu alanın değeri Etkin olur.

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

Aracılığıyla paylaş