Aracılığıyla paylaş

Özel Hedef Kitle Kaydı - Toplu

  • Makale

Toplu bir dosyaya indirilebilen ve karşıya yüklenebilecek özel bir hedef kitle tanımlar.

Not

Karşıya yükleme için yalnızca hedef kitle (hedef kitle adı) ve Açıklama alanlarının güncelleştirilip desteklenmediği. Bing Ads API'sini kullanarak özel hedef kitleyi silebilirsiniz ancak ekleyemezsiniz. Bunu söyledikten sonra, özel hedef kitle ilişkilendirmeleri ve dışlamaları ekleyebilir ve silebilirsiniz.

Özel hedef kitle, daha zengin kullanıcı segmentleri oluşturmak için kendi müşteri verilerinizi kullanarak oluşturulan bir yeniden pazarlama listesi türüdür. Özel hedef kitleleri, genellikle veri yönetimi sağlayıcınız (DMP) aracılığıyla yeniden pazarlama listelerinizle birlikte kullanabilirsiniz. DMP'niz özel hedef kitle özelliğimize bağlandığında, arama yeniden pazarlaması için özel hedef kitlelerinizi Microsoft Advertising'e aktarabilirsiniz. Özel hedef kitleleri, UET gerektirmeden yeniden pazarlamadan ayrı olarak kullanabilirsiniz.

İ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 CustomAudiences'inDownloadEntity değerini ekleyerek hesaptaki tüm Özel Hedef Kitle 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, özel bir hedef kitlenin açıklamasını güncelleştirir. Not: Özel bir hedef kitle için üyelik süresi Microsoft Advertising web uygulamasında ayarlanmaz ve Microsoft Advertising özel hedef kitle sağlayıcısı ayarlarınıza karşı çıkar.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Supported Campaign Types
Format Version,,,,,,6.0,,,,,
Custom Audience,Active,IdHere,ParentIdHere,ClientIdGoesHere,,,Updated Custom Audience Description,30,Account,Custom Audience,Search;DynamicSearchAds;Shopping;Audience

.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 BulkCustomAudience nesnesini karşıya yükleyip indirebilirsiniz.

var uploadEntities = new List<BulkEntity>();

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

    // Map properties in the Bulk file to the 
    // CustomAudience object of the Campaign Management service.
    CustomAudience = new CustomAudience
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "Updated Custom Audience Description",
        // 'Id' column header in the Bulk file
        Id = customAudienceIdKey,
        // 'Audience' column header in the Bulk file
        Name = null,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Scope' column header in the Bulk file
        Scope = null,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCustomAudience);

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

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

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

Seyirci

Özel hedef kitlenin adı.

Ad en fazla 128 karakter içerebilir.

Ekle: Desteklenmiyor
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

Hedef Kitle Ağ Boyutu

Hedef Kitle ağındaki bu hedef kitlenin etkin üyesi olan toplam kişi sayısı. Bu, hedefleyebileceğiniz hedef kitle ağı kullanıcısı sayısı hakkında size bir fikir verir.

Microsoft Advertising'in iyileştirmeler için kullanabilmesi için hedef kitlenin en az 300 kişi olması gerekir.

Ekle: Desteklenmiyor
Güncelleştirme: Salt okunur
Silmek: Salt okunur

İzleyici Arama Boyutu

Arama ağındaki bu hedef kitlenin etkin üyesi olan toplam kişi sayısı. Bu size kaç arama kullanıcısının hedefleyebileceğiniz hakkında bir fikir verir.

Microsoft Advertising'in iyileştirmeler için kullanabilmesi için hedef kitlenin en az 300 kişi olması gerekir.

Bu özellik, hedef kitle oluşturulurken 24 saate kadar boş kalır. Örneğin DMP'den yeni özel hedef kitleleri içeri aktardıysanız, hedef kitlenin oluşturulması 24 saat sürer ve bu arada bu özellik boş olur.

Ekle: Desteklenmiyor
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: Desteklenmiyor
Güncelleştirme: Isteğe bağlı
Silmek: Salt okunur

Açıklama

Özel hedef kitlenin açıklaması. Bu özel hedef kitleyle hedeflediğiniz hedef kitleyi hatırlamanıza yardımcı olması için bir açıklama kullanın.

Açıklama en fazla 1.024 karakter içerebilir.

Ekle: Desteklenmiyor
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Bu alanı delete_value dizesi olarak ayarlarsanız, önceki ayar kaldırılır.
Silmek: Salt okunur

Kimlik

Özel hedef kitlenin sistem tarafından oluşturulan tanımlayıcısı.

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

Üyelik Süresi

Üyelik süresi, Microsoft Advertising'in listenize kişi eklemek için özel hedef kitle tanımınızla eşleşen eylemleri ne kadar geriye araması gerektiğini belirler. Özel hedef kitle için üyelik süresi Microsoft Advertising web uygulamasında ayarlanmaz ve Microsoft Advertising özel hedef kitle sağlayıcı ayarlarınıza karşı çıkar.

Bing Ads API aracılığıyla özel hedef kitle isteğinde bulunursanız, döndürülen üyelik süresi null olur.

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

Üst Kimlik

Özel hedef kitleyi içeren müşterinin Microsoft Advertising tanımlayıcısı.

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

Kapsam

Kapsam, hangi hesapların bu özel hedef kitleyi kullanabileceğini tanımlar. Özel hedef kitle için desteklenen tek kapsam Müşteri'dir ve özel hedef kitle müşterinin tüm hesaplarında kampanyalar ve reklam gruplarıyla ilişkilendirilebilir.

Ekle: Desteklenmiyor
Güncelleştirme: Salt okunur
Silmek: Salt okunur

Durum

Özel hedef kitle durumu.

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

Ekle: Desteklenmiyor
Güncelleştirme: Salt okunur
Silmek: Gerekli. Durum , Silinmiş olarak ayarlanmalıdır.

Desteklenen Kampanya Türleri

Bu özel hedef kitleyi destekleyen kampanya türlerinin noktalı virgülle ayrılmış listesi.

Desteklenen değerler: Audience, DynamicSearchAds, Search ve Shopping. Gelecekte yeni kampanya türleri eklenebilir, bu nedenle sabit bir değer kümesine bağımlılık almamalısınız.

Ekle: Desteklenmiyor
Güncelleştirme: Salt okunur
Silmek: Salt okunur