ユニバーサル イベント トラッキング
UET は、強力な Microsoft Advertising ツールです。 単一の UET タグを 1 つ作成し、Web サイトに 1 回追加するだけで済みます。 このタグは、ユーザーが Web サイトで行ったことを記録した後、Microsoft Advertising はそのデータの収集を開始し、リマーケティング リストを使用してコンバージョン (購入や潜在顧客など) やターゲットユーザーを追跡できるようにします。 UET は、有料検索でのコンバージョン トラッキングとリマーケティングの前提条件です。
この設定を行う手順がいくつかあります。 次の操作が必要です。
- Microsoft Advertising で UET タグ を 1 回作成する
- Web サイトのすべてのページに UET タグ追跡コードを追加する
- 目的に応じて、コンバージョン トラッキングを設定するか、有料検索でのリマーケティングなど、対象ユーザーを活用します。
詳細については、以下の API の概要に関するセクションを参照してください。
ユニバーサル イベント追跡 API
リマーケティング リストを使用してコンバージョンやターゲットユーザーを追跡するには、Microsoft Advertising (Web アプリケーションまたは API) で UET タグを作成し、Web サイトのすべてのページに UET タグ追跡コードを追加する必要があります。 このセクションでは、Bing Ads API を使用して UET タグを設定する方法について説明します。 Microsoft Advertising Web アプリケーションを使用して UET タグを設定する方法については、「UET タグの作成操作方法」と「FAQ: ユニバーサル イベント追跡」を参照してください。
注:
このセクションで説明する操作ごとに、 CustomerId ヘッダー要素に顧客識別子を指定する必要があります。
- 最初に GetUetTagsByIds 操作を呼び出して、タグが既に作成されているかどうかをチェックする必要があります。 TagIds 要素は null のままにするか、空のままにして、顧客が使用できるすべての UET タグを要求できます。
- すべてのコンバージョン目標とリマーケティング リストで 1 つの UET タグを使用できます。 複数の UET タグを作成する前に、「 複数の UET タグを作成する理由」を参照してください。 使用できる UET タグがまだない場合、または別の UET タグが必要な場合は、 AddUetTags サービス操作を呼び出して新しい UET タグを作成します。 呼び出しが成功した場合、Web サイトに追加する必要がある追跡スクリプトは、応答メッセージ内の対応する UetTag に含まれます。 後で必要に応じて、 UpdateUetTags 操作で UetTag の名前と説明 を更新 できます。
AddUetTags または GetUetTagsByIds 操作から追跡スクリプトを取得した後、次の手順は、Web サイトに UET タグ追跡コードを追加することです。 Web サイト管理者または Web サイト管理者は、頭または本文のセクションで Web サイト全体に追加することをお勧めします。 Web サイトにサイト全体のレイアウト ページがある場合は、1 回追加し、すべてのページに含めるので、サイト全体のレイアウト ページを追加するのに最適な場所です。 詳細については、「web サイトに UET タグを追加操作方法」を参照してください。
実行する内容に応じて、 コンバージョン トラッキング または 対象ユーザーを設定します。
コンバージョン目標 API
UET の最大の価値提案の 1 つは、Web サイトに 1 つのタグをインストールして、複数の種類のコンバージョンを追跡できる点です。 Web サイトに UET タグ追跡コードが追加されると、Microsoft Advertising は、ページ訪問やニュースレターのサブスクライブやドキュメントのダウンロードなどのカスタム イベントをログに記録できます。
ただし、すべてのアクションが等しく作成されるわけではありません。 広告キャンペーンを成功させるには、より重要と考えられるアクションのサブセットが存在する可能性があります。 これには、購入、リード フォームへの記入、ビデオの視聴などがあります。 コンバージョン目標が役立つ場所です。 コンバージョン目標を使用すると、変換としてカウントする (UET によって記録される) アクションを指定できます。 コンバージョンGoalsの詳細については、「コンバージョンの目標と目標の種類とは」を参照してください。
コンバージョン目標キャンペーン管理 API
コンバージョン目標には 5 種類あります。 ConversionGoal は、すべての目標の派生元となる基底クラスです。
- AppInstallGoal
- DurationGoal
- EventGoal
- InStoreTransactionGoal
- OfflineConversionGoal
- PagesViewedPerVisitGoal
- UrlGoal
コンバージョン目標の管理には、次の操作を使用できます。
対象ユーザー API
特定の対象ユーザーに対してキャンペーンを最適化することで、投資収益率を向上させます。これは、キャンペーンに関連する共通点を持つユーザーのグループです。
対象ユーザーの種類
Microsoft Advertising では、複数の対象ユーザーの種類がサポートされています。
結合されたリスト
結合リストは、複数の既存の対象ユーザーの組み合わせから作成された対象ユーザーです。
カスタム オーディエンス、顧客リスト、製品の対象ユーザー、類似ユーザー、リマーケティング リストを組み合わせることができます。 他の組み合わせリストや市場内オーディエンスを組み合わせたリストに含めることはできません。
広告アカウントごとに最大 1,000 個の組み合わせリストを作成でき、顧客ごとに最大 5,000 個のリストを作成できます。 各リストには、最大 100 個の組み合わせルールまたは論理条件のセットを含めることができます。また、各組み合わせルールには最大 100 個の対象ユーザー ID を含めることができます。
以下で説明するいくつかの制限により、これらの論理演算子を使用して対象ユーザーを結合できます。
- または:これには、これらのいずれかの対象ユーザー リストに含まれる顧客が含まれます。
- AND: これには、これらの対象ユーザー リストの 1 つ 1 つに含まれる顧客のみが含まれます。
- NOT: これにより、これらのいずれかの対象ユーザー リストに含まれる顧客が除外されます。
論理式の評価によって、結合リストに追加されるユーザーが決まります。 複数の組み合わせは、常に AND 関数と組み合わされます。 つまり、このカスタムの組み合わせ対象ユーザーリストに表示するには、顧客が各組み合わせのすべての条件を満たす必要があります。
結合リストには、OR 演算子または AND 演算子を使用する対象ユーザーが少なくとも 1 人含まれている必要があります。 結合されたリストでは、NOT 演算子のみを使用することはできません。 その場合は、代わりに対象ユーザーの除外を使用する必要があります。
カスタム対象ユーザーと顧客リストを他の対象ユーザーの種類と組み合わせることはできません。
AND 演算子または NOT 演算子を使用して類似の対象ユーザーを結合することはできません。 同様の対象ユーザーは、1 つの OR 条件でのみ使用できます。 つまり、類似する対象ユーザーを含む対象ユーザー セットは 1 つだけであり、そのセットでは OR 演算子を使用する必要があります。
重複する対象ユーザーは許可されますが、AND 演算子と NOT 演算子の両方を使用して同じ対象ユーザー ID を組み合わせることはできません。
カスタム 対象ユーザー
カスタム対象ユーザーは、独自の顧客データを使用して、より豊富なユーザー セグメントを作成することによって生成されます。 カスタム オーディエンスは、通常、データ管理プロバイダー (DMP) を通じて、リマーケティング リストと組み合わせて使用できます。 DMP がカスタムオーディエンス機能に接続すると、カスタムオーディエンスを Microsoft 広告にインポートして検索リマーケティングを行うことができます。 カスタム オーディエンスはリマーケティングとは別に使用でき、UET は必要ありません。 Microsoft Advertising ネットワークでターゲット設定できるのは、ファースト パーティの対象ユーザー データ (独自の Web サイトやアプリから収集した顧客データなど) のみです。 詳細については、「 カスタム 対象ユーザーについて」を参照してください。
注:
Bing広告 API を使用してカスタム対象ユーザーを削除することはできますが、追加することはできません。 そうは言っても、カスタム対象ユーザーの関連付けと除外を追加および削除できます。
ひとめで:
- データを使用します。 カスタム 対象ユーザーを使用すると、既に持っている対象ユーザー データを使用できます。
- より豊富な対象ユーザーを作成します。 より多くの顧客データを使用して、より豊富な対象ユーザー セグメントを作成します。
- リマーケティングと同様に機能します。 カスタム オーディエンスは、ターゲットと入札、入札のみ、または除外としてキャンペーンや広告グループに関連付けることができます。
カスタム 対象ユーザーの使用を開始するには、DMP で次の作業を行う必要があります。
- カスタム対象ユーザー API をプラットフォームに統合します。
- Microsoft のデータ共有とプライバシー ポリシーに同意します。
プロバイダーに応じて、ソフトウェア内に独自の有効化手順があります。 この機能を有効にする方法の詳細については、必ず DMP にお問い合わせください。
統合が完了すると、Microsoft Advertising Web アプリケーションの共有ライブラリの [対象ユーザー] セクションにカスタム対象ユーザーが表示されます。 以下で説明するように、Bulk API と Campaign Management API を使用してカスタム オーディエンスをダウンロードすることもできます。
顧客リスト
顧客リストは、顧客の一致を有効にするためにコンパイルした顧客連絡先情報のセットです。
注:
顧客リストは Bulk API を介して利用できますが、 キャンペーン管理 API を使用してはまだ使用できません。
重要
Bulk API を使用して顧客リスト データをアップロードするには、まず 1 人の顧客リスト対象ユーザーを作成し、Microsoft Advertising UI で使用条件に同意する必要があります。 最初の顧客リストには顧客データを含める必要はありませんが、[同意する] を選択する必要があります。
[同意する] を選択すると (1) ユーザーは、個人データである対象ユーザーの詳細を Microsoft に合法的に開示できることに同意し、(2) カスタマー マッチ条項、Microsoft 広告契約、および Microsoft 広告ポリシーに同意します。 Microsoft は、お客様がアップロードしたデータを カスタマー マッチ条項に従って使用します。
各リストには、複数のEmail項目を含めることができます。
- 一括アップロード ファイルに 顧客リスト レコードを含め、アクション の種類 フィールドを "追加"、"削除"、または "置換" に設定します。
- 同じ一括アップロード ファイルに 1 つ以上の Customer List Item レコードを含め、[ 親 ID]、[ サブタイプ]、[ テキスト] フィールドを設定します。
同じ一括アップロード ファイルに顧客リスト アイテム レコードを含めずに顧客リスト レコードを追加または更新できます。ただし、関連する親顧客リスト レコードなしでは、顧客リストアイテムレコードをアップロードすることはできません。
48 時間後に、[対象ユーザーのサイズ] フィールド (オーディエンス検索サイズなど) をチェックして、Bing ネットワークで一致した顧客の数を確認します。 その時点で、この新しい対象ユーザーに対して広告の表示を開始できます。
対象ユーザーの In-Market
市場内の対象ユーザーは、特定のカテゴリ内で購入意図シグナルを表示した顧客のキュレーションリストです。これには、Microsoft サービスのBingとページ ビューの検索やクリックが含まれます。 Microsoft Advertising は、広告主がリストを作成する有料検索でのリマーケティングとは異なり、潜在的な顧客のキュレーションリストを提供します。 リマーケティング リストと同様に、市場内のオーディエンス リストを広告グループやキャンペーンに関連付けることにより、これらのオーディエンスの入札単価をターゲットに設定したり変更したりできます。 詳細については、「 インマーケット オーディエンス: 購入準備ができているユーザーにリーチする」を参照してください。
注:
Bing広告 API を使用して、市場内オーディエンスを追加、更新、または削除することはできません。 とはいえ、市場内の対象ユーザーの関連付けと除外を追加および削除できます。
注:
この機能は、オーストラリア、カナダ、フランス、ドイツ、イギリス、米国で利用できます。
製品の対象ユーザー
動的リマーケティング リストは、ユーザーがウェブサイトで見た内容、検討済み、または既に購入した内容に基づいて、特定の製品と顧客をペアリングします。 動的リマーケティング リストは、検索キャンペーンと対象ユーザー キャンペーンの両方で使用できます (すべてのユーザーがまだ対象ユーザー キャンペーンを持っているわけではありません)。
注:
動的リマーケティング リストは、以前は Microsoft Advertising で製品の対象ユーザーとして知られていました。 Microsoft Advertising UI には "動的リマーケティング リスト" と表示されますが、破壊的変更を避けるために、API objets には "製品の対象ユーザー" という名前が付けられます。
詳細については、「 動的リマーケティング リスト: 製品向けリマーケティング」を参照してください。
リマーケティング リスト
有料検索でのリマーケティングを使用すると、以前にウェブサイトにアクセスしたユーザーである特定の対象ユーザーに対してキャンペーンを最適化することで、投資収益率を向上させることができます。 リマーケティング リストを作成する際に、Web サイトでリマーケティング リストに含まれると見なされるユーザー アクションを指定します。
ユーザーが対象となるアクションを実行すると、数分以内にリマーケティング リストに追加されます。 リマーケティング リストの最小サイズ 1,000 (最小 Cookie プール) が満たされ、リマーケティング リストをキャンペーンまたは広告グループに関連付け、特定の入札金額を設定した場合、広告配信エンジンは Microsoft 広告ネットワーク上のユーザーにリマーケティング広告の配信を開始します。 有料検索でのリマーケティングの詳細については、「 対象ユーザーにリーチする 」と 「FAQ: リマーケティング」を参照してください。
ユニバーサル イベント トラッキング (UET) を設定したら、Bing広告 API を使用してリマーケティング リストを作成し、キャンペーンや広告グループに関連付けることができます。
類似のリマーケティング Lists
Microsoft 広告では、ユーザーがパイロット参加者である場合、リマーケティング リストの類似ユーザーが自動的に生成されます。 リマーケティング リストの類似ユーザーを作成または編集することはできません。 そうは言っても、類似のリマーケティング リストの関連付けと除外を追加および削除できます。 ソース リマーケティング リストを削除すると、同様の対象ユーザーも削除されます。 同様の対象ユーザーがキャンペーンまたは広告グループに関連付けられている場合、ソース リマーケティング リストを削除することはできません。
注:
類似ユーザーを生成するには、少なくとも 1,000 人のユーザーとアクティブな関連付けを持つリマーケティング リストが少なくとも 1 つ必要です。
同様の対象ユーザーは、アクティブなキャンペーンや広告グループに関連付ける前に、検索ネットワークまたは Microsoft Audience Network に少なくとも 300 人のユーザーが存在する必要があります。
同様の対象ユーザーは、ビルドとターゲット設定に最大 24 時間かかりますが、その時点まで有効になりません。
対象ユーザーの一括 API
Bulk サービスを使用すると、次のレコードの種類を使用して対象ユーザーをダウンロードおよびアップロードできます。
注:
カスタム 対象ユーザーでは、名前と説明の更新のみがサポートされます。 Bing広告 API を使用してカスタム対象ユーザーを削除することはできますが、追加することはできません。 そうは言っても、カスタム対象ユーザーの関連付けと除外を追加および削除できます。
Bing広告 API を使用して、市場内オーディエンスを追加、更新、または削除することはできません。 とはいえ、市場内の対象ユーザーの関連付けと除外を追加および削除できます。
Microsoft 広告では、ユーザーがパイロット参加者である場合、リマーケティング リストの類似ユーザーが自動的に生成されます。 リマーケティング リストの類似ユーザーを作成または編集することはできません。 そうは言っても、類似のリマーケティング リストの関連付けと除外を追加および削除できます。 ソース リマーケティング リストを削除すると、同様の対象ユーザーも削除されます。 同様の対象ユーザーがキャンペーンまたは広告グループに関連付けられている場合、ソース リマーケティング リストを削除することはできません。
Bulk サービスを使用すると、次のレコードの種類を使用して、対象ユーザーの関連付けをダウンロードしてアップロードできます。
- 広告グループの結合されたリストの関連付け
- 広告グループのカスタム対象ユーザーの関連付け
- 広告グループの顧客リストの関連付け
- 広告グループの購買意向の強い対象ユーザーの関連付け
- 広告グループの除外する結合されたリストの関連付け
- 広告グループの除外するカスタム対象ユーザーの関連付け
- 広告グループの除外する顧客リストの関連付け
- 広告グループの除外する購買意向の強い対象ユーザーの関連付け
- 広告グループの除外する製品対象ユーザーの関連付け
- 広告グループの除外するリマーケティング リストの関連付け
- 広告グループの除外する類似リマーケティング リストの関連付け
- 広告グループの製品対象ユーザーの関連付け
- 広告グループのリマーケティング リストの関連付け
- 広告グループの類似リマーケティング リストの関連付け
- キャンペーンの結合されたリストの関連付け
- キャンペーンのカスタム対象ユーザーの関連付け
- キャンペーンの顧客リストの関連付け
- キャンペーンの購買意向の強い対象ユーザーの関連付け
- キャンペーンの除外する結合されたリストの関連付け
- キャンペーンの除外するカスタム対象ユーザーの関連付け
- キャンペーンの除外する顧客リストの関連付け
- キャンペーンの除外する購買意向の強い対象ユーザーの関連付け
- キャンペーンの除外する製品対象ユーザーの関連付け
- キャンペーンの除外するリマーケティング リストの関連付け
- キャンペーンの除外する類似リマーケティング リストの関連付け
- キャンペーンの製品対象ユーザーの関連付け
- キャンペーンのリマーケティング リストの関連付け
- キャンペーンの類似リマーケティング リストの関連付け
注:
対象ユーザーのターゲットをキャンペーンと広告グループの両方のレベルに設定することはできません。 入札可能なキャンペーン レベルのオーディエンス条件を設定した場合、入札可能な広告グループレベルのオーディエンス条件を設定することはできません。 対象ユーザーの除外は、キャンペーンレベルと広告グループレベルの両方で設定できます。 Microsoft Advertising では、キャンペーンと広告グループレベルの両方の除外の和集合が適用されます。
既定では、キャンペーンと広告グループの広告はすべてのユーザーに表示されますが、入札単価調整は対象ユーザーに含まれるユーザーに適用されます。 対象ユーザーに含まれるユーザーにのみ広告を表示する場合は、[ターゲットと入札] ターゲット設定を設定します。 キャンペーンまたは広告グループレコードの [ターゲット設定] フィールドを使用すると、キャンペーンまたは広告グループに関連付けられているすべての対象ユーザー (結合リスト、カスタムオーディエンス、市場内オーディエンス、製品オーディエンス、リマーケティング リスト、類似オーディエンスなど) に適用されるターゲット設定を決定できます。 各対象ユーザーは複数のキャンペーンや広告グループに関連付けることができ、各ターゲット設定は配信に個別に適用されます。
対象ユーザー キャンペーン管理 API
CombinedList、CustomAudience、InMarketAudience、ProductAudience、リマーケティング リスト、SimilarRemarketingList オブジェクトはすべて、Audience 基本クラスから派生します。 キャンペーン管理サービスを使用している場合は、それぞれの AddAudiences、GetAudiencesByIds、UpdateAudiences、DeleteAudiences 操作を使用して対象ユーザーを追加、取得、更新、または削除できます。
注:
カスタム 対象ユーザーでは、名前と説明の更新のみがサポートされます。 Bing広告 API を使用してカスタム対象ユーザーを削除することはできますが、追加することはできません。 そうは言っても、カスタム対象ユーザーの関連付けと除外を追加および削除できます。
Bing広告 API を使用して、市場内オーディエンスを追加、更新、または削除することはできません。 とはいえ、市場内の対象ユーザーの関連付けと除外を追加および削除できます。
対象ユーザーとキャンペーンの関連付けを追加、取得、更新、または削除するには、 BiddableCampaignCriterion オブジェクトを、それぞれ AddCampaignCriterions、 GetCampaignCriterionsByIds、 UpdateCampaignCriterions、 DeleteCampaignCriterions 操作と共に使用します。 同じ操作で NegativeCampaignCriterion オブジェクトを使用して、対象ユーザーの除外を設定できます。
対象ユーザーと広告グループの関連付けを追加、取得、更新、または削除するには、 BiddableAdGroupCriterion オブジェクトを、それぞれ AddAdGroupCriterions、 GetAdGroupCriterionsByIds、 UpdateAdGroupCriterions、 DeleteAdGroupCriterions 操作と共に使用します。 同じ操作で NegativeAdGroupCriterion オブジェクトを使用して、対象ユーザーの除外を設定できます。
注:
対象ユーザーのターゲットをキャンペーンと広告グループの両方のレベルに設定することはできません。 入札可能なキャンペーン レベルのオーディエンス条件を設定した場合、入札可能な広告グループレベルのオーディエンス条件を設定することはできません。 対象ユーザーの除外は、キャンペーンレベルと広告グループレベルの両方で設定できます。 Microsoft Advertising では、キャンペーンと広告グループレベルの両方の除外の和集合が適用されます。
既定では、キャンペーンと広告グループの広告はすべてのユーザーに表示されますが、入札単価調整は対象ユーザーに含まれるユーザーに適用されます。 対象ユーザーに含まれるユーザーにのみ広告を表示する場合は、[ターゲットと入札] ターゲット設定を設定します。 キャンペーン または AdGroup オブジェクトの Settings 要素を使用して、キャンペーンまたは広告グループに関連付けられているすべての対象ユーザー (結合リスト、カスタム オーディエンス、市場内オーディエンス、製品オーディエンス、リマーケティング リスト、類似オーディエンス) に適用されるターゲット設定を決定できます。 各対象ユーザーは複数のキャンペーンや広告グループに関連付けることができ、各ターゲット設定は配信に個別に適用されます。
対象ユーザーと UET タグを共有する
顧客 階層 と共有 UET タグと対象ユーザー機能の両方で有効にすると、UET タグとリマーケティング リストを他の顧客と共有できます。
共有 UET タグと対象ユーザーは、キャンペーン管理 API を介してのみ管理できます。 Bulk API を使用して対象ユーザーを追加、取得、更新、削除することはできますが、Bulk API を使用して顧客階層内の対象ユーザーを共有するあらゆる側面を管理することはできません。
UET タグに依存する対象ユーザーの関連付けに関するいくつかのルールを次に示します。
- 共有できるのは UET タグとリマーケティング リストのみですが、製品の対象ユーザーは共有 UET タグを使用することもできます。 UET に依存するコンバージョン目標では、共有 UET タグを使用することもできます。 顧客リストは共有できますが、UET タグに関連付ける必要はありません。
- UET タグは、顧客レベル (マネージャー アカウント レベルとも呼ばれます) でのみ共有できます。 特定の広告主アカウントと UET タグを共有することはできません。
- スコープはアカウントから顧客に更新できますが、顧客レベルのスコープを設定すると、対象ユーザーのスコープを個々のアカウントに制限することはできません。 たとえば、Microsoft Advertising Web アプリケーションで [選択した MCC アカウントと広告主アカウントで共有] を選択した場合、[Ad Account Foo (Bar)のみ使用)] オプションは使用できなくなります。
- 階層のサブセットと UET タグと対象ユーザーを共有できます。 たとえば、MCC アカウント L1 から MCC アカウント L2 からマネージャー アカウント L3 までの階層が上から下にあるとします。 MCC アカウント L1 が所有する UET タグと対象ユーザーを Manager アカウント L3 と共有することを選択できます。また、中間の Manager アカウント L2 と共有する必要はありません。 後で Manager アカウント L4 が Manager アカウント L3 の下の階層に追加された場合、UET タグと対象ユーザーは自動的に共有されません。 これが目標の場合は、UET タグと対象ユーザーを Manager アカウント L4 と明示的に共有する必要があります。
- 対象ユーザーは、関連付けられている UET タグを既に共有している同じアカウント セットでのみ共有できます。 たとえば、対象ユーザーが、MCC アカウント L1、Manager アカウント L2、マネージャー アカウント L3 でのみ共有される UET タグを使用している場合、対象ユーザーを Manager アカウント L4 または含まれる広告主アカウントと共有することはできません。
- 対象ユーザーを所有する顧客の Super 管理 ユーザーのみが削除できます。
- 対象ユーザーまたは UET タグを所有する顧客のスーパー 管理 ユーザーは、対象ユーザーまたは UET タグの顧客アカウント共有スコープを更新できます。 階層の親顧客のスーパー 管理 ユーザーは、スコープを更新することもできます。 たとえば、リマーケティング リストが MCC アカウント L2 によって所有されている場合、MCC アカウント L1 と MCC アカウント L2 の両方のスーパー 管理 ユーザーがスコープを更新できます。
- 説明や名前などの他の対象ユーザーまたは UET タグプロパティ (スコープ以外) は、対象ユーザーまたは UET タグを所有する顧客の Super 管理 ユーザーのみが更新できます。 階層の親顧客のスーパー 管理 ユーザーは、これらの詳細を更新できません。 たとえば、リマーケティング リストが MCC アカウント L2 によって所有されている場合、名前と説明を更新できるのは、MCC アカウント L2 のスーパー 管理 ユーザーのみです。
- 対象ユーザーまたは UET タグが階層内で共有されていない場合、対象ユーザーまたは UET タグを所有する顧客のStandard ユーザーは、説明や名前などの対象ユーザーまたは UET タグのプロパティ (スコープ以外) を更新できます。 対象ユーザーまたは UET タグが共有されている間、Standardユーザーはこれらのプロパティを更新できません。
顧客共有の例
GetUetTagsByIds と GetAudiencesByIds を使用して UET タグとリマーケティング リストを取得するときに返される SOAP オブジェクトの例をいくつか見てみましょう。 アカウント階層ガイドの階層の例に基づいて構築しましょう。
たとえば、顧客と広告主アカウントの両方のクライアント リンクを持つ MCC アカウント L1 (顧客 ID 111) の下に代理店階層が設定されたとします。
- 階層がセットアップされる前に、4 つの個別のマネージャー アカウントがプロビジョニングされていました。 Manager アカウント L1 には、広告アカウント 1A と広告アカウント 1B が含まれています。 Manager アカウント L2 には、広告アカウント 2A と広告アカウント 2B が含まれています。 Manager アカウント L3 には、広告アカウント 3A と広告アカウント 3B が含まれています。 Manager アカウント L4 には、広告アカウント 4A と広告アカウント 4B が含まれています。
- Manager アカウント L1 (顧客 ID 111) は、管理者リンクを含む Manager アカウント L2 (顧客 ID 222) にリンクします。
- Manager アカウント L2 (顧客 ID 222) は、Standard リンクを含む Manager アカウント L3 (顧客 ID 333) にリンクします。
- Manager アカウント L3 (顧客 ID 333) は、アカウント レベルのリンクを含む広告アカウント 4A (アカウント ID 444111) にリンクします。 広告アカウント 4A (アカウント ID 444111) は、MCC アカウント L4 (顧客 ID 444) のすぐ下にあります。これは、それ自体が顧客レベル階層に含まれていません。 この例では、Manager アカウント L3 (顧客 ID 333) を介して Ad アカウント 4A (アカウント ID 444111) にアクセスできます。つまり、顧客 ID を必要とするサービス操作を呼び出す場合は、アカウント 444111にアクセスするために Manager アカウント L3 (顧客 ID 333) を使用する必要があります。
顧客が共有 UET タグと対象ユーザーに対して有効になっていない場合、または対象ユーザーの種類 ( SimilarRemarketingList など) を共有できない場合、UET タグまたは対象ユーザーを取得すると CustomerShare オブジェクトが nil になります。
<CustomerShare i:nil="true"/>
この例のシナリオでは、階層内のすべての顧客が共有 UET タグと対象ユーザーに対して有効になります。 たとえば、マネージャー アカウント L1 (顧客 ID 111) で、1 つの UET タグと 1 つのリマーケティング リスト (同じ UET タグに依存) が作成され、階層内の顧客とまだ共有されていないとします。 UetTag オブジェクトとリマーケティング リスト オブジェクトが取得されると、CustomerShare オブジェクト (つまり、UET タグまたはリマーケティング リストが作成された顧客) に OwnerCustomerId のみが設定されます。
<CustomerShare>
<CustomerAccountShares/>
<OwnerCustomerId>111</OwnerCustomerId>
</CustomerShare>
次に、Manager アカウント L1 (顧客 ID 111) が、MCC アカウント L2 (顧客 ID 222) とマネージャー アカウント L3 (顧客 ID 333) と UET タグのみを共有するとします。 リマーケティング リストでは共有 UET タグが使用されますが、それ自体はまだ共有されていません。
- UET タグを共有する顧客ごとに、UET タグの CustomerShare に CustomerAccountShare オブジェクトが含まれます。
- 顧客が UET タグにアクセスできるが、まだ使用していない場合は 、Associations 要素は nil です。たとえば、Manager アカウント L2 (顧客 ID 222) とマネージャー アカウント L3 (顧客 ID 333) などです。
- 所有者には CustomerAccountShare も含まれています。 Associations 要素には、UsageType が UETTagAssociateToRemarketingList に設定された CustomerAccountShareAssociation オブジェクトが 1 つ含まれています。
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v13">d79e5bc6-2b90-440b-9fd0-4b2b39d6f79e</h:TrackingId>
</s:Header>
<s:Body>
<GetUetTagsByIdsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<UetTags xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<UetTag>
<CustomerShare>
<CustomerAccountShares>
<CustomerAccountShare>
<AccountId i:nil="true"/>
<Associations/>
<CustomerId>333</CustomerId>
</CustomerAccountShare>
<CustomerAccountShare>
<AccountId i:nil="true"/>
<Associations/>
<CustomerId>222</CustomerId>
</CustomerAccountShare>
<CustomerAccountShare>
<AccountId i:nil="true"/>
<Associations>
<CustomerAccountShareAssociation>
<AssociationCount>1</AssociationCount>
<UsageType>UETTagAssociateToRemarketingList</UsageType>
</CustomerAccountShareAssociation>
</Associations>
<CustomerId>111</CustomerId>
</CustomerAccountShare>
</CustomerAccountShares>
<OwnerCustomerId>111</OwnerCustomerId>
</CustomerShare>
<!--Removed some elements for brevity-->
</UetTag>
</UetTags>
<PartialErrors xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
</GetUetTagsByIdsResponse>
</s:Body>
</s:Envelope>
最後に、Manager アカウント L1 (顧客 ID 111) が、リマーケティング リストを MCC アカウント L3 (顧客 ID 333) と Ad Account 2A (アカウント ID 222111) と共有するとします。 上記のシナリオの概要で説明したように、広告アカウント 2A (アカウント ID 222111) は、MCC アカウント L2 (顧客 ID 222) のすぐ下にあります。 この例では、リマーケティング リストが広告アカウント 2A (アカウント ID 222111) の下の 1 つの広告グループに関連付けられていると仮定します。
- リマーケティング リストを共有する顧客または広告主アカウント のサブセットごとに、UET タグの CustomerShare に CustomerAccountShare オブジェクトが含まれます。
- ユーザーがリマーケティング リストにアクセスできるが、まだ使用していない場合は 、Associations 要素は nil です (たとえば、Ad Account 2A (アカウント ID 222111)。
- Manager アカウント L3 (顧客 ID 333) はリマーケティング リストを 1 つの広告グループに関連付けているので、Associations 要素には、UsageType が [リマーケティング リスト][関連付け][ToAdGroup] に設定された 1 つの CustomerAccountShareAssociation オブジェクトが含まれます。
- 所有者には、1 つの CustomerAccountShare オブジェクトも含まれています。
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v13">d0751178-2049-4afa-8171-435c55effdf3</h:TrackingId>
</s:Header>
<s:Body>
<GetAudiencesByIdsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<Audiences xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Audience i:type="RemarketingList">
<!--Removed some elements for brevity-->
<CustomerShare>
<CustomerAccountShares>
<CustomerAccountShare>
<AccountId>222111</AccountId>
<Associations/>
<CustomerId i:nil="true"/>
</CustomerAccountShare>
<CustomerAccountShare>
<AccountId i:nil="true"/>
<Associations>
<CustomerAccountShareAssociation>
<AssociationCount>1</AssociationCount>
<UsageType>RemarketingListAssociateToAdGroup</UsageType>
</CustomerAccountShareAssociation>
</Associations>
<CustomerId>333</CustomerId>
</CustomerAccountShare>
<CustomerAccountShare>
<AccountId i:nil="true"/>
<Associations/>
<CustomerId>111</CustomerId>
</CustomerAccountShare>
</CustomerAccountShares>
<OwnerCustomerId>111</OwnerCustomerId>
</CustomerShare>
<!--Removed some elements for brevity-->
</Audience>
</Audiences>
<PartialErrors xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
</GetAudiencesByIdsResponse>
</s:Body>
</s:Envelope>