重新行銷清單記錄 - 大量

發行項
12/21/2023

定義可在大量檔案中下載並上傳的重新行銷清單。

注意事項

如果您是試驗參與者，Microsoft Advertising 會自動為重新行銷清單產生類似的物件。您無法為重新行銷清單建立或編輯類似的物件。說過，您可以新增和刪除類似的重新行銷清單關聯和排除專案。如果您刪除來源重新行銷清單，則也會刪除類似的物件。如果類似的物件與行銷活動或廣告群組相關聯，則您無法刪除來源重新行銷清單。如需詳細資訊，請參閱類似的重新行銷清單。

提示

如需物件的概觀和詳細資訊，請參閱物件 API 技術指南。

您可以在DownloadCampaignsByAccountIds或DownloadCampaignsByCampaignIds服務要求中包含RemarketingLists的DownloadEntity值，以下載帳戶中的所有重新行銷清單記錄。此外，下載要求必須包含 EntityData 範圍。如需大量服務的詳細資訊，包括最佳做法，請參閱大量下載和上傳。

下列大量 CSV 範例會新增重新行銷清單。

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,UET Tag Id,Audience,Remarketing Rule
Format Version,,,,,,6.0,,,,,,
Remarketing List,Active,-10,ParentIdHere,ClientIdGoesHere,,,New list with CustomEventsRule,30,Account,TagIdHere,Remarketing List with CustomEventsRule,CustomEvents(Action Equals play) and (Category Equals video) and (Label Equals trailer) and (Value Equals 5.00)

如果您使用適用于 .NET、JAVA 或 Python 的 Bing Ads SDK ，您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkRemarketingList 物件，而不是直接呼叫服務作業，並撰寫自訂程式碼來剖析大量檔案中的每個欄位。

var uploadEntities = new List<BulkEntity>();

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

    // Map properties in the Bulk file to the 
    // RemarketingList object of the Campaign Management service.
    RemarketingList = new RemarketingList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New list with CustomEventsRule",
        // 'Id' column header in the Bulk file
        Id = remarketingListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Remarketing List with CustomEventsRule " + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Remarketing Rule' column header in the Bulk file
        Rule = new CustomEventsRule
        {
            // The rule definition is translated to the following logical expression: 
            // CustomEvents(Category Equals video) and (Action Equals play) and (Label Equals trailer) 
            // and (Value Equals 5)
            Action = "play",
            ActionOperator = StringOperator.Equals,
            Category = "video",
            CategoryOperator = StringOperator.Equals,
            Label = "trailer",
            LabelOperator = StringOperator.Equals,
            Value = 5.00m,
            ValueOperator = NumberOperator.Equals,
        },
        // '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(bulkRemarketingList);

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

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

針對 重新行銷清單 記錄，大量檔案架構中提供下列屬性欄位。

對象
物件網路大小
物件搜尋大小
用戶端識別碼
描述
Id
成員資格持續時間
修改時間
父項識別碼
重新行銷規則
Scope
狀態
支援的行銷活動類型
UET 標籤識別碼

對象

重新行銷清單的名稱。

名稱最多可以包含 128 個字元。

添加： 必填
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

物件網路大小

在物件網路中，屬於此物件之作用中成員的人員總數。這可讓您瞭解您可以將多少物件網路使用者設為目標。

物件必須至少有 300 人，Microsoft Advertising 才會將它用於優化。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

物件搜尋大小

在搜尋網路中，屬於此物件之作用中成員的人員總數。這可讓您瞭解您可以將多少搜尋使用者設為目標。

物件必須至少有 300 人，Microsoft Advertising 才會將它用於優化。

此屬性在建立物件時最多會是空的 24 小時，例如，如果您新增或更新重新行銷清單成員資格持續時間、規則或標籤識別碼。

如果與重新行銷清單相關聯的 UET 標籤的狀態為 [未驗證] 或 [非使用中]，則此屬性會是空的，因為重新行銷清單無法從您的網站接收到需要建置清單的客戶資訊。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

用戶端識別碼

用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。它可以是長度上限為 100 的任何有效字串。

添加： 選
更新： 選
刪除： 唯讀

說明

重新行銷清單的描述。使用描述可協助您記住此重新行銷清單的目標物件。

