ProductAudience 資料物件 - 行銷活動管理

定義產品物件，您可以用來從 Microsoft 商家中心商店重新行銷產品。

注意事項

動態重新行銷清單先前在 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'});

語法

<xs:complexType name="ProductAudience" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence>
        <xs:element minOccurs="0" name="ProductAudienceType" nillable="true" type="tns:ProductAudienceType" />
        <xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

ProductAudience物件具有下列元素：ProductAudienceType、TagId。

元素	說明	資料類型
ProductAudienceType	決定要將產品重新行銷給一般訪客、產品搜尋者、產品檢視器、購物車放棄者或過去的買方。 添加： 必填 更新： 選。 如果未設定更新的值，則此設定不會變更。	ProductAudienceType
TagId	與重新行銷清單搭配使用的通用事件追蹤 (UET) 標籤的 Microsoft Advertising 識別碼。 在您對標記識別項進行相依性之前，請注意 UET 標籤可以與其他客戶共用或與另一個客戶共用。 共用的 UET 標籤和物件僅適用于試驗客戶。 如需在客戶階層中共用物件和 UET 標籤的概觀，請參閱 共用物件和 UET 標籤 技術指南。 添加： 必填 更新： 選。 如果未設定更新的值，則此設定不會變更。	長

ProductAudience物件具有Inherited Elements。

繼承的專案

從物件繼承的專案

ProductAudience物件衍生自Audience物件，並繼承下列元素：AudienceNetworkSize、CustomerShare、Description、ForwardCompatibilityMap、Id、MembershipDuration、Name、ParentId、Scope、SearchSize、SupportedCampaignTypes、Type。 下列描述專屬於 ProductAudience，而且可能不適用於從 Audience 物件繼承相同元素的其他物件。

元素	說明	資料類型
AudienceNetworkSize	在物件網路中，屬於此物件之作用中成員的人員總數。 這可讓您瞭解您可以將多少物件網路使用者設為目標。 物件必須至少有 300 人，Microsoft Advertising 才會將它用於優化。 添加： 唯讀 更新： 唯讀	長
CustomerShare	產品物件不支援此元素。 您可以搭配產品物件使用共用 的 TagId ，但無法共用產品物件本身。 添加： 不支援 更新： 不支援	CustomerShare
描述	物件的描述。 使用描述來協助您記住目標物件。 描述最多可以包含 1,024 個字元。 添加： 選 更新： 選。 如果未設定更新的值，則此設定不會變更。	string
ForwardCompatibilityMap	用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。 未來的版本中將會記下向前相容性變更。 Audience 物件目前 沒有向前相容性變更。	KeyValuePairOfstringstring 數 組
識別碼	物件的 Microsoft Advertising 識別碼。 添加： 唯讀 更新： 必要和唯讀	長
MembershipDuration	當您建立物件時，您可以指定 Microsoft Advertising 應該尋找符合您物件定義的動作， Mimimum 持續時間為 1 天，而允許的持續時間上限為 180 天。 添加： 選。 如果未指定，成員資格持續時間預設會設定為 30。 更新： 選。 如果未設定更新的值，則此設定不會變更。	int
名稱	物件的名稱。 名稱最多可以包含 128 個字元。 添加： 必填 更新： 選。 如果未設定更新的值，則此設定不會變更。	string
ParentId	帳戶或客戶的 Microsoft Advertising 識別碼。 如果 [範圍] 設定為 [ 帳戶]，則這是帳戶識別碼，否則為客戶識別碼。 添加： 必填 更新： 唯讀。 您無法變更父識別碼。	長
範圍	範圍會定義哪些帳戶可以使用此物件。 如果範圍設定為 Account，則物件只能與一個帳戶中的行銷活動和廣告群組相關聯，也就是透過 ParentId。 如果範圍設定為 [客戶]，則物件可以與所有客戶帳戶中的行銷活動和廣告群組相關聯。 添加： 必填 更新： 選。 您可以將範圍從 [帳戶] 變更為 [客戶]，但無法將範圍從 [客戶] 變更為 [帳戶]。	EntityScope
SearchSize	在搜尋網路中，屬於此物件之作用中成員的人員總數。 這可讓您瞭解您可以將多少搜尋使用者設為目標。 物件必須至少有 300 人，Microsoft Advertising 才會將它用於優化。 在建立物件時，此屬性會是 nil 或空的，最多 24 小時，例如，如果您新增或更新成員資格持續時間或標籤識別碼。 添加： 唯讀 更新： 唯讀	長
SupportedCampaignTypes	支援此物件的行銷活動類型清單。 支援的值為 Audience、DynamicSearchAds、Search 和 Shopping。 未來可能會新增新的行銷活動類型，因此您不應該對一組固定的值採取任何相依性。 添加： 唯讀 更新： 唯讀	字串數 組
類型	物件的類型。 當您擷取產品物件時，此值為 ProductAudience 。 如需物件類型的詳細資訊，請參閱 物件資料物件備註。 添加： 唯讀 更新： 唯讀	AudienceType

需求

服務： CampaignManagementService.svc v13
命名 空間： https://bingads.microsoft.com/CampaignManagement/v13