Birleştirilmiş Liste Kaydı - Toplu
Toplu bir dosyaya indirilebilen ve karşıya yüklenebilecek birleşik bir liste tanımlar.
Birleştirilmiş liste, birden çok mevcut hedef kitlenin birleşiminden oluşturulan bir hedef kitledir.
İ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 CombinedLists'inDownloadEntity değerini ekleyerek hesaptaki tüm Birleşik Liste 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 birleştirilmiş liste ekler.
Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Combination Rule
Format Version,,,,,,6.0,,,,,,
Combined List,Active,-10,,ClientIdGoesHere,,,New combined list description,Customer,New Combined List,NOT(123IdGoesHere,234IdGoesHere)&AND(345IdGoesHere,456IdGoesHere)&OR(567IdGoesHere)
.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 BulkServiceManager kullanarak BulkCombinedList nesnesini karşıya yükleyip indirebilirsiniz.
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkCombinedList
var bulkCombinedList = new BulkCombinedList
{
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// CombinedList object of the Campaign Management service.
CombinedList = new CombinedList
{
// 'Audience Network Size' column header in the Bulk file
AudienceNetworkSize = null,
// 'Description' column header in the Bulk file
Description = "New Combined List",
// 'Id' column header in the Bulk file
Id = combinedListIdKey,
// 'Membership Duration' column header in the Bulk file
MembershipDuration = 30,
// 'Audience' column header in the Bulk file
Name = "Combined List " + DateTime.UtcNow,
// 'Parent Id' column header in the Bulk file
ParentId = accountIdKey,
// 'Combination Rule' column header in the Bulk file
CombinationRules = new[]
{
// Each rule is delimited by a semicolon (;) in the Bulk file
new CombinationRule
{
AudienceIds = new [] { 123, 234 },
Operator = LogicalOperator.And
},
new CombinationRule
{
AudienceIds = new [] { 345, 456 },
Operator = LogicalOperator.And
},
},
// 'Scope' column header in the Bulk file
Scope = EntityScope.Account,
// '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(bulkCombinedList);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
Birleştirilmiş Liste kaydı için Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları bulunur.
- Seyirci
- Hedef Kitle Ağ Boyutu
- İzleyici Arama Boyutu
- İstemci Kimliği
- Birleşim Kuralı
- Açıklama
- Kimlik
- Değiştirme Zamanı
- Üst Kimlik
- Kapsam
- Durum
- Desteklenen Kampanya Türleri
Seyirci
Birleştirilmiş listenin adı.
Ad en fazla 128 karakter içerebilir.
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
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: Salt okunur
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, örneğin birleştirilmiş liste üyeliği süresini, kuralını veya etiket tanımlayıcısını ekler veya güncelleştirirseniz izleyici oluşturulurken 24 saate kadar boş kalır.
Birleştirilmiş listeyle ilişkilendirilmiş UET etiketi Doğrulanmamış veya Etkin Değil durumundaysa bu özellik boş olur çünkü birleştirilmiş liste web sitenizden listeyi oluşturmak için gereken müşteri bilgilerini alamaz.
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
Birleşim Kuralı
Birleşik kural, birleştirilmiş listenize kimlerin ekleneceğini belirlemek için kullanılan koşulları içerir.
Özel hedef kitleleri, müşteri listelerini, ürün hedef kitlelerini, benzer hedef kitleleri ve yeniden pazarlama listelerini birleştirebilirsiniz. Birleştirilmiş listeye diğer birleşik listeleri veya pazardaki hedef kitleleri ekleyemezsiniz.
Reklam hesabı başına en fazla 1.000 birleşik liste ve müşteri başına en fazla 5.000 liste oluşturabilirsiniz. Her listenin birleşim kuralı en fazla 100 mantıksal koşul kümesi içerebilir ve her küme en fazla 100 hedef kitle kimliği içerebilir.
Aşağıda açıklanan bazı kısıtlamalarla, şu mantıksal işleçleri kullanarak hedef kitleleri birleştirebilirsiniz:
- VEYA: Bu, bu hedef kitle listelerinden herhangi birinde yer alan müşterileri içerir.
- VE: Bu, yalnızca bu hedef kitle listelerinin her birinde yer alan müşterileri içerir.
- NOT: Bu, bu hedef kitle listelerinden herhangi birinde yer alan müşterileri dışlar.
Mantıksal koşul kümesi, OR, AND veya NOT tarafından nitelenen bir grup hedef kitle kimliğine başvurur. Toplu API'de her küme bir ve işareti ('&') ile sınırlandırılır.
Örneğin, her biri bir hedef kitle kimliğine sahip bir birleşik kural için 10 küme vardır: NOT(1)&AND(2)&OR(3)&NOT(4)&AND(5)&OR(6)&NOT(7)&AND(8)&OR(9)&NOT(10)
Aşağıda, tek bir birleşim kuralı için 10 küme örneği verilmiştir. her iki hedef kitle kimlikli: NOT(1,101)&AND(2,102)&OR(3,103)&NOT(4,104)&AND(5,105))&OR(6.106)&NOT(7.107)&AND(8.108)&OR(9.109)&NOT(10.110)
Mantıksal ifadenin değerlendirilmesi, birleştirilmiş listeye kimlerin ekleneceğini belirler. Birden çok birleşim her zaman bir AND işleviyle birleştirilir. Bu, bir müşterinin bu özel birleşim hedef kitle listesinde görünmesi için her birleşimin tüm ölçütlerini karşılaması gerektiği anlamına gelir. Örneğin, birleşim kuralının NOT(123.234)&NOT(345.456)&AND(567.678)&OR(789.890)&OR(987.876) olarak ayarlandığını düşünelim. Birleştirilmiş liste, a) hem hedef kitle 567 hem de 678 ve b) hedef kitle 789 veya 890'da yer alan ve c) 987 veya 876 hedef kitlesinde yer alan müşterileri (d) müşteri 123, 234, 345 veya 456 hedef kitlesinde yer almadığı sürece içerir.
Birleştirilmiş liste, OR veya AND işleçlerini kullanan en az bir hedef kitle içermelidir. Birleştirilmiş liste yalnızca NOT işlecini kullanamaz. Bu durumda bunun yerine hedef kitle dışlamalarını kullanmanız gerekir.
Özel hedef kitleler ve müşteri listeleri diğer hedef kitle türleriyle birleştirilemez.
Benzer hedef kitleler VE veya NOT işleçleri aracılığıyla birleştirilemez. Benzer hedef kitleler yalnızca tek veya koşulunda kullanılabilir. Başka bir deyişle, benzer hedef kitleler içeren yalnızca bir hedef kitle kümesi olabilir ve bu küme OR işlecini kullanmalıdır.
Yinelenen hedef kitlelere izin verilir, ancak aynı hedef kitle kimliği hem AND hem de NOT işleci aracılığıyla birleştirilemez.
Aynı Toplu karşıya yüklemede bu Birleştirilmiş Liste ile birlikte yeni bir hedef kitle oluşturuyorsanız, birleşim kuralı diğer yeni hedef kitlenin Kimlik alanına eşit negatif bir tanımlayıcı içerebilir. Örneğin, yeni bir Yeniden Pazarlama Listesi oluşturuyorsanız ve bunu birleştirilmiş listeye eklemek istiyorsanız, yeniden pazarlama listesinin Kimlik değerini -1 olarak ayarlayabilirsiniz. Aynı Toplu yüklemede, birleşim kuralında -1 kullanarak yeni yeniden pazarlama listesine başvurabilirsiniz; örneğin, NOT(123,234)&AND(345,456)&OR(-1,678). Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
Aynı toplu karşıya yüklemede bu Birleştirilmiş Liste ile birlikte yeni bir hedef kitle oluşturuyorsanız, birleşim kuralı diğer yeni hedef kitlenin negatif kimlik alanına negatif başvuru anahtarı içerebilir. Ayrıca, diğer yeni hedef kitlenin Hedef Kitle (ad) alanına mantıksal başvuru anahtarı da kullanabilirsiniz.
- Negatif başvuru anahtarı kullanma örneği olarak, aynı toplu karşıya yüklemede kimliğin -1 olarak ayarlandığı yeni bir Yeniden Pazarlama Listesi yer alır. Ardından birleşim kuralında -1 kullanarak yeni yeniden pazarlama listesine bakın; örneğin, NOT(123,234)&AND(345,456)&OR(-1,678)).
- Mantıksal başvuru anahtarı kullanma örneği olarak, aynı toplu karşıya yüklemede hedef kitle adının Yeni Hedef Kitlem olarak ayarlandığı yeni bir Yeniden Pazarlama Listesi yer alır. Ardından, OR('Yeni Hedef Kitlem',678) &AND(345,456)&VE(345,456 &)gibi birleşim kuralında "Hedef Kitlem" (tek tırnaklarla çevrili) kullanarak yeni yeniden pazarlama listesine bakın.
Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
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
Açıklama
Birleştirilmiş listenin açıklaması. Bu birleştirilmiş listeyle 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: 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. Bu alanı delete_value dizesi olarak ayarlarsanız, önceki ayar kaldırılır.
Silmek: Salt okunur
Kimlik
Birleştirilmiş listenin sistem tarafından oluşturulan tanımlayıcısı.
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
Hesabın veya müşterinin sistem tarafından oluşturulan tanımlayıcısı. KapsamHesap olarak ayarlandıysa, bu hesap kimliğidir ve aksi takdirde müşteri kimliğidir.
Ekle: Isteğe bağlı
Güncelleştirme: Salt okunur. Üst kimliği değiştiremezsiniz.
Silmek: Salt okunur
Kapsam
Kapsam, bu birleştirilmiş listeyi hangi hesapların kullanabileceğini tanımlar. Kapsam Hesap olarak ayarlanırsa, birleştirilmiş liste yalnızca belirtilen bir hesaptaki kampanyalar ve reklam gruplarıyla ilişkilendirilebilir (Üst Kimlik). Kapsam Müşteri olarak ayarlandıysa, birleştirilmiş liste müşterinin tüm hesaplarında kampanyalar ve reklam gruplarıyla ilişkilendirilebilir.
Ekle: Gerekli
Güncelleştirme: Salt okunur. Kapsamı değiştiremezsiniz.
Silmek: Salt okunur
Durum
Birleştirilmiş liste durumu.
Olası değerler Etkin veya Silinmiş değerlerdir.
Ekle: Isteğe bağlı. Varsayılan değer Etkin'dir.
Güncelleştirme: Salt okunur
Silmek: Gerekli. Durum , Silinmiş olarak ayarlanmalıdır.
Desteklenen Kampanya Türleri
Bu birleştirilmiş listeyi 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: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur