Reklam Grubu Negatif Benzer Yeniden Pazarlama Listesi İlişkilendirme Kaydı - Toplu

Makale
12/21/2023

Toplu bir dosyaya yüklenip indirilebilen bir Reklam Grubu Negatif Benzer Yeniden Pazarlama Listesi İlişkilendirmesi tanımlar.

Hedef kitle hedefleri hem kampanya hem de reklam grubu düzeyi belirlenemez. Teklif edilebilir kampanya düzeyi hedef kitle ölçütleri belirlerseniz, teklif edilebilir reklam grubu düzeyinde hedef kitle ölçütleri ayarlayamazsınız. Hedef kitle dışlamaları hem kampanya hem de reklam grubu düzeyinde ayarlanabilir. Microsoft Advertising hem kampanya hem de reklam grubu düzeyinde dışlamalar için bir birleşim uygular.

İpucu

İzleyiciler hakkında genel bir bakış ve daha fazla bilgi için hedef kitle API'leri teknik kılavuzuna bakın.

AdGroupNegativeSimilarRemarketingListAssociationsdownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine DownloadEntity değerini ekleyerek hesaptaki tüm Ad Grubu Negatif Benzer Yeniden Pazarlama Listesi İlişkilendirmesi 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 bir Üst Kimlik değeri sağlanırsa yeni bir Reklam Grubu Negatif Benzer Yeniden Pazarlama Listesi İlişkilendirmesi ekler.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Name,Audience Id,Audience
Format Version,,,,,,,,,6.0,,
Ad Group Negative Similar Remarketing List Association,Paused,,-1111,,,ClientIdGoesHere,,,,RemarketingListIdHere,My Remarketing List

.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 BulkAdGroupNegativeSimilarRemarketingListAssociation nesnesini karşıya yükleyip indirmek için zaman kazanabilirsiniz.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupNegativeSimilarRemarketingListAssociation
var bulkAdGroupNegativeSimilarRemarketingListAssociation = new BulkAdGroupNegativeSimilarRemarketingListAssociation
{
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,

    // Map properties in the Bulk file to the 
    // NegativeAdGroupCriterion object of the Campaign Management service.
    NegativeAdGroupCriterion = new NegativeAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new AudienceCriterion
        {
            // 'Audience Id' column header in the Bulk file
            AudienceId = similarRemarketingListIdKey,
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused
    },
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Audience' column header in the Bulk file
    AudienceName = null,
};

uploadEntities.Add(bulkAdGroupNegativeSimilarRemarketingListAssociation);

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

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

Bir Reklam Grubu Negatif Benzer Yeniden Pazarlama Listesi İlişkilendirme kaydı için Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları bulunur.

Reklam Grubu
Seyirci
Hedef Kitle Kimliği
Kampanya
İstemci Kimliği
Kimlik
Değiştirme Zamanı
Üst Kimlik
Durum

Reklam Grubu

Benzer yeniden pazarlama listesiyle ilişkili reklam grubunun adı.

Ekle: Salt okunur ve Gerekli
Güncelleştirme: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

Not

Ekleme, güncelleştirme ve silme için Üst Kimlik veya Ad Grubu alanını belirtmeniz gerekir.

Seyirci

Benzer yeniden pazarlama listesinin adı.

Bu toplu alan, Benzer Yeniden Pazarlama Listesi kaydının Hedef Kitle alanına eşler.

Ekle: Bazı kullanım örnekleri için salt okunur ve Gerekli. hedef kitle veya hedef kitle kimliği alanını belirtmeniz gerekir. Aynı Toplu dosyaya yeni benzer yeniden pazarlama listeleriyle yeni Reklam Grubu Negatif Benzer Yeniden Pazarlama Listesi İlişkilendirmeleri ekliyorsanız ve Hedef Kitle Kimliği alanını ayarlamazsanız, bu Hedef Kitle alanı Benzer Yeniden Pazarlama Listesi kaydının Hedef Kitle alanıyla aynı değere mantıksal anahtar olarak ayarlanmalıdır. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
Güncelleştirme: Salt okunur
Silmek: Salt okunur

Hedef Kitle Kimliği

Reklam grubuyla ilişkili benzer yeniden pazarlama listesinin Microsoft Advertising tanımlayıcısı.

Bu toplu alan, Benzer Yeniden Pazarlama Listesi kaydının Kimlik alanına eşler.

Ekle: Bazı kullanım örnekleri için salt okunur ve Gerekli. hedef kitle veya hedef kitle kimliği alanını belirtmeniz gerekir. hedef kitle kimliği alanını ayarlarsanız, mevcut bir benzer yeniden pazarlama listesi tanımlayıcısı belirtmeniz veya üst Benzer Yeniden Pazarlama Listesi kaydının Kimlik alanına eşit negatif bir tanımlayıcı belirtmeniz gerekir. hedef kitle kimliği alanı ayarlanmadıysa, Hedef Kitle alanını mantıksal anahtar olarak Benzer Yeniden Pazarlama Listesi kaydının Hedef Kitle alanıyla aynı değere ayarlamanız gerekir. Aynı Toplu dosyaya yeni benzer yeniden pazarlama listeleriyle yeni Reklam Grubu Negatif Benzer Yeniden Pazarlama Listesi İlişkilendirmeleri ekliyorsanız bu seçeneklerden herhangi biri önerilir. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
Güncelleştirme: Salt okunur
Silmek: Salt okunur

Kampanya

Reklam grubunu içeren kampanyanın adı.

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

Kimlik

Bir reklam grubu ile benzer yeniden pazarlama listesi arasındaki ilişki için sistem tarafından oluşturulan tanımlayıcı.

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

Üst Kimlik

Benzer yeniden pazarlama listesiyle ilişkili reklam grubunun sistem tarafından oluşturulan 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. Benzer yeniden pazarlama listelerini aynı Toplu dosyadaki yeni bir reklam grubuyla ilişkilendiriyorsanı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

Not

Ekleme, güncelleştirme ve silme için Üst Kimlik veya Ad Grubu alanını belirtmeniz gerekir.

Durum

İlişkilendirme durumu.

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

Ekle: Isteğe bağlı. Varsayılan durum değeri Etkin'dir.
Güncelleştirme: Isteğe bağlı
Silmek: Gerekli. Durum , Silinmiş olarak ayarlanmalıdır.

Aracılığıyla paylaş