Etiket Kaydı - Toplu

Makale
12/21/2023

Toplu bir dosyaya yüklenip indirilebilen bir etiket tanımlar.

Etiketler, sizin için önemli olan her şeyi temel alarak kampanyaları, reklam gruplarını, reklamları ve anahtar sözcükleri gruplar halinde düzenlemenize olanak sağlar. Daha sonra, sizin için en anlamlı verileri almak için etiketlerinizdeki raporları filtreleyebilir ve çalıştırabilirsiniz.

DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine EtiketlerinDownloadEntity değerini ekleyerek hesaptaki tüm Etiket 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 yeni bir etiket ekler.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Label,,-22,,,,ClientIdGoesHere,,,Label Description,Label Name,#FFFFFF

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

var uploadEntities = new List<BulkEntity>();

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

    // Map properties in the Bulk file to the 
    // Label object of the Campaign Management service.
    Label = new Label
    {
        // 'Color' column header in the Bulk file
        ColorCode = "#FFFFFF",
        // 'Description' column header in the Bulk file
        Description = "Label Description",
        // 'Id' column header in the Bulk file
        Id = labelIdKey,
        // 'Label' column header in the Bulk file
        Name = "Label Name " + DateTime.UtcNow
    },

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

uploadEntities.Add(bulkLabel);

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

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

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

Renk
İstemci Kimliği
Açıklama
Kimlik
Etiket
Değiştirme Zamanı
Durum

Renk

Onaltılık kod olarak etiket rengi.

Onaltılık değer '#' ön ekini içermelidir. Örneğin, beyaz etiket için #FFFFFF değerini kullanabilirsiniz.

Renk Microsoft Advertising web uygulamasında görüntülenebilir. Uygulamanız rengi görüntüleyebilir veya bir etiket kümesini kategorilere ayırmak için onaltılık değeri kullanabilir.

Ekle: Isteğe bağlı. Herhangi bir renk belirtmezseniz, değer her etiket için rastgele atanır.
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Renk kodunu güncelleştirebilirsiniz ancak kaldıramazsınız.
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.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı
Silmek: Salt okunur

Açıklama

Etiket açıklaması.

Etiket açıklaması 1 ila 200 karakter uzunluğunda olabilir.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Kimlik

Etiketin sistem tarafından oluşturulan tanımlayıcısı.

Ekle: Isteğe bağlı. Bu alanı boş bırakmanız veya negatif bir tanımlayıcı belirtmeniz gerekir. Daha sonra etiket için negatif tanımlayıcı kümesine Kampanya Etiketi gibi bağımlı kayıt türlerinin Üst Kimlik alanında başvurulabilir. Aynı Toplu dosyaya yeni etiket ve yeni bağımlı kayıtlar 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

Etiket

Etiket adı.

Büyük/küçük harfe duyarlı etiket adı 1 ila 80 karakter uzunluğunda olabilir ve hesaptaki tüm etiketler arasında benzersiz olmalıdır.

Ekle: Gerekli
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

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
Güncelleştirme: Salt okunur
Silmek: Salt okunur

Durum

Etiketin durumu.

Olası değerler Etkin veya Silinmiş değerlerdir.

Ekle: Isteğe bağlı. Varsayılan değer Etkin'dir.
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Gerekli. Durum , Silinmiş olarak ayarlanmalıdır.

Aracılığıyla paylaş