タグを使用したAdobe AnalyticsのWeb SDKへの移行
Experience Platform Tags （旧Launch）のAnalytics拡張機能を使用して、Adobe Analyticsの実装をWeb SDKに移行する手順を説明します。また、TagsでもWeb SDK拡張機能を使用します。 TagsのAdobe Analytics拡張機能を使用する場合、バックグラウンドでは「AppMeasurement.js」コードが使用されています。 したがって、これはAppMeasurementをWeb SDKに移行するチュートリアルと考えることができますが、このチュートリアルは完全にタグに含まれており、JavaScript実装との間の移行については説明しません（タグ UI内で使用されるJavaScript コードを除く）。 JavaScript実装の移行については、 ドキュメント を参照してください。
このチュートリアルの内容
Analytics実装を移行する手順に入る前に、Analytics用の 実装 を変更または更新する作業について正確に理解することが重要です。 このチュートリアルの最後に、レポートを確認し、すべてが同じである場合は、「なぜ私はそれをしたのですか？」と自問するかもしれません。 Analyticsの導入にWeb SDKを使用するメリットを説明する文書は他にもありますが、次のようなものがあります。
- ファーストパーティデバイス IDのサポート
- パフォーマンスの向上
- Adobe Experience Platform アプリケーションの使用に向けて導入する際の将来性の確認（新しいユースケースの実現）
Web Adobe Analyticsがどのように役立つかについて詳しくは、SDK担当者にお問い合わせください。 このチュートリアルを進める中で、移行を実行する 方法 に焦点を当てます。
移行方法
移行プロセスを実行する方法はたくさんありますが、ここでは2つについて説明する必要があります。
方法1:既存のTags プロパティをWeb SDKに更新し、新しいデータ要素を作成し、プロパティに既に存在するルールを変更します。
方法2:新しいプロパティを作成し（既存のプロパティをコピーするか、新しいプロパティを1つ作成する）、その新しいプロパティをAdobe Analytics拡張機能の代わりにWeb SDKで設定することもできます。
この移行チュートリアルでは、方法1を使用します。 これにより、プロパティに関連付けられた埋め込みコードは、開発、ステージング、実稼動の各サイトにすでに埋め込まれているため、埋め込みコードを変更する必要はありません。 メソッド 2を使用する場合は、新しいプロパティの環境 セクションから各環境の新しい埋め込みコードを取得し、サイトのヘッドセクションに配置することを忘れないでください。
念のために、気をつけるのはいいことです。 次に、プロパティのコピーを作成します。 あなたが帰ってくるまでここで待っています。
Analytics実装をWeb SDKに移行する手順
手順を進めるにつれ、理解すべき重要な注意事項がいくつかあります。
- まず、これらのステップがすべて必要な場合とそうでない場合があります。 例えば、カスタムコードの移行に関するレッスンがあります。 カスタムコードを使用しないタグ実装（プラグインの使用を含む）がある場合、このレッスンは必要ありません。 ほとんどのユーザーが必要とするレッスンを含めようとしたので、少なくともレッスンを読んで、移行中にサイトを調整する必要があるかどうかを確認してください。
- また、誰もが使用しているユースケースの100%をカバーする移行チュートリアルを作成する方法はありません。 前の項目で述べたように、私たちはほとんどの人が必要とする教訓を含めようとしました、そしてそれは主なユースケースのほとんどをカバーするでしょう。 ただし、このチュートリアルでは取り上げられていないユースケースが存在することは間違いありません。 このケースでは、付属のレッスンで、ユースケースに移行する方法について適切に判断できるかどうかを確認します。 Experience League コミュニティの他のユーザーにデータ収集を依頼することもできます。
移行プロセスでは、次の重要な手順を実行します。
- 移行検証レポートスイートを作成します。
- データストリームの作成と設定。
- タグ（旧Adobe Launch）でWeb SDK拡張機能を追加して設定します。
- Web SDK経由でデータを送信するための新しいデータ要素を作成します。
- Web SDK データ要素とアクションを使用するには、デフォルトのページ読み込みルールを移行します。
- ルールまたはプラグインのカスタムコードを移行します。
- 実装の変更を公開します。
- 変更をデバッグおよび検証する方法と、デフォルトのページ読み込みルールとそれに関連する変数を検証する方法について説明します。 この検証は、変更を行っても移行を通して続行されます。
- 追加のページ読み込みルールの移行。
- カスタムリンクルールの移行。
- 完全検証後、Analytics拡張機能への参照を削除し、拡張機能自体を削除します。
- すべての変更を行った後、ライブラリをステージングにプッシュし、次に実稼動にプッシュします。
- すべてが完了したら、もう一度テストします。 これは、古いAnalytics コードへの参照を削除して変更を行ったため、すべてが正しく動作していることを確認する必要があります。