產品物件記錄 - 大量

發行項
12/21/2023

定義可在大量檔案中下載及上傳的產品物件。

注意事項

動態重新行銷清單先前在 Microsoft Advertising 中稱為產品物件。您會在 Microsoft Advertising UI 中看到「動態重新行銷清單」，但為了避免重大變更，API 功能仍然命名為「產品物件」。

動態重新行銷清單會根據客戶在您的網站上查看、考慮或購買的內容，將特定產品與客戶配對。您可以在搜尋活動和物件行銷活動中使用動態重新行銷清單， (並非每個人都有) 的物件活動。

動態重新行銷清單最適合用於購物活動和摘要型物件行銷活動，也就是利用 Microsoft 商家中心商店標識符的行銷活動。

重要事項

請務必編輯對應至您網站上 UET 標籤標識符的腳本，以包含 ecomm_prodid 和 ecomm_pagetype 參數。 ecomm_prodid參數是頁面上產品的產品識別碼。它對於每個專案都是唯一的，而且必須符合產品摘要中的識別碼或item_group_id屬性。數值和英數位元 (只包含連字號) 字元，最多 50 個字元。 ecomm_pagetype參數會識別使用者流覽過的頁面類型。有效選項：home、searchresults、category、product、cart、purchase 等。

window.uetq = window.uetq || [];
window.uetq.push('event', '', {'ecomm_prodid': 'REPLACE_WITH_PRODUCT_ID', 'ecomm_pagetype': 'REPLACE_WITH_PAGE_TYPE'});

提示

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

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

下列大量 CSV 範例會新增產品物件。

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

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

針對 產品物件 記錄，大量檔案架構中提供下列屬性欄位。

對象
物件網路大小
物件搜尋大小
用戶端識別碼
描述
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 專案。

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

父項識別碼

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

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

產品物件類型

決定要將誰新增至您的產品物件。

可能的值為 GeneralVisitors、ProductSearchers、ProductViewers、ShoppingCartAbandoners 和 PastBuyers。

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

範圍

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

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

狀態

產品物件狀態。

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

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

支援的行銷活動類型

支援此產品物件之行銷活動類型的分號分隔清單。

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

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

UET 標籤識別碼

與產品物件搭配使用的通用事件追蹤 (UET) 標籤的 Microsoft Advertising 識別碼。

重要事項

請務必編輯您網站上的 UET 腳本， prodid 以包含和 pagetype 參數。

window.uetq = window.uetq || [];
window.uetq.push({'prodid': 'PRODUCT_ID', 'pagetype': 'PAGE_TYPE'});

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

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 規則，您必須包含一或多個規則專案群組。使用每個規則專案群組時，會使用邏輯 AND 運算子來聯結相同頁面的規則專案條件。然後，規則專案群組清單中的每個結果都會使用邏輯 OR 運算子聯結。換句話說，如果符合任何一個規則專案群組內的所有指定規則專案條件，使用者就會新增至您的產品物件。

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

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

共用方式為

產品物件記錄 - 大量

對象

物件網路大小

物件搜尋大小

用戶端識別碼

說明

識別碼

成員資格持續時間

修改時間

父項識別碼

產品物件類型

範圍

狀態

支援的行銷活動類型

UET 標籤識別碼

CustomEvents 規則範本

PageVisitors 規則範本

PageVisitorsWhoDidNotVisitAnotherPage 規則範本

PageVisitorsWhoVisitedAnotherPage 規則範本

其他資源