Ürün Hedef Kitle kaydı - Toplu
Toplu bir dosyada indirilebilen ve karşıya yüklenebilecek bir ürün hedef kitlesini tanımlar.
Not
Dinamik yeniden pazarlama listeleri daha önce Microsoft Advertising'te ürün hedef kitleleri olarak biliniyordu. Microsoft Advertising kullanıcı arabiriminde "Dinamik yeniden pazarlama listesi" ifadesini görürsünüz, ancak hataya neden olan değişiklikleri önlemek için API nesneleri hala "ürün hedef kitlesi" olarak adlandırılır.
Dinamik yeniden pazarlama listeleri, müşterileri web sitenizde baktıklarına, değerlendirdiklerine veya zaten satın aldıkları ürünlere göre belirli ürünlerle eşleştirmektedir. Dinamik yeniden pazarlama listelerini hem arama kampanyalarında hem de hedef kitle kampanyalarında kullanabilirsiniz (henüz herkesin hedef kitle kampanyaları yok).
Dinamik yeniden pazarlama listeleri, hem Alışveriş kampanyalarıyla hem de akış tabanlı Hedef Kitle kampanyalarıyla, örneğin Microsoft Merchant Center mağaza kimliğinden yararlanan kampanyalarla en iyi şekilde çalışır.
Önemli
web sitenizdeki UET Etiket Kimliğine karşılık gelen betiği ve ecomm_pagetype
parametrelerini içerecek ecomm_prodid
şekilde düzenlediğinizden emin olun.
ecomm_prodid parametresi, sayfadaki ürünün ürün kimliğidir. Her öğe için benzersizdir ve ürün akışınızdaki kimlik veya item_group_id özniteliğiyle eşleşmelidir. Yalnızca sayısal ve alfasayısal (kısa çizgi dahil) karakterler ve en fazla 50 karakter.
ecomm_pagetype parametresi, kullanıcının ziyaret etmiş olduğu sayfa türünü tanımlar. Geçerli seçenekler: home, searchresults, category, product, cart, purchase, other.
window.uetq = window.uetq || [];
window.uetq.push('event', '', {'ecomm_prodid': 'REPLACE_WITH_PRODUCT_ID', 'ecomm_pagetype': 'REPLACE_WITH_PAGE_TYPE'});
İ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 ProductAudiences'ınDownloadEntity değerini ekleyerek hesaptaki tüm Product Audience 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 ürün hedef kitlesi ekler.
Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,UET Tag Id,Audience,Product Audience Type,Supported Campaign Types
Format Version,,,,,,6.0,,,,,,,
Product Audience,Active,-10,ParentIdHere,ClientIdGoesHere,,,New product audience,30,Account,TagIdHere,My Product Audience,GeneralVisitors,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 BulkProductAudience nesnesini karşıya yükleyip indirebilirsiniz.
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkProductAudience
var bulkProductAudience = new BulkProductAudience
{
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// ProductAudience object of the Campaign Management service.
ProductAudience = new ProductAudience
{
// 'Audience Network Size' column header in the Bulk file
AudienceNetworkSize = null,
// 'Description' column header in the Bulk file
Description = "New product audience",
// 'Id' column header in the Bulk file
Id = productAudienceIdKey,
// 'Membership Duration' column header in the Bulk file
MembershipDuration = 30,
// 'Audience' column header in the Bulk file
Name = "My Product Audience",
// 'Parent Id' column header in the Bulk file
ParentId = accountIdKey,
// 'Product Audience Type' column header in the Bulk file
ProductAudienceType = ProductAudienceType.GeneralVisitors,
// '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,
// 'UET Tag Id' column header in the Bulk file
TagId = tagIdKey
},
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkProductAudience);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
Bir Ürün Hedef Kitlesi kaydı için, Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları kullanılabilir.
- Hedef kitle
- Hedef Kitle Ağ Boyutu
- İzleyici Arama Boyutu
- İstemci Kimliği
- Açıklama
- Kimliği
- Üyelik Süresi
- Değiştirme Zamanı
- Üst Kimlik
- Ürün Hedef Kitle Türü
- Kapsam
- Durum
- Desteklenen Kampanya Türleri
- UET Etiket Kimliği
Hedef kitle
Ürün hedef kitlesinin adı.
Ad en fazla 128 karakter içerebilir.
Eklemek: Gerekli
Güncelleştirmek: Opsiyonel. 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.
Eklemek: Salt okunur
Güncelleştirmek: 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 ürün hedef kitlesi üyelik süresini, kuralını veya etiket tanımlayıcısını ekler veya güncelleştirirseniz, hedef kitle oluşturulurken 24 saate kadar boş kalır.
Ürün hedef kitlesiyle ilişkilendirilmiş UET etiketi Doğrulanmamış veya Etkin Değil durumundaysa bu özellik boş olur, çünkü ürün hedef kitlesi web sitenizden listeyi oluşturmak için ihtiyaç duyduğu müşteri bilgilerini alamaz.
Eklemek: Salt okunur
Güncelleştirmek: 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.
Eklemek: Opsiyonel
Güncelleştirmek: Opsiyonel
Silmek: Salt okunur
Açıklama
Ürün hedef kitlesinin açıklaması. Bu ürün hedef kitlesiyle 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.
Eklemek: Opsiyonel
Güncelleştirmek: Opsiyonel. 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
Ürün hedef kitlesinin sistem tarafından oluşturulan tanımlayıcısı.
Eklemek: Salt okunur
Güncelleştirmek: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli
Üyelik Süresi
Bir ürün hedef kitlesi oluşturduğunuzda, Microsoft Advertising'in listenize kişi eklemek için ürün hedef kitlenizin tanımıyla eşleşen eylemleri ne kadar geriye araması gerektiğini belirtebilirsiniz.
En düşük süre 1 gündür ve izin verilen en uzun süre 180 gündür.
Eklemek: Opsiyonel
Güncelleştirmek: Opsiyonel. 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.
Eklemek: Salt okunur
Güncelleştirmek: 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.
Eklemek: Opsiyonel
Güncelleştirmek: Salt okunur. Üst kimliği değiştiremezsiniz.
Silmek: Salt okunur
Ürün Hedef Kitle Türü
Ürün hedef kitlenize kimlerin ekleneceğini belirler.
Olası değerler GeneralVisitors, ProductSearchers, ProductViewers, ShoppingCartAbandoners ve PastBuyers'tır.
Eklemek: Gerekli
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur
Kapsam
Kapsam, bu ürün hedef kitlesini hangi hesapların kullanabileceğini tanımlar. Kapsam Hesap olarak ayarlanırsa, ürün hedef kitlesi yalnızca belirtilen bir hesaptaki kampanyalar ve reklam gruplarıyla ilişkilendirilebilir (Ebeveyn Kimliği). Kapsam Müşteri olarak ayarlanırsa, ürün hedef kitlesi müşterinin tüm hesaplarındaki tüm kampanyalar ve reklam gruplarıyla ilişkilendirilebilir.
Eklemek: Gerekli
Güncelleştirmek: Salt okunur. Kapsamı değiştiremezsiniz.
Silmek: Salt okunur
Durum
Ürün hedef kitlesi durumu.
Olası değerler Etkin veya Silinmiş değerlerdir.
Eklemek: Opsiyonel. Varsayılan değer Etkin'dir.
Güncelleştirmek: Salt okunur
Silmek: Gerekli. Durum , Silinmiş olarak ayarlanmalıdır.
Desteklenen Kampanya Türleri
Bu ürün hedef kitlesini 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.
Eklemek: Salt okunur
Güncelleştirmek: Salt okunur
Silmek: Salt okunur
UET Etiket Kimliği
Ürün hedef kitlesiyle birlikte kullanılan Evrensel Olay İzleme (UET) etiketinin Microsoft Advertising tanımlayıcısı.
Önemli
ve pagetype
parametrelerini içerecek şekilde web sitenizdeki UET betiğini düzenlemeyi prodid
unutmayın.
window.uetq = window.uetq || [];
window.uetq.push({'prodid': 'PRODUCT_ID', 'pagetype': 'PAGE_TYPE'});
Eklemek: Gerekli
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur
CustomEvents Kural Şablonu
CustomEvents kuralı için, aşağıdaki koşullu olay işleç çiftlerinden birini veya daha fazlasını eklemeniz gerekir: (ActionOperator ve Action), (CategoryOperator ve Category), (LabelOperator ve Label), (ValueOperator ve Value). Birden fazla koşul belirtilirse, koşullar mantıksal AND işleci kullanılarak birleştirilir. Başka bir deyişle, ziyaretçi yalnızca belirtilen tüm kural koşulları karşılandığında ürün hedef kitlenize eklenir.
Örneğin, aşağıdaki özel olayların toplu dosyada mantıksal bir ifade olarak ayarlandığını düşünelim:
CustomEvents(Category Equals video) ve (Action Equals play) ve (Label Equals trailer) ve (Value Equals 5)
Mantıksal ifadenin değerlendirilmesi, ürün hedef kitlesine kimlerin ekleneceğini belirler.
PageVisitors Kural Şablonu
PageVisitors kuralı için bir veya daha fazla kural öğesi grubu eklemeniz gerekir. Her kural öğesi grubuyla, aynı sayfanın kural öğesi koşulları mantıksal AND işleci kullanılarak birleştirilir. Ardından, kural öğesi grupları listesindeki her sonuç mantıksal OR işleci kullanılarak birleştirilir. Başka bir deyişle, kural öğesi gruplarından herhangi birinde belirtilen tüm kural öğesi koşulları karşılanırsa kullanıcı ürün hedef kitlenize eklenir.
Örneğin, aşağıdaki kural öğesi gruplarının toplu dosyada mantıksal bir ifade olarak ayarlandığını düşünelim:
PageVisitors((Url Contains X) ve (ReferrerUrl DoesNotContain Z)) veya ((Url DoesNotBeginWith Y)) veya ((ReferrerUrl Equals Z))
Mantıksal ifadenin değerlendirilmesi, aşağıdaki örnek kullanıcılardan hangisinin ürün hedef kitlesine ekleneceğini belirler.
Kullanıcı | Url Ziyaret Edildi | Başvuran Url'si | Listeye Eklendi |
---|---|---|---|
Kullanıcı 1 | A |
X | Evet. Mantıksal ifade sonuçlarının True olarak değerlendirilmesi. ((Url X içerir) ve (ReferrerUrl DoesNotContain Z)) veya ((Url DoesNotBeginWith Y)) veya ((ReferrerUrl Eşittir Z)) (Yanlış ve Doğru) veya (Doğru) veya (Yanlış) Yanlış, Doğru veya Yanlış True |
Kullanıcı 2 | B |
E | Hayır. Mantıksal ifade sonuçlarının False olarak değerlendirilmesi. ((Url X içerir) ve (ReferrerUrl DoesNotContain Z)) veya ((Url DoesNotBeginWith Y)) veya ((ReferrerUrl Eşittir Z)) (Yanlış ve Doğru) veya (Yanlış) veya (Yanlış) Yanlış veya Yanlış ya da Yanlış False |
Kullanıcı 3 | C |
Z | Evet. Mantıksal ifade sonuçlarının True olarak değerlendirilmesi. ((Url X içerir) ve (ReferrerUrl DoesNotContain Z)) veya ((Url DoesNotBeginWith Y)) veya ((ReferrerUrl Eşittir Z)) (Yanlış ve Yanlış) veya (Doğru) veya (Doğru) Yanlış, Doğru veya Doğru True |
PageVisitorsWhoDidNotVisitAnotherPage Kural Şablonu
Yeniden pazarlama kuralları, ürün hedef kitlenize kimlerin ekleneceğini belirlemek için kullanılan koşullardır. PageVisitorsWhoDidNotVisitAnotherPage kuralı için, ziyaret edilen sayfa (IncludeRuleItemGroups) için bir veya daha fazla kural öğesi grubu eklemeniz ve sayfa için ziyaret edilmemesi gereken bir veya daha fazla kural öğesi grubu da eklemeniz gerekir (ExcludeRuleItemGroups).
IncludeRuleItemGroups içindeki her kural öğesi grubu için, aynı sayfanın kural öğesi koşulları mantıksal AND işleci kullanılarak birleştirilir. Ardından, kural öğesi grupları listesindeki her sonuç mantıksal OR işleci kullanılarak birleştirilir.
ExcludeRuleItemGroups içindeki her kural öğesi grubu için de benzer şekilde, aynı sayfaya ait kural öğesi koşulları mantıksal AND işleci kullanılarak birleştirilir. Ardından, kural öğesi grupları listesindeki her sonuç mantıksal OR işleci kullanılarak birleştirilir. Son olarak, mantıksal NOT işleci dışlama kuralı öğe gruplarının toplu sonucuna uygulanır.
Başka bir deyişle, dahil etme kural öğesi grubu koşullarından herhangi biri karşılanırsa ve hariç tutma kuralı öğesi grubu koşullarının hiçbiri karşılanmazsa ziyaretçi ürün hedef kitlenize eklenir.
Örneğin, aşağıdaki kural öğesi gruplarının toplu dosyada mantıksal bir ifade olarak ayarlandığını düşünelim:
(((Url Contains X) and (ReferrerUrl DoesNotContain Z)) veya ((Url DoesNotBeginWith Y)) veya ((ReferrerUrl Equals Z))) ve not (((Url BeginsWith A) ve (ReferrerUrl BeginsWith B)) veya ((Url Contains C))) değil
Mantıksal ifadenin değerlendirilmesi, aşağıdaki örnek kullanıcılardan hangisinin ürün hedef kitlesine ekleneceğini belirler.
Kullanıcı | Url Ziyaret Edildi | Başvuran Url'si | Listeye Eklendi |
---|---|---|---|
Kullanıcı 1 | A |
X | Evet. Mantıksal ifade sonuçlarının True olarak değerlendirilmesi. (((Url Contains X) and (ReferrerUrl DoesNotContain Z)) veya ((Url DoesNotBeginWith Y)) veya ((ReferrerUrl Equals Z))) ve not (((Url BeginsWith A) ve (ReferrerUrl BeginsWith B)) veya ((Url Contains C))) değil ((Yanlış ve Doğru) veya (Doğru) veya (Yanlış)) değil ((Doğru ve Yanlış) veya (Yanlış)) (Yanlış veya Doğru veya Yanlış) değil (Yanlış veya Yanlış) Doğru ve Yanlış değil True |
Kullanıcı 2 | B |
E | Evet. Mantıksal ifade sonuçlarının True olarak değerlendirilmesi. (((Url Contains X) and (ReferrerUrl DoesNotContain Z)) veya ((Url DoesNotBeginWith Y)) veya ((ReferrerUrl Equals Z))) ve not (((Url BeginsWith A) ve (ReferrerUrl BeginsWith B)) veya ((Url Contains C))) değil ((Yanlış ve Doğru) veya (Doğru) veya (Yanlış)) değil ((Yanlış ve Yanlış) veya (Yanlış)) (Yanlış veya Doğru veya Yanlış) değil (Yanlış veya Yanlış) Doğru ve Yanlış değil True |
Kullanıcı 3 | C |
Z | Hayır. Mantıksal ifade sonuçlarının False olarak değerlendirilmesi. (((Url Contains X) and (ReferrerUrl DoesNotContain Z)) veya ((Url DoesNotBeginWith Y)) veya ((ReferrerUrl Equals Z))) ve not (((Url BeginsWith A) ve (ReferrerUrl BeginsWith B)) veya ((Url Contains C))) değil ((Yanlış ve Yanlış) veya (Doğru) veya (Doğru)) değil ((Yanlış ve Yanlış) veya (Doğru)) (Yanlış veya Doğru veya Doğru) değil (Yanlış veya Doğru) Doğru değil Doğru False |
PageVisitorsWhoVisitedAnotherPage Kural Şablonu
Yeniden pazarlama kuralları, ürün hedef kitlenize kimlerin ekleneceğini belirlemek için kullanılan koşullardır. PageVisitorsWhoVisitedAnotherPage kuralı için, ziyaret edilen sayfa (RuleItemGroups) için bir veya daha fazla kural öğesi grubu eklemeniz ve ayrıca ziyaret edilmiş olması gereken başka bir sayfa için bir veya daha fazla kural öğesi grubu eklemeniz gerekir (AnotherRuleItemGroups).
RuleItemGroups içindeki her kural öğesi grubu için, aynı sayfanın kural öğesi koşulları mantıksal AND işleci kullanılarak birleştirilir. Ardından, kural öğesi grupları listesindeki her sonuç mantıksal OR işleci kullanılarak birleştirilir.
Benzer şekilde , AnotherRuleItemGroups içindeki her kural öğesi grubu için de aynı şekilde, aynı sayfaya ait kural öğesi koşulları mantıksal AND işleci kullanılarak birleştirilir. Ardından, kural öğesi grupları listesindeki her sonuç mantıksal OR işleci kullanılarak birleştirilir.
Başka bir deyişle, kural öğesi grup koşullarından herhangi biri karşılanırsa ve başka bir kural öğesi grubu koşulu karşılanırsa ziyaretçi ürün hedef kitlenize eklenir.
Örneğin, aşağıdaki kural öğesi gruplarının toplu dosyada mantıksal bir ifade olarak ayarlandığını düşünelim:
(((Url X içerir) ve (ReferrerUrl NotEquals Z)) veya ((Url DoesNotBeginWith Y)) veya ((ReferrerUrl Equals Z))) ve (((Url BeginsWith A) ve (ReferrerUrl BeginsWith B)) veya ((Url Contains C))
Mantıksal ifadenin değerlendirilmesi, aşağıdaki örnek kullanıcılardan hangisinin ürün hedef kitlesine ekleneceğini belirler.
Kullanıcı | Url Ziyaret Edildi | Başvuran Url'si | Listeye Eklendi |
---|---|---|---|
Kullanıcı 1 | A |
X | Hayır. Mantıksal ifade sonuçlarının False olarak değerlendirilmesi. (((Url X içerir) ve (ReferrerUrl NotEquals Z)) veya ((Url DoesNotBeginWith Y)) veya ((ReferrerUrl Equals Z))) ve (((Url BeginsWith A) ve (ReferrerUrl BeginsWith B)) veya ((Url Contains C)) ((Yanlış ve Doğru) veya (Doğru) veya (Yanlış)) ve ((Doğru ve Yanlış) veya (Yanlış)) (Yanlış veya Doğru veya Yanlış) ve (Yanlış veya Yanlış) Doğru ve Yanlış False |
Kullanıcı 2 | B |
E | Hayır. Mantıksal ifade sonuçlarının False olarak değerlendirilmesi. (((Url X içerir) ve (ReferrerUrl NotEquals Z)) veya ((Url DoesNotBeginWith Y)) veya ((ReferrerUrl Equals Z))) ve (((Url BeginsWith A) ve (ReferrerUrl BeginsWith B)) veya ((Url Contains C)) ((Yanlış ve Doğru) veya (Doğru) veya (Yanlış)) ve ((Yanlış ve Yanlış) veya (Yanlış)) (Yanlış veya Doğru veya Yanlış) ve (Yanlış veya Yanlış) Doğru ve Yanlış False |
Kullanıcı 3 | C |
Z | Evet. Mantıksal ifade sonuçlarının True olarak değerlendirilmesi. (((Url X içerir) ve (ReferrerUrl NotEquals Z)) veya ((Url DoesNotBeginWith Y)) veya ((ReferrerUrl Equals Z))) ve (((Url BeginsWith A) ve (ReferrerUrl BeginsWith B)) veya ((Url Contains C)) ((Yanlış ve Doğru) veya (Doğru) veya (Doğru)) ve ((Yanlış ve Yanlış) veya (Doğru)) (Yanlış veya Doğru veya Doğru) ve (Yanlış veya Doğru) Doğru ve Doğru True |