ProductAudience データ オブジェクト - キャンペーン管理
Microsoft Merchant Center ストアの製品をリマーケティングするために使用できる製品の対象ユーザーを定義します。
注:
動的リマーケティング リストは、以前は Microsoft Advertising で製品の対象ユーザーとして知られていました。 Microsoft Advertising UI には "動的リマーケティング リスト" と表示されますが、破壊的変更を避けるために、API objets には "製品の対象ユーザー" という名前が付けられます。
動的リマーケティング リストは、ユーザーがウェブサイトで見た内容、検討済み、または既に購入した内容に基づいて、特定の製品と顧客をペアリングします。 動的リマーケティング リストは、検索キャンペーンと対象ユーザー キャンペーンの両方で使用できます (すべてのユーザーがまだ対象ユーザー キャンペーンを持っているわけではありません)。
動的リマーケティング リストは、ショッピング キャンペーンとフィードベースのオーディエンス キャンペーン(Microsoft Merchant Center ストア ID を利用するキャンペーン)の両方で最適に機能します。
重要
Web サイトの UET タグ ID に対応するスクリプトを編集して、 パラメーターと ecomm_pagetype
パラメーターをecomm_prodid
含めます。
ecomm_prodid パラメーターは、ページ上の製品の製品 ID です。 アイテムごとに一意であり、製品フィードの id 属性または item_group_id 属性と一致する必要があります。 数字と英数字 (ハイフンを含む) 文字のみ(最大 50 文字)。
ecomm_pagetype パラメーターは、ユーザーがアクセスしたページの種類を識別します。 有効なオプション: ホーム、検索結果、カテゴリ、製品、カート、購入、その他。
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 識別子。 タグ ID に依存する前に、UET タグを別の顧客と共有することも、他の顧客から共有することもできます。 共有 UET タグと対象ユーザーは、パイロットのお客様のみが使用できます。 顧客階層での対象ユーザーと UET タグの共有の概要については、「 対象ユーザーと UET タグの共有 」テクニカル ガイドを参照してください。 追加: 必須 更新: オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 |
long |
ProductAudience オブジェクトには継承された要素があります。
継承された要素
対象ユーザーから継承された要素
ProductAudience オブジェクトは Audience オブジェクトから派生し、AudienceNetworkSize、CustomerShare、Description、ForwardCompatibilityMap、Id、MembershipDuration、Name、ParentId、Scope、SearchSize、SupportedCampaignTypes、Type という要素を継承します。 以下の説明は ProductAudience に固有であり、 Audience オブジェクトから同じ要素を継承する他のオブジェクトには適用されない場合があります。
要素 | 説明 | データ型 |
---|---|---|
AudienceNetworkSize | 対象ユーザー ネットワーク内のこの対象ユーザーのアクティブ メンバーであるユーザーの合計数。 これにより、対象となる対象ユーザーの数を把握できます。 Microsoft Advertising が最適化に使用する前に、対象ユーザーは少なくとも 300 人である必要があります。 追加: 読み 取り 専用 更新: 読み 取り 専用 |
long |
CustomerShare | この要素は、製品の対象ユーザーにはサポートされていません。 製品の対象ユーザーと共有 TagId を 使用することはできますが、製品の対象ユーザー自体を共有することはできません。 追加: サポートされていません 更新: サポートされていません |
CustomerShare |
説明 | 対象ユーザーの説明。 説明を使用して、ターゲットとする対象ユーザーを思い出すのに役立ちます。 説明には、最大 1,024 文字を含めることができます。 追加: オプション 更新: オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 |
string |
ForwardCompatibilityMap | 現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。 今後のリリースでは、今後の互換性の変更に関するページを参照してください。 現在、 Audience オブジェクトの前方互換性の変更はありません。 |
KeyValuePairOfstring 配列 |
Id | 対象ユーザーの Microsoft Advertising 識別子。 追加: 読み 取り 専用 更新: 必須と読み取り専用 |
long |
MembershipDuration | 対象ユーザーを作成するときに、Microsoft Advertising が対象ユーザーの定義に一致するアクションを検索する必要がある時間を、どの程度前から検索するかを指定できます。 mimimum 期間は 1 日で、許可される最大期間は 180 日です。 追加: オプション。 指定しない場合、メンバーシップ期間は既定で 30 に設定されます。 更新: オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 |
int |
名前 | 対象ユーザーの名前。 名前には最大 128 文字を使用することができます。 追加: 必須 更新: オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 |
string |
ParentId | アカウントまたは顧客の Microsoft Advertising 識別子。 [スコープ] が [アカウント] に設定されている場合、これはアカウント ID、それ以外の場合は顧客 ID です。 追加: 必須 更新: 読み 取り 専用。 親 ID は変更できません。 |
long |
範囲 | スコープは、この対象ユーザーを使用できるアカウントを定義します。 スコープが [アカウント] に設定されている場合、対象ユーザーは、1 つのアカウントのキャンペーンと広告グループにのみ関連付けることができます。つまり、 ParentId を使用します。 スコープが [顧客] に設定されている場合、対象ユーザーは、顧客のすべてのアカウントのキャンペーンと広告グループに関連付けることができます。 追加: 必須 更新: オプション。 スコープを [アカウント] から [顧客] に変更できますが、スコープを [顧客] から [アカウント] に変更することはできません。 |
EntityScope |
SearchSize | 検索ネットワーク内のこの対象ユーザーのアクティブ メンバーであるユーザーの合計数。 これにより、ターゲットにできる検索ユーザーの数を把握できます。 Microsoft Advertising が最適化に使用する前に、対象ユーザーは少なくとも 300 人である必要があります。 このプロパティは、対象ユーザーの作成中に最大 24 時間空になります (たとえば、メンバーシップ期間やタグ識別子を追加または更新する場合)。 追加: 読み 取り 専用 更新: 読み 取り 専用 |
long |
SupportedCampaignTypes | この対象ユーザーをサポートするキャンペーンの種類の一覧。 サポートされる値は、対象ユーザー、DynamicSearchAds、検索、ショッピングです。 今後、新しいキャンペーンの種類が追加される可能性があるため、固定の値セットに依存しないようにしてください。 追加: 読み 取り 専用 更新: 読み 取り 専用 |
string 配列 |
型 | 対象ユーザーの種類。 この値は、製品の対象ユーザーを取得するときの ProductAudience です。 対象ユーザーの種類の詳細については、「 対象ユーザー データ オブジェクトの備考」を参照してください。 追加: 読み 取り 専用 更新: 読み 取り 専用 |
AudienceType |
要件
サービス: CampaignManagementService.svc v13
名前 空間: https://bingads.microsoft.com/CampaignManagement/v13