Aracılığıyla paylaş

PazarDaki Kampanya Hedef Kitleler Birliği Kaydı - Toplu

  • Makale

Toplu bir dosyaya yüklenip indirilebilen Bir Markette Kampanya Hedef Kitlesi İlişkilendirmesini tanımlar.

Not

Bu özellik Avustralya, Kanada, Fransa, Almanya, Birleşik Krallık ve Birleşik Devletler'de kullanılabilir.

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.

DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine CampaignInMarketAudienceAssociationsdownloadEntity değerini ekleyerek hesaptaki tüm Campaign In Market Audience Association 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 Markette Kampanya Hedef Kitlesi İ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,,
Campaign In Market Audience Association,Paused,,-1111,,,ClientIdGoesHere,,10,,InMarketAudienceIdHere,My In Market Audience

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignInMarketAudienceAssociation
var bulkCampaignInMarketAudienceAssociation = new BulkCampaignInMarketAudienceAssociation
{
    // Map properties in the Bulk file to the 
    // BiddableCampaignCriterion object of the Campaign Management service.
    BiddableCampaignCriterion = new BiddableCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new AudienceCriterion
        {
            // 'Audience Id' column header in the Bulk file
            AudienceId = inMarketAudienceIdKey,
        },
        // 'Bid Adjustment' column header in the Bulk file
        CriterionBid = new BidMultiplier
        {
            Multiplier = 10
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = CampaignCriterionStatus.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(bulkCampaignInMarketAudienceAssociation);

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

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

Marketteki Bir Kampanya hedef kitlesi ilişkisi kaydı için, Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları kullanılabilir.

Seyirci

Pazardaki hedef kitlenin adı.

Bu toplu alan, PazardakiHedef Kitle kaydının Hedef Kitle alanına eşler.

Toplu API indirme, pazardaki hedef kitlenin etkin veya silinmiş olması fark etmeksizin tüm pazar içi hedef kitle ilişkilendirmelerini döndürür. İlişkilendirme, silinen bir pazar içi hedef kitleye yönelikse, bu alan Hedef Kitle Kimliği alanıyla aynı değere ayarlanır.

Ekle: Bazı kullanım örnekleri için salt okunur ve Gerekli. hedef kitle veya hedef kitle kimliği alanını belirtmeniz gerekir. Aynı Toplu dosyada yeni pazar içi hedef kitlelerle yeni Pazardaki Kampanya Hedef Kitlesi İlişkilendirmeleri ekliyorsanız ve Hedef Kitle Kimliği alanını ayarlamazsanız, bu Hedef Kitle alanı Pazardaki Hedef Kitle 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

Kampanyayla ilişkili pazar içi hedef kitlenin Microsoft Advertising tanımlayıcısı.

Bu toplu alan, Pazardaki Hedef Kitle 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 pazar içi hedef kitle tanımlayıcısı belirtmeniz veya Pazardaki Hedef Kitle kaydının üst öğesinin Kimlik alanına eşit negatif bir tanımlayıcı belirtmeniz gerekir. hedef kitle kimliği alanı ayarlanmadıysa, Hedef Kitle alanını, PazardakiHedef Kitle kaydının Hedef Kitle alanıyla aynı değere mantıksal anahtar olarak ayarlamanız gerekir. Bu seçeneklerden herhangi biri, aynı Toplu dosyada yeni pazar içi hedef kitlelerle yeni Pazardaki Kampanya Kitleleri İlişkilendirmeleri ekliyorsanız önerilir. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
Güncelleştirme: Salt okunur
Silmek: Salt okunur

Teklif Ayarlaması

Pazar içi hedef kitle için teklif tutarını artırmak/azaltmak istediğiniz yüzde.

Desteklenen değerler negatif doksan (-90,00) ile pozitif dokuz yüz (900,00) arasındadır.

Önemli

Belirtilmezse, varsayılan teklif ayarlama değeri 0'dır. Varsayılan değer değiştirilebilir.

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

Kampanya

Pazardaki hedef kitleyle ilişkili kampanyanın 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 Kampanya alanını 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ı
Güncelleştirme: Isteğe bağlı
Silmek: Salt okunur

Kimlik

Kampanya ve pazar içi hedef kitle arasındaki ilişkilendirme 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

Pazardaki hedef kitleyle ilişkili kampanyanın sistem tarafından oluşturulan 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. Pazardaki hedef kitleleri aynı Toplu dosyadaki yeni bir kampanyayla 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 Kampanya alanını belirtmeniz gerekir.

Durum

İlişkilendirme durumu.

Olası değerler Etkin, Duraklatılmış veya Silinmiş olabilir.

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.