描述最多可以包含 1,024 個字元。

添加： 選
更新： 選。如果未設定更新的值，則此設定不會變更。如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。
刪除： 唯讀

識別碼

系統產生的重新行銷清單識別碼。

添加： 唯讀
更新： 唯讀和必要
刪除： 唯讀和必要

成員資格持續時間

當您建立重新行銷清單時，您可以指定 Microsoft Advertising 應該尋找符合您重新行銷清單定義的動作，以便將人員新增至您的清單。

Mimimum 持續時間為 1 天，而允許的持續時間上限為 180 天。

添加： 選
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

修改時間

上次更新實體的日期和時間。值為國際標準時間 (UTC)。

注意事項

日期和時間值會反映伺服器上的日期和時間，而不是用戶端。如需日期和時間格式的相關資訊，請參閱基本 XML 資料類型中的 dateTime 專案。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

父項識別碼

系統產生的帳戶或客戶識別碼。如果 [範圍] 設定為 [ 帳戶]，則這是帳戶識別碼，否則為客戶識別碼。

添加： 選
更新： 唯讀。您無法變更父識別碼。
刪除： 唯讀

重新行銷規則

規則範本包含用來判斷要將誰新增至重新行銷清單的條件。

您可以選擇四種規則類型之一，以以不同的物件為目標： CustomEventsRule、 PageVisitorsRule、 PageVisitorsWhoDidNotVisitAnotherPageRule和 PageVisitorsWhoVisitedAnotherPageRule。如需大量檔案中每個規則格式的詳細資訊，請參閱下面的 CustomEvents、 PageVisitors、 PageVisitorsWhoDidNotVisitAnotherPage和 PageVisitorsWhoVisitedAnotherPage 規則範本備註一節。

添加： 必填
更新： 選。如果未設定更新的值，則此設定不會變更。如果您想要保留任何先前的規則專案，則必須在更新期間再次明確地設定它們。您可以選擇在更新期間變更規則的類型。
刪除： 唯讀

CustomEvents 規則範本

針對 CustomEvents 規則，您必須包含下列一或多個條件式事件運算子配對： (ActionOperator 和 Action) 、 (CategoryOperator 和 Category) 、 (LabelOperator 和 Label) 、 (ValueOperator 和 Value) 。如果指定多個條件，則會使用邏輯 AND 運算子來聯結條件。換句話說，只有在符合所有指定的規則條件時，訪客才會新增至您的重新行銷清單。

例如，假設下列自訂事件會設定為大量檔案中的邏輯運算式：

CustomEvents (Category Equals video) and (Action Equals play) and (Label Equals trailer) and (Value Equals 5)

邏輯運算式的評估會決定要將誰新增至重新行銷清單。

PageVisitors 規則範本

針對 PageVisitors 規則，您必須包含一或多個規則專案群組。

重要事項

