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. Select 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. 実稼動環境で拡張機能を無効にすると、その拡張機能を完全にアンインストールできます。 拡張機能を選択し、右側の「。…」メニューを選択してから、「Uninstall」を選択します。
5. 上記と同じ公開ワークフローに従って、変更を実稼動環境に公開します。