Adobe Analytics タグ拡張機能からWeb SDK タグ拡張機能への移行
この実装パスでは、Adobe Analytics タグ拡張機能からWeb SDK タグ拡張機能に移行するための体系的な移行アプローチを行います。 その他の実装パスについては、別のページで説明しています。
- AppMeasurementからWeb SDKへのJavaScript ライブラリ : タグを使用しない場合を除き、Web SDKにスムーズかつ計画的に移行するアプローチです。 代わりに、Adobe Analytics データ収集ライブラリ (
AppMeasurement.js)を手動で削除し、Web SDK JavaScript ライブラリ (alloy.js)に置き換えます。 - Web SDK タグ拡張機能: Adobe Experience Platform Data Collectionのタグを使用して実装を管理する新しいWeb SDK インストール。 XDM スキーマに含める一般的なAnalytics変数を含むAdobe Analytics ExperienceEvent フィールドグループが必要です。
- Web SDK JavaScript ライブラリ : Web SDK JavaScript ライブラリ (
alloy.js)を使用した新しいWeb SDK インストール。 タグ UIを使用する代わりに、実装を自分で管理します。 XDM スキーマに含める一般的なAnalytics変数を含むAdobe Analytics ExperienceEvent フィールドグループが必要です。
この実装パスの利点と欠点
この移行アプローチを使用すると、利点と欠点の両方があります。 各オプションを慎重に検討し、自社に最適なアプローチを選びましょう。
- サイトでコードの変更はありません:実装には既にタグがインストールされているため、すべての移行の更新はタグインターフェイスで行うことができます。
- 既存の実装を使用:このアプローチでは、新たに実装する必要はありません。 新しいルールアクションは必要ですが、既存のデータ要素とルール条件を最小限の変更で再利用できます。
- スキーマは必要ありません: Web SDKに移行するこの段階では、XDM スキーマは必要ありません。 代わりに、
dataオブジェクトを設定して、データをAdobe Analyticsに直接送信できます。 Web SDKへの移行が完了したら、組織のスキーマを作成し、データストリームマッピングを使用して該当するXDM フィールドに入力できます。 移行プロセスのこの段階でスキーマが必要な場合、Adobe Analytics XDM スキーマの使用が強制されます。 このスキーマを使用すると、組織が将来、独自のスキーマを使用することがより困難になります。
- 実装の技術的負債:このアプローチでは、既存の実装の変更された形式を使用するため、実装ロジックを追跡したり、必要に応じて変更を実行したりすることが困難になる可能性があります。 カスタムコードは、特にデバッグが難しい場合があります。
- Platform にデータを送信するにはマッピングが必要:組織で Customer Journey Analytics を使用する準備が整ったら、Adobe Experience Platform のデータセットにデータを送信する必要があります。 このアクションでは、
dataオブジェクトのすべてのフィールドが、XDM スキーマフィールドに割り当てるデータストリームマッピングツールのエントリである必要があります。 このワークフローではマッピングを 1 回行うだけで済み、実装を変更する必要がありません。 ただし、これは、XDM オブジェクトでデータを送信する際には必要ない追加の手順です。
Adobeでは、次のシナリオでこの実装パスに従うことをお勧めします。
- Adobe Analytics タグ拡張機能を使用した既存の実装があります。 AppMeasurementを使用して実装を行う場合は、AppMeasurementからWeb SDKへの移行に従ってください。
- 今後はCustomer Journey Analyticsを使用する予定ですが、Analyticsの実装をゼロからWeb SDKの実装に置き換えることはお勧めしません。 Web SDKの実装をゼロから置き換えるには、最も多くの労力が必要ですが、長期にわたって実行可能な実装アーキテクチャも提供します。 クリーンなWeb SDKの導入を進める場合は、Customer Journey Analytics ユーザーガイドの「Adobe Experience Platform Web SDKを介してデータを取り込む」を参照してください。
Web SDKへの移行に必要な手順
次のステップは、取り組むべき具体的な目標を含んでいます。 各ステップをクリックすると、その方法の詳細な手順が表示されます。
Adobe Experience Platform Data Collectionでデータストリームを作成します。 このデータストリームにデータを送信すると、データはAdobe Analyticsに転送されます。 将来的には、このデータストリームがデータをCustomer Journey Analyticsに転送します。
- Adobe CX Enterpriseに移動し、資格情報を使用してログインします。
- 右上のホームページまたは製品セレクターを使用して、データ収集に移動します。
- 左側のナビゲーションで、データストリームを選択します。
- 新しいデータストリームを選択します。
- 目的の名前を入力し、保存を選択します。
- データストリームを作成したら、サービスを追加を選択します。
- サービス ドロップダウンメニューで、Adobe Analyticsを選択します。
- 現在Analytics データを送信しているサイトと同じレポートスイート IDを入力します。 「保存」をクリックします。
これで、データストリームがAdobe Analyticsにデータを受け取って渡す準備が整いました。
このセクションでは、次のステップで行われる移行作業の大部分に対してタグを準備します。
-
Adobe Experience Platform インターフェイスの左上にあるハンバーガーアイコンをクリックし、「タグ」を選択します。
-
目的のタグプロパティを選択します。
-
タグプロパティの左側のナビゲーションで、拡張機能を選択します。
-
上部の カタログ を選択すると、使用可能なすべての拡張機能のリストが表示されます。
-
Adobe Experience Platform Web SDK拡張機能を検索して選択し、右側の インストール をクリックします。
-
拡張機能の設定が表示されます。 「データストリーム」セクションを探し、前の手順で作成したデータストリームを選択します。
-
「保存」を選択します。
タグプロパティにWeb SDKがインストールされました。
データオブジェクトデータ要素は、Web SDKがデータストリームに送信するために使用するペイロードを設定するための直感的なフレームワークを提供します。 次の手順で更新するほとんどのルールは、このデータ要素を操作します。
-
タグインターフェイスの左側のナビゲーションで、データ要素を選択します。
-
「データ要素を追加」を選択
-
データ要素に次の設定を指定します。
- 名前: 「データレイヤー」や「データオブジェクト」など、必要なものをすべて選択します
- 拡張機能: Adobe Experience Platform Web SDK
- データ要素タイプ : 変数
- チェックボックスをそのまま使用できます
-
右側で、次の設定を選択します。
- プロパティ ラジオ ボタン: データ
- 解決策:Adobe Analytics
-
「保存」を選択します。
タグプロパティには、各ルールの更新に必要なあらゆる情報が含まれています。
この手順では、Web SDKへの移行に必要な労力の大部分を確認できます。また、導入の仕組みについても把握する必要があります。 典型的なタグルールの編集方法の例として、次に例を示します。 実装内のすべてのタグルールを更新して、Adobe Analytics拡張機能へのすべての参照をWeb SDK拡張機能に置き換えます。
-
タグインターフェイスの左側のナビゲーションで、ルールを選択します。
-
編集するルールを選択します。
-
アクション Adobe Analytics - Set Variablesを選択します
-
このルール内で設定されたすべてのAnalytics変数を記録します。 ドロップダウンメニューに設定された変数とカスタムコード内に設定された変数の両方を含めます。
-
アクション設定を次の設定に変更します。
- 拡張機能: Adobe Experience Platform Web SDK
- アクションの種類:変数を更新
-
右側のドロップダウンでデータオブジェクトが選択されていることを確認します。
-
Analytics変数を、Analytics拡張機能で設定した値と同じ値に設定します。
- タグインターフェイス内で設定された変数は、同じ値に直接変換できます。
- カスタムコード内で設定された文字列変数は、最小限の調整で済みます。
sオブジェクトを使用する代わりに、data.__adobe.analyticsを使用してください。 例えば、s.eVar1はdata.__adobe.analytics.eVar1に変換されます。 - カスタムコード内のAnalytics設定変数とメソッド呼び出しには、変更された実装ロジックが必要になる場合があります。 Web SDKを使用して同等の値を達成する方法については、それぞれの変数を参照してください。
-
Web SDK拡張機能を使用してすべてのルールロジックをレプリケートしたら、変更を保持を選択します。
-
Adobe Analytics拡張機能を使用して値を設定するアクション設定ごとに、これらの手順を繰り返します。 この手順には、タグインターフェイスを使用して設定された変数と、カスタムコードを使用して設定された変数の両方が含まれます。 カスタムコードブロックは、どこでも
sオブジェクトを参照することはできません。
上記の手順は、値を設定するルールにのみ適用されます。 次の手順は、 アクション設定 送信ビーコン を使用するすべてのアクションを置き換えます。
-
ビーコンを送信するルールを選択します。
-
「Adobe Analytics - ビーコンを送信」アクションを選択します。
-
アクション設定を次の設定に変更します。
- 拡張機能: Adobe Experience Platform Web SDK
- アクションの種類: イベントの送信
-
右側で、アクション設定を次のように変更します。
-
「変更を保持」を選択します。
-
Adobe Analyticsを使用してビーコンを送信するアクション設定ごとに、これらの手順を繰り返します。
更新されたルールの公開は、タグ設定に対する他の変更と同じワークフローに従います。
- タグインターフェイスの左側のナビゲーションで、公開フローを選択します。
- 「ライブラリを追加」を選択します。
- このタグに「Web SDKにアップグレード」などの名前を付けます。
- 「変更されたすべてのリソースを追加」を選択します。
- 「保存」を選択します。
- 公開ワークフローには、ビルド中であることを示すオレンジ色のドットが表示されます。 ドットが緑色に変わると、変更内容が開発環境で使用できるようになります。
- 開発環境の変更をテストして、すべてのルールが適切に実行され、データオブジェクトに期待される値が入力されていることを確認します。
- 準備ができたら、ライブラリを承認用に送信し、ステージング用にビルドし、最終的に承認して実稼動用に公開します。
タグの実装がWeb SDKで完全に完了したら、Adobe Analytics拡張機能を無効にできます。
- タグインターフェイスの左側のナビゲーションで、拡張機能を選択します。
- Adobe Analytics拡張機能を探して選択します。 右側の「無効化」を選択します。
- 上記と同じ公開ワークフローに従って、Adobe Analytics拡張機能の削除を公開します。
- 拡張機能を実稼動環境で無効にすると、完全にアンインストールできます。 拡張機能を選択し、右側の3点メニューを選択し、アンインストールを選択します。
- 上記と同じ公開ワークフローに従って、これらの変更を実稼動環境に公開します。
現時点では、Adobe Analyticsの実装はWeb SDK上で完了しており、今後Customer Journey Analyticsに移行するための準備は十分に整っています。