在 2021 年日曆年度，我們新增了對聯結一般表單 (CNF) 的支援。先前 Microsoft Advertising 僅支援與 DNF) (分離一般表單。新頁面訪客規則的預設一般表單會維持 DNF。不過，您必須確定您的應用程式可以適當地讀取及區分 CNF 和 DNF。您的應用程式不應該再假設規則是分離的。

如果一般表單是聯結 (CNF) ，則會先使用邏輯 OR 運算子聯結相同頁面的規則專案條件。然後，規則專案群組清單中的每個結果都會使用邏輯 AND 運算子聯結。換句話說，如果符合所有規則專案群組內任何指定的規則專案條件，使用者就會新增至您的重新行銷清單。

規則 1 和規則 2
(規則 1 或規則 2) 和規則 3
(規則 1 或規則 2) 和 (規則 3 或規則 4)

如果一般表單與 DNF) (分離，則會先使用邏輯 AND 運算子聯結相同頁面的規則專案條件。然後，規則專案群組清單中的每個結果都會使用邏輯 OR 運算子聯結。換句話說，如果符合任何一個規則專案群組內的所有指定規則專案條件，使用者就會新增至您的重新行銷清單。

規則 1 或規則 2
(規則 1 和規則 2) 或規則 3
(規則 1 和規則 2) 或 (規則 3 和規則 4)

如需 DNF 評估的範例，假設下列規則專案群組已設定為大量檔案中的邏輯運算式：

PageVisitors ( (Url 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl Equals Z) )

邏輯運算式的評估會決定下列哪一個範例使用者會新增至重新行銷清單。

使用者	流覽過的 URL	查閱者 URL	已新增至清單
使用者 1	A	X	是的。將邏輯運算式結果評估為 True。 ( (Url 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl Equals Z) ) (False 和 True) 或 (True) 或 (False) False 或 True 或 False True
使用者 2	B	Y	不能。將邏輯運算式結果評估為 False。 ( (Url 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl Equals Z) ) (False 和 True) 或 (False) 或 (False) False 或 False 或 False False
使用者 3	C	Z	是的。將邏輯運算式結果評估為 True。 ( (Url 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl Equals Z) ) (False 和 False) 或 (True) 或 (True) False 或 True 或 True True

PageVisitorsWhoDidNotVisitAnotherPage 規則範本

重新行銷規則是用來判斷要將誰新增至重新行銷清單的條件。針對 PageVisitorsWhoDidNotVisitAnotherPage 規則，您必須包含一或多個流覽 (IncludeRuleItemGroups) 流覽之頁面的規則專案群組，而且您也必須包含一或多個不可流覽過之頁面的規則專案群組 (ExcludeRuleItemGroups) 。

對於 IncludeRuleItemGroups內的每個規則專案群組，相同頁面的規則專案條件會使用邏輯 AND 運算子聯結。然後，規則專案群組清單中的每個結果都會使用邏輯 OR 運算子聯結。

同樣地， 對於 ExcludeRuleItemGroups內的每個規則專案群組，相同頁面的規則專案條件會使用邏輯 AND 運算子聯結。然後，規則專案群組清單中的每個結果都會使用邏輯 OR 運算子聯結。最後，邏輯 NOT 運算子會套用至排除規則專案群組的匯總結果。

換句話說，如果符合任何包含規則專案群組條件，且未符合任何排除規則專案群組條件，則訪客會新增至您的重新行銷清單。

例如，假設下列規則專案群組會設定為大量檔案中的邏輯運算式：

( ( (Url 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl Equals Z #C 13) ) and not ( ( (Url StartsWith A) and (ReferrerUrl StartsWith B) ) or ( (Url Contains C) ) )

邏輯運算式的評估會決定下列哪一個範例使用者會新增至重新行銷清單。

使用者	流覽過的 URL	查閱者 URL	已新增至清單
使用者 1	A	X	是的。將邏輯運算式結果評估為 True。 ( ( (Url 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl Equals Z #C 13) ) and not ( ( (Url StartsWith A) and (ReferrerUrl StartsWith B) ) or ( (Url Contains C) ) ) ( (False 和 True) 或 (True) 或 (False) ) ，而不是 ( (True 和 False) 或 (False) ) (False 或 True 或 False) ，且不 (False 或 False) True 且非 False True
使用者 2	B	Y	是的。將邏輯運算式結果評估為 True。 ( ( (Url 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl Equals Z #C 13) ) and not ( ( (Url StartsWith A) and (ReferrerUrl StartsWith B) ) or ( (Url Contains C) ) ) ( (False 和 True) 或 (True) 或 (False) ) ，而不是 ( (False 和 False) 或 (False) ) (False 或 True 或 False) ，且不 (False 或 False) True 且非 False True
使用者 3	C	Z	不能。將邏輯運算式結果評估為 False。 ( ( (Url 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl Equals Z #C 13) ) and not ( ( (Url StartsWith A) and (ReferrerUrl StartsWith B) ) or ( (Url Contains C) ) ) ( (False 和 False) 或 (True) 或 (True) ) 而非 ( (False 和 False) 或 (True) ) (False 或 True 或 True) ，且不 (False 或 True) True 且非 True False

PageVisitorsWhoVisitedAnotherPage 規則範本

重新行銷規則是用來判斷要將誰新增至重新行銷清單的條件。針對 PageVisitorsWhoVisitedAnotherPage 規則，您必須包含一或多個規則專案群組，才能 (RuleItemGroups) 流覽過的頁面，而且您也必須包含另一個頁面的一或多個規則專案群組，該群組必須已流覽 (AnotherRuleItemGroups) 。

針對 RuleItemGroups內的每個規則專案群組，相同頁面的規則專案條件會使用邏輯 AND 運算子聯結。然後，規則專案群組清單中的每個結果都會使用邏輯 OR 運算子聯結。

同樣地， 對於 AnotherRuleItemGroups內的每個規則專案群組，相同頁面的規則專案條件會使用邏輯 AND 運算子聯結。然後，規則專案群組清單中的每個結果都會使用邏輯 OR 運算子聯結。

換句話說，如果符合任何規則專案群組條件，而且符合任何另一個規則專案群組條件，則訪客會新增至您的重新行銷清單。

例如，假設下列規則專案群組會設定為大量檔案中的邏輯運算式：

( ( (Url 包含 X) 和 (ReferrerUrl NotEquals Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl Equals Z) ) ) 和 ( ( (URL StartsWith A) 和 (ReferrerUrl StartsWith B) ) 或 ( (Url Contains C) ) )

邏輯運算式的評估會決定下列哪一個範例使用者會新增至重新行銷清單。

使用者	流覽過的 URL	查閱者 URL	已新增至清單
使用者 1	A	X	不能。將邏輯運算式結果評估為 False。 ( ( (Url 包含 X) 和 (ReferrerUrl NotEquals Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl Equals Z) ) ) 和 ( ( (URL StartsWith A) 和 (ReferrerUrl StartsWith B) ) 或 ( (Url Contains C) ) ) ( (False 和 True) 或 (True) 或 (False) ) 和 ( (True 和 False) 或 (False) ) (False 或 True 或 False) 和 (False 或 False) True 和 False False
使用者 2	B	Y	不能。將邏輯運算式結果評估為 False。 ( ( (Url 包含 X) 和 (ReferrerUrl NotEquals Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl Equals Z) ) ) 和 ( ( (URL StartsWith A) 和 (ReferrerUrl StartsWith B) ) 或 ( (Url Contains C) ) ) ( (False 和 True) 或 (True) 或 (False) ) 和 ( (False 和 False) 或 (False) ) (False 或 True 或 False) 和 (False 或 False) True 和 False False
使用者 3	C	Z	是的。將邏輯運算式結果評估為 True。 ( ( (Url 包含 X) 和 (ReferrerUrl NotEquals Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl Equals Z) ) ) 和 ( ( (URL StartsWith A) 和 (ReferrerUrl StartsWith B) ) 或 ( (Url Contains C) ) ) ( (False 和 True) 或 (True) 或 (True) ) 和 ( (False 和 False) 或 (True) ) (False 或 True 或 True) 和 (False 或 True) True 和 True True

範圍

範圍會定義哪些帳戶可以使用此重新行銷清單。如果範圍設定為 [帳戶]，則重新行銷清單只能與一個指定帳戶內的活動和廣告群組相關聯 (父識別碼) 。如果範圍設定為 [客戶]，則重新行銷清單可以與所有客戶帳戶上的任何行銷活動和廣告群組相關聯。

添加： 必填
更新： 唯讀。您無法變更範圍。
刪除： 唯讀

狀態

重新行銷清單狀態。

可能的值為 [作用中 ] 或 [已刪除]。

添加： 選。預設值為 Active。
更新： 唯讀
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。

支援的行銷活動類型

支援此重新行銷清單之行銷活動類型的分號分隔清單。

支援的值為 Audience、DynamicSearchAds、Search 和 Shopping。未來可能會新增新的行銷活動類型，因此您不應該對一組固定的值採取任何相依性。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

UET 標籤識別碼

與重新行銷清單搭配使用的通用事件追蹤 (UET) 標籤的 Microsoft Advertising 識別碼。

添加： 必填
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

共用方式為

重新行銷清單記錄 - 大量

對象

物件網路大小

物件搜尋大小

用戶端識別碼

說明

識別碼

成員資格持續時間

修改時間

父項識別碼

重新行銷規則

CustomEvents 規則範本

PageVisitors 規則範本

PageVisitorsWhoDidNotVisitAnotherPage 規則範本

PageVisitorsWhoVisitedAnotherPage 規則範本

範圍

狀態

支援的行銷活動類型

UET 標籤識別碼

其他資源