Audience Managerのデータ収集ライブラリを、Audience Manager タグ拡張機能からWeb SDK タグ拡張機能に更新します

Adobe Experience Platform Data Collectionでデータストリームを作成するには、次の手順に従います。 このデータストリームにデータを送信すると、データはAudience Managerに転送されます。 将来的には、このデータストリームがデータをReal-Time CDPに転送します。

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

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

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

4. New Datastream​を選択します。

5. 目的の名前を入力し、Save​を選択します。

6. データストリームを作成したら、Add Service​を選択します。

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

8. 「Enable XDM Flattened Fields」オプションがオフになっていることを確認します。

   

これで、データストリームがAudience Managerにデータを受け取って渡す準備が整いました。

このセクションでは、次のステップで行われる移行作業の大部分に対してタグを準備します。

1. Adobe Experience Platform インターフェイスの左上にあるハンバーガーアイコンを選択し、Tags​を選択します。

2. 目的のタグプロパティを選択します。

3. タグプロパティの左側のナビゲーションで、Extensions​を選択します。

4. 上部の​ Catalog ​を選択すると、使用可能なすべての拡張機能のリストが表示されます。

5. Adobe Experience Platform Web SDK​拡張機能を検索して選択し、右側の​ Install ​を選択します。

   

6. 拡張機能の設定が表示されます。 Datastreams セクションを探し、使用しているサンドボックスと、前の手順で作成したデータストリームを選択します。

   

7. Save​を選択します。

タグプロパティにWeb SDKがインストールされました。

データオブジェクトデータ要素は、Web SDKがデータストリームに送信するために使用するペイロードを設定するための直感的なフレームワークを提供します。 次の手順で更新するほとんどのルールは、このデータ要素を操作します。

1. タグインターフェイスの左側のナビゲーションで、Data Elements​を選択します。

2. Add Data Element​を選択

3. データ要素に次の設定を指定します。

   • Name: 「データレイヤー」や「データオブジェクト」など、必要なものはすべて
   • Extension：Adobe Experience Platform Web SDK
   • Data Element Type：Variable
   • チェックボックスは、そのままにしておくことができます。

4. 右側で、次の設定を選択します。

   • プロパティ ラジオ ボタン：Data
   • Solution：Adobe Audience Manager

5. Save​を選択します。

   

タグプロパティには、各ルールの更新に必要なあらゆる情報が含まれています。

この手順では、Web SDKへの移行に必要な労力の大部分を確認できます。また、導入の仕組みについても把握する必要があります。 一般的なタグルールを編集する方法の例を以下に示します。 実装内のすべてのタグルールを更新して、Audience Manager拡張機能へのすべての参照をWeb SDK拡張機能に置き換えます。

1. タグインターフェイスの左側のナビゲーションで、Rules​を選択します。

2. 編集するルールを選択します。

3. アクション Audience Manager - Set Variables​を選択

4. このルール内で設定されたすべてのAudience Manager変数を記録します。 ドロップダウンメニューに設定された変数とカスタムコード内に設定された変数の両方を含めます。

5. Action Configurationを次の設定に変更します。

   • Extension：Adobe Experience Platform Web SDK
   • Action type：変数を更新

6. 手順3で作成したデータオブジェクトが、右側の​Data element フィールドのドロップダウンで選択されていることを確認します。

7. Audience Managerのキーと値のペアを、Audience Manager拡張機能で設定した値と同じ値に設定します。

8. Web SDK拡張機能を使用してすべてのルールロジックをレプリケートしたら、Keep Changes​を選択します。

9. Audience Manager タグ拡張機能を使用して値を設定するアクション設定ごとに、これらの手順を繰り返します。

上記の手順は、値を設定するルールにのみ適用されます。 次の手順は、Action Configuration Send Eventを使用するすべてのアクションを置き換えます。

1. Web SDK イベントを送信するルールを選択します。

2. アクションの種類​ Send Event ​を選択します。

3. Action Configurationを次の設定に変更します。

   • Extension：Adobe Experience Platform Web SDK
   • Action type：Send event

4. 右側で、アクション設定を次のように変更します。

   • Type: Web Webpagedetails Page Views​を使用してください。
   • Data：手順3で作成したデータオブジェクトを選択します。

5. Keep Changes​を選択します。

6. Audience Managerを使用してイベントを送信するアクション設定ごとに、これらの手順を繰り返します。

更新されたルールの公開は、タグ設定に対する他の変更と同じワークフローに従います。

1. タグインターフェイスの左側のナビゲーションで、Publishing Flow​を選択します。

2. Add Library​を選択します。

3. このタグに「Web SDKにアップグレード」などの名前を付けます。

4. Add All Changed Resources​を選択します。

5. Save​を選択します。

6. 公開ワークフローには、ビルド中であることを示すオレンジ色のドットが表示されます。 ドットが緑色に変わると、変更内容が開発環境で使用できるようになります。

7. 開発環境の変更をテストして、すべてのルールが適切に実行され、データオブジェクトに期待される値が入力されていることを確認します。

8. 準備ができたら、ライブラリを承認用に送信し、ステージング用にビルドし、最終的に承認して実稼動用に公開します。

   

タグ実装がWeb SDKに完全に移行されたら、Audience Manager拡張機能を無効にできます。

1. タグインターフェイスの左側のナビゲーションで、Extensions​を選択します。
2. Audience Manager拡張機能を探して選択します。 右側で、Disable​を選択します。
3. 上記と同じ公開ワークフローに従って、Audience Manager拡張機能の削除を公開します。
4. 拡張機能を実稼動環境で無効にすると、完全にアンインストールできます。 拡張機能を選択し、右側の3点メニューを選択し、Uninstall​を選択します。
5. 上記と同じ公開ワークフローに従って、これらの変更を実稼動環境に公開します。