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

1.Analyticsの移行を計画します。

Analytics チームと協力して、TagsまたはJavaScript ベースの実装でのAnalytics移行の手順に従います。 Analyticsへの移行を計画したら、このガイドに戻ってAudience Managerの手順に進み、AnalyticsとAudience Managerへの移行を一緒にデプロイできるように、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
   「Enabled XDM Flattened Fields」オプションを有効にしてWeb SDKに移行するには、Audience Managerで必要なデータをXDMとしてフォーマットし、prop、eVar、またはイベントを使用するすべてのAudience Manager特性を更新して、代わりにXDM形式のデータを検索する必要があります。 Adobeでは、このオプションを無効にすることをお勧めします。

   

9. データストリーム設定を保存するには、Save​を選択します。

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

3.サードパーティ IDの同期を有効にし、Audience Manager Container ID​を設定します

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

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

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

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

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

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

   

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

Web SDKでは、これらのIDをIdentityMapという特殊なXDM コンストラクトを使用してEdge Networkに送信する必要があります。

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

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

5.（オプション） 1st パーティ aam_uuid Cookie​を設定

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

Cookieを設定するには、Analytics タグ拡張機能の​Name セクションの​Unique User ID Cookie フィールドまたはuuidCookieの設定時にaudienceManagementModule フィールドにCookie名を入力する必要があります。 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を自動的に設定する方法はありません。