產品物件記錄 - 大量

發行項
11/13/2024

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

注意事項

動態重新行銷清單先前在 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廣告才會將其用於優化。

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

物件搜尋大小

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

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

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

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

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

用戶端識別碼

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

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

描述

產品物件的描述。使用描述來協助您記住您以此產品對象為目標的物件。

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

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

識別碼

系統產生的產品物件標識碼。

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

成員資格持續時間

當您建立產品物件時，您可以指定廣告應該尋找符合您產品物件定義的動作，以將人員新增至清單的時間Microsoft。

最小持續時間為 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 等於 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

共用方式為

產品物件記錄 - 大量

對象

物件網路大小

物件搜尋大小

用戶端識別碼

描述

識別碼

成員資格持續時間

修改時間

父項識別碼

產品物件類型

範圍

狀態

支援的營銷活動類型

UET 標籤標識碼

CustomEvents 規則範本

PageVisitors 規則範本

PageVisitorsWhoDidNotVisitAnotherPage 規則範本

PageVisitorsWhoVisitedAnotherPage 規則範本

意見反應

其他資源