Audience Managerのデータ収集ライブラリをAppMeasurementから Web SDKに更新する

1.Analytics の移行を計画する.

Analytics チームと協力して、{Tags または2}JavaScript ベースの実装で Analytics の移行手順に従います。Analytics の移行を計画したら、このガイドに戻り、引き続きAudience Managerの手順を参照して、Analytics とAudience ManagerAudience Managerの移行を一緒にデプロイするために必要な作業を確認します。

2.データストリームにAudience Manager サービスを追加し す。

手順 1 で説明した Analytics の移行で使用しているデータストリームにAudience Manager サービスを追加します。

1. experience.adobe.com に移動し、資格情報を使用してログインします。

2. 右上のホームページまたは製品セレクターを使用して、Data Collection に移動します。

3. 左側のナビゲーションで、「Datastreams」を選択します。

4. 手順 1 の Analytics 移行の一部として作成したデータストリームを選択します。

5. 「Add Service」を選択します。

6. サービス ドロップダウンメニューで、「Audience Manager」を選択します。

7. 「Cookie Destinations Enabled」オプションと「URL Destinations Enabled」オプションをオンにします。 これらのオプションを使用すると、Edge Networkは、これらのAudience Managerの宛先タイプをページに返すことができます。

8. Enable XDM Flattened Fields が無効になっていることを確認します。 このオプションを選択すると、Analytics 変数からAudience Manager シグナルへの自動変換が無効になります。 このオプションは、Edge Networkが Analytics データをAudience Manager シグナルに自動変換する前に Web SDKに移行したユーザーとの下位互換性を保つように設計されています。

   note note
   NOTE
   Enabled XDM Flattened Fields オプションを有効にして web SDKに移行する場合は、XDM 形式のAudience Managerに必要なデータと、prop、eVar またはイベントを使用するすべてのAudience Manager特性を、XDM 形式のデータを検索するように更新する必要があります。 Adobeでは、このオプションを無効のままにすることをお勧めします。

   

9. 「Save」を選択して、データストリーム設定を保存します。

これで、データストリームがデータを受け取り、Audience Managerに渡す準備が整いました。 データストリーム ID に注意してください。この ID は、コードで web SDKを設定する際に必要になるからです。

3.サードパーティ ID 同期を有効にし、Audience Manager コンテナ ID を設定し す。

1. experience.adobe.com に移動し、資格情報を使用してログインします。

2. 右上のホームページまたは製品セレクターを使用して、Data Collection に移動します。

3. 左側のナビゲーションで、「Datastreams」を選択します。

4. 手順 1 の Analytics 移行の一部として作成したデータストリームを選択します。

5. データストリーム設定ページの右上隅にある「Edit」を選択します。

6. Advanced Options ドロップダウンメニューを展開し、Third Party ID Sync 機能がまだ有効になっていない場合は有効にします。 このオプションは、Edge NetworkとExperience Platformのデータパートナーに対してパートナー ID 同期を返すようにAudience Managerに指示します。

   {style=“border:1px solid lightslategray”}。

7. ほとんどの場合、「Third Party ID Sync Container ID」フィールドは空白のままにできます。 デフォルトで 0 になります。 ただし、適切なコンテナ ID を使用する場合は、次の手順に従います。

   • ブラウザーウィンドウを匿名モードまたはプライベートモードで開き、移行の一部であるページに移動します。
   • ブラウザーの開発者ツールを使用して、dpm.demdex.net/id へのネットワーク呼び出しについてフィルタリングします。 この呼び出しは、最初の訪問の最初のページでのみ実行されるので、匿名ブラウザーまたはプライベートブラウザーが必要になります。
   • リクエストのペイロードを表示します。 d_nsid パラメーターが 0 とは異なる場合は、Third Party ID Sync Container ID フィールドにコピーします。

8. 「Save」を選択します。

これで、データをAudience Managerに送信し、Audience Managerの応答を web SDKに渡す準備が整いました。

ほとんどのAudience Manager実装では、クロスデバイスのパーソナライゼーションシナリオおよびが、認証状態（ログインまたはログアウト）に応じて訪問者が選定できるセグメントを制御するのに役立つ プロファイル結合ルールが使用されています。 プロファイル結合ルールでは、認証後のすべてのデータ収集呼び出しで、顧客が所有する ID （CRM ID、アカウント番号など）をAudience Managerに送信する必要があります。 以前は、訪問者 ID サービス（setCustomerIDs）の visitor.js 関数を使用して、各 Analytics データ収集呼び出しに顧客 ID を追加してから、Audience Managerに転送されていました。

Web SDKでは、IdentityMap と呼ばれる特別な XDM 構造を使用して、これらの ID をEdge Networkに送信する必要があります。

ID マップで ID を正しく渡すには、ID 名前空間を理解し、特にExperience Platform サンドボックスにデータを送信する際に渡す ID を慎重に検討する必要があります。 この記事では、これらの考慮事項と手順の概要を説明します。

渡す ID とタイミングを決定したら、タグ内の Identity map Identity map データ要素の使用に関するガイドに従うか、ID データの概要に記載されている通りに手動で設定して、Web SDKのデプロイメント戦略に合わせます。

5.（オプション）ファーストパーティ aam_uuid cookie を設定し す。

長年の標準的な方法は、Audience Manager UUID （サードパーティ demdex cookie の値）を、通常 aam_uuid という名前のファーストパーティ cookie に配置することでした。

cookie を設定するには、Analytics タグ拡張機能の「Name」セクションの「Unique User ID Cookie」フィールドまたは「uuidCookie」フィールドに cookie 名を入力して、audienceManagementModule を設定する必要があります。 Audience Manager UUID の値は、広告プラットフォームで使用される、デバイス固有のクロスドメイン識別情報で、ファーストパーティの識別情報としてはほとんど価値がないので、コードで一般的に設定されていますが、cookie はほとんど使用されませんでした。

Web SDKへの移行後も、この aam_uuid Cookie を引き続き設定する必要がある実装の場合は、2 とおりの方法でAudience Manager UUID を取得できます。

1. Edge Network インタラクトエンドポイントからのすべての応答には、id ノードのペイロードが含まれます。 id 名前空間ペイロードの CORE ノードには、Audience Manager UUID が含まれます。

2. Web SDKの getIdentity コマンドを使用して取得します。 ドキュメントで説明されている CORE 名前空間を使用して、応答の identity.CORE フィールドから値を取得します。

Audience Manager UUID の取得に使用されるメソッドに関係なく、レスポンスの解析、UUID の取得、cookie の設定は、開発チームの責任です。 Web SDKを使用してこの Cookie を自動的に設定する方法はありません。