gösterim tabanlı yeniden pazarlama listesi kaydı - toplu

Toplu bir dosyaya indirilebilen ve karşıya yüklenebilecek gösterim tabanlı bir yeniden pazarlama listesi tanımlar.

DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine ImpressionBasedRemarketingLists'inDownloadEntity değerini ekleyerek hesaptaki tüm Gösterim Tabanlı Yeniden Pazarlama Listesi 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 gösterim tabanlı yeniden pazarlama listesi ekler.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,Audience,Impression Campaign Id,Impression Ad Group Id,Entity Type
Format Version,,,,,,6.0,,,,,,
Impression Based Remarketing List,Active,-10,ParentIdHere,ClientIdGoesHere,,,New impression based remarketing list description,30,Account,Impression Based Remarketing List Name,CampaignIdHere,AdGroupIdHere,AdGroup
Impression Based Remarketing List,Active,-11,ParentIdHere,ClientIdGoesHere,,,New impression based remarketing list description,30,Account,Impression Based Remarketing List Name1,CampaignIdHere,,Campaign

.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 BulkImpressionBasedRemarketingList nesnesini karşıya yüklemek ve indirmek için BulkServiceManager'ı kullanarak zaman kazanabilirsiniz.

var uploadEntities = new List<BulkEntity>();

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

    // Map properties in the Bulk file to the 
    // ImpressionBasedRemarketingList object of the Campaign Management service.
    ImpressionBasedRemarketingList = new ImpressionBasedRemarketingList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New Impression Based Remarketing List",
        // 'Id' column header in the Bulk file
        Id = impressionBasedRemarketingListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Impression Based Remarketing List" + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // 'Impression Ad Group Id' column header in the Bulk file
        AdGroupId = AdGroupIdHere,
        // 'Impression Campaign Id' column header in the Bulk file
        CampaignId = CampaignIdHere,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
        // 'Entity Type' column header in the Bulk file
        EntityType = ImpressionBasedEntityType.AdGroup
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkImpressionBasedRemarketingList);

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

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

Gösterim Tabanlı Yeniden Pazarlama Listesi 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
• Varlık Türü
• Kimliği
• Gösterim Reklam Grubu Kimliği
• Gösterim Kampanyası Kimliği
• Üyelik Süresi
• Değiştirme Zamanı
• Üst Kimlik
• Kapsam
• Durum
• Desteklenen Kampanya Türleri

Hedef kitle

gösterim tabanlı yeniden pazarlama listesinin 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.

Örneğin gösterim tabanlı yeniden pazarlama listesi üyelik süresini, kuralını veya etiket tanımlayıcısını ekler veya güncelleştirirseniz, izleyici oluşturulurken bu özellik 24 saate kadar boş kalır.

gösterim tabanlı yeniden pazarlama listesiyle ilişkilendirilmiş UET etiketi Doğrulanmamış veya Etkin Değil durumundaysa bu özellik boş olur çünkü gösterim tabanlı yeniden pazarlama listesi web sitenizden listeyi oluşturmak için gereken 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

gösterim tabanlı yeniden pazarlama listesinin açıklaması. Bu gösterim tabanlı yeniden pazarlama listesiyle 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

Varlık Türü

Bu varlık türü, kullanıcıların bir reklamı nasıl görüntülemiş olduğunu temel alır. Gösterim tabanlı bir yeniden pazarlama listesi oluştururken varlık türünü belirtmeniz gerekir. Olası değerler AdGroup veya Kampanya'dı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

Kimlik

gösterim tabanlı yeniden pazarlama listesinin sistem tarafından oluşturulan tanımlayıcısı.

Eklemek: Salt okunur
Güncelleştirmek: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

Gösterim Reklam Grubu Kimliği

AdGroupId, gösterim tabanlı yeniden pazarlama listesini oluşturmak için kullanılır.

Eklemek: Varlık Türü AdGroup ise, bu Gerekli'dir. Varlık Türü Kampanya ise, bu boş olur.
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Gösterim Kampanyası Kimliği

Gösterim tabanlı yeniden pazarlama listesini oluşturmak için kullanılan CampaignId.

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

Üyelik Süresi

Gösterim tabanlı bir yeniden pazarlama listesi oluşturduğunuzda, Listenize kişi eklemek için Microsoft Advertising'in gösterim tabanlı yeniden pazarlama listesi tanımınızla 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 30 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.

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

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 gösterim tabanlı yeniden pazarlama listenize 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, gösterim tabanlı yeniden pazarlama listesine kimlerin ekleneceğini belirler.

PageVisitors Kural Şablonu

PageVisitors kuralı için bir veya daha fazla kural öğesi grubu eklemeniz gerekir.

Normal form konjonktürel (CNF) ise, ilk olarak mantıksal OR işleci kullanılarak aynı sayfaya ait kural öğesi koşulları birleştirilir. Ardından, kural öğesi grupları listesindeki her sonuç mantıksal AND işleci kullanılarak birleştirilir. Başka bir deyişle, tüm kural öğesi gruplarında belirtilen kural öğesi koşullarından herhangi biri karşılanırsa kullanıcı gösterim tabanlı yeniden pazarlama listenize eklenir.

• Kural 1 VE Kural 2
• (Kural 1 VEYA Kural 2) VE Kural 3
• (Kural 1 VEYA Kural 2) AND (Kural 3 VEYA Kural 4)

Normal form ayrık ise (DNF), ilk olarak mantıksal AND işleci kullanılarak aynı sayfaya ait kural öğesi koşulları 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ı gösterim tabanlı yeniden pazarlama listenize eklenir.

• Kural 1 VEYA Kural 2
• (Kural 1 VE Kural 2) VEYA Kural 3
• (Kural 1 VE Kural 2) VEYA (Kural 3 VE Kural 4)

DNF değerlendirmesi örneği iç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ıların hangilerinin gösterim tabanlı yeniden pazarlama listesine ekleneceğini belirler.

PageVisitorsWhoDidNotVisitAnotherPage Kural Şablonu

Yeniden pazarlama kuralları, gösterim tabanlı yeniden pazarlama listenize 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 gösterim tabanlı yeniden pazarlama listenize 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ıların hangilerinin gösterim tabanlı yeniden pazarlama listesine ekleneceğini belirler.

PageVisitorsWhoVisitedAnotherPage Kural Şablonu

Yeniden pazarlama kuralları, gösterim tabanlı yeniden pazarlama listenize 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 grubu koşullarından herhangi biri karşılanırsa ve başka bir kural öğesi grubu koşulu karşılanırsa ziyaretçi gösterim tabanlı yeniden pazarlama listenize 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ıların hangilerinin gösterim tabanlı yeniden pazarlama listesine ekleneceğini belirler.

Kapsam

Kapsam, hangi hesapların bu gösterim tabanlı yeniden pazarlama listesini kullanabileceğini tanımlar. Kapsam Hesap olarak ayarlanırsa, gösterim tabanlı yeniden pazarlama listesi yalnızca belirtilen bir hesaptaki kampanyalar ve reklam gruplarıyla ilişkilendirilebilir (Ebeveyn Kimliği). Kapsam Müşteri olarak ayarlanırsa, gösterim tabanlı yeniden pazarlama listesi tüm müşteri hesaplarında kampanyalar ve reklam gruplarıyla ilişkilendirilebilir.

Eklemek: Gerekli
Güncelleştirmek: Salt okunur. Kapsamı değiştiremezsiniz.
Silmek: Salt okunur

Durum

gösterim tabanlı yeniden pazarlama listesi 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 gösterim tabanlı yeniden pazarlama listesini 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