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