Aracılığıyla paylaş


Ü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

Ü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