以曝光為基礎的重新營銷清單記錄 - 大量

發行項
11/13/2024

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

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

下列大量 CSV 範例會新增以曝光為基礎的重新行銷清單。

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 或 Python 的 Bing Ads SDK ，您可以使用 BulkServiceManager 來節省時間，以上傳和下載 BulkImpressionBasedRemarketingList 物件，而不是直接呼叫服務作業，並撰寫自定義程式代碼來剖析大量檔案中的每個字段。

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();

對於 以曝光為基礎的重新行銷清單 記錄，大量檔案架構中提供下列屬性欄位。

對象
物件網路大小
物件搜尋大小
用戶端識別碼
描述
實體類型
Id
曝光廣告群組標識碼
曝光營銷活動標識碼
成員資格持續時間
修改時間
父項識別碼
Scope
狀態
支援的營銷活動類型

對象

以曝光為基礎的重新營銷清單名稱。

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

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

物件網路大小

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

觀眾必須至少有 300 人，Microsoft廣告才會將其用於優化。

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

物件搜尋大小

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

觀眾必須至少有 300 人，Microsoft廣告才會將其用於優化。

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

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

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

用戶端識別碼

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

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

描述

以曝光為基礎的重新行銷清單描述。使用描述來協助您記住以此曝光型重新行銷清單為目標的物件。

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

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

實體類型

此實體類型是以用戶檢視廣告的方式為基礎。當您建立以曝光為基礎的重新營銷清單時，必須指定實體類型。可能的值為 AdGroup 或 Campaign。

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

識別碼

系統產生的以曝光為基礎的重新行銷清單標識碼。

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

曝光廣告群組標識碼

用來建立以曝光為基礎的重新營銷清單的 AdGroupId。

加：如果實體類型是 AdGroup，則這是必要專案。如果 [實體類型] 是 [營銷活動]，則這是空的。
更新： 自選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

曝光營銷活動標識碼

用來建立以曝光為基礎的重新行銷清單的 CampaignId。

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

成員資格持續時間

當您建立以曝光為基礎的重新行銷清單時，您可以指定廣告應該尋找符合以曝光為基礎的重新行銷清單定義的動作，以將人員新增至清單的時間Microsoft。

最小持續時間為 1 天，允許的持續時間上限為 30 天。

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

修改時間

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

注意事項

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

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

父項識別碼

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

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

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 等於 Z) ) (False 和 True) 或 (True) 或 (False) False 或 True 或 False True
使用者 2	B	Y	不能。將邏輯表達式結果評估為 False。 ( (URL 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl 等於 Z) ) (False 和 True) 或 (False) 或 (False) False 或 False 或 False False
使用者 3	C	Z	是。將邏輯表達式結果評估為 True。 ( (URL 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl 等於 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 等於 Z) ) ) ，而非 ( ( (URL StartsWith A) 和 (ReferrerUrl StartsWith B) ) 或 ( (URL 包含 C) ) )

評估邏輯表達式會決定下列哪一個範例使用者會新增至以曝光為基礎的重新行銷清單。

使用者	流覽過的URL	查閱者 URL	已新增至清單
使用者 1	A	X	是。將邏輯表達式結果評估為 True。 ( ( (URL 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl 等於 Z) ) ) ，而非 ( ( (URL StartsWith A) 和 (ReferrerUrl StartsWith B) ) 或 ( (URL 包含 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 等於 Z) ) ) ，而非 ( ( (URL StartsWith A) 和 (ReferrerUrl StartsWith B) ) 或 ( (URL 包含 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 等於 Z) ) ) ，而非 ( ( (URL StartsWith A) 和 (ReferrerUrl StartsWith B) ) 或 ( (URL 包含 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 包含 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 包含 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 包含 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 包含 C) ) ) ( (False 和 True) 或 (True) 或 (True) ) 和 ( (False 和 False) 或 (True) ) (False 或 True 或 True) 和 (False 或 True) True 和 True True

範圍

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

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

狀態

以曝光為基礎的重新營銷清單狀態。

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

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

支援的營銷活動類型

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

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

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

共用方式為

以曝光為基礎的重新營銷清單記錄 - 大量

對象

物件網路大小

物件搜尋大小

用戶端識別碼

描述

實體類型

識別碼

曝光廣告群組標識碼

曝光營銷活動標識碼

成員資格持續時間

修改時間

父項識別碼

CustomEvents 規則範本

PageVisitors 規則範本

PageVisitorsWhoDidNotVisitAnotherPage 規則範本

PageVisitorsWhoVisitedAnotherPage 規則範本

範圍

狀態

支援的營銷活動類型

意見反應

其他資源