Web SDK JavaScript ライブラリを使用したAdobe Analyticsへのデータの送信

Last update: Thu Apr 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

ユーザー
管理者

この実装パスには、Web SDK JavaScript ライブラリを使用した新規 Web SDK インストールが含まれます。その他の実装パスについては、次の別のページで説明しています。

Web SDK タグ拡張機能:Web SDK タグ拡張機能を使用した新規 Web SDK インストール。 Web SDK JavaScript ライブラリのアプローチ（このページ）と同様に、Adobe Experience Platform Data Collection のタグを使用して実装を管理する点が異なります。これには、XDM スキーマに含める一般的な Analytics 変数を含むAdobe Analytics ExperienceEvent フィールドグループが必要です。
Analytics 拡張機能から Web SDK 拡張機能へ:Adobe Analytics タグ拡張機能から Web SDK タグ拡張機能に移行するためのスムーズで系統的なアプローチを採用します。このアプローチにより、Customer Journey AnalyticsなどのAdobe Experience Platform サービスを使用する準備が整うまで XDM を使用する必要がなくなります。の使用 data の代わりにのオブジェクト xdm Adobeにデータを送信するオブジェクト。
Web SDK JavaScript ライブラリのAppMeasurement：タグを使用しない点を除き、Web SDK に移行するためのスムーズで系統立ったアプローチ。代わりに、Adobe Analytics データ収集ライブラリ（AppMeasurement.js）を選択し、Web SDK JavaScript ライブラリ（alloy.js）に設定します。

この実装パスのメリットとデメリット

Web SDK JavaScript ライブラリを使用してAdobe Analyticsにデータを送信する場合、メリットとデメリットの両方があります。各オプションを慎重に検討し、組織に最適なアプローチを決定します。

メリット

デメリット

直接アプローチ：この実装パスは、既存のAdobe Analytics実装を移行するアプローチよりも簡単です。現在Adobe Analyticsの実装を心配する必要がない場合は、該当する Web SDK XDM フィールドに値を入力します。
定義済みスキーマ：組織で独自のスキーマが必要ない場合は、Adobe Analytics向けのスキーマを使用するだけです。この概念は、Customer Journey Analyticsに向かう途中でも当てはまります。prop と eVar の概念はCustomer Journey Analyticsには当てはまりませんが、prop と eVar を単純なカスタムディメンションとして引き続き使用できます。

実装を変更するには、開発者の介入が必要です:Web SDK 実装を変更する場合は、開発チームと協力してサイトのコードを編集する必要があります。を使用するアプローチ Web SDK タグ拡張機能この欠点を回避します。
特定のスキーマを使用してにロック：組織がCustomer Journey Analyticsに移行する場合、Adobe Analytics スキーマを引き続き使用するか、独自の組織のスキーマ（個別のデータセット）に移行するかを選択する必要があります。 Customer Journey Analyticsへの移行時にAdobe Analytics スキーマと個別のデータセットへの移行の両方を避けたい場合、Adobeでは次の 2 つの方法のいずれかを推奨します。
- の使用 data オブジェクト：です data オブジェクトを使用すると、XDM スキーマに準拠せずにAdobe Analyticsにデータを送信できます。組織のスキーマが作成されたら、データストリームマッピングを使用してマッピングできます data オブジェクトフィールドを XDM に変換します。両方 Analytics 拡張機能から Web SDK 拡張機能へおよび Web SDK JavaScript ライブラリのAppMeasurement これを使用 data オブジェクト。
- Adobe Analyticsを完全にスキップする：Web SDK を実装している場合は、そのデータをAdobe Experience Platformのデータセットに送信して、Customer Journey Analyticsで使用できます。任意のスキーマを使用できます。Adobe Analyticsは、このワークフローにはまったく関与しないので、Adobe Analytics ExperienceEvent フィールドグループは必要ありません。この方法では、最低限の技術的負債しか発生しませんが、Adobe Analyticsは完全に全体像から外れています。

IMPORTANT

この実装方法では、Adobe Analytics用に設定されたスキーマを使用する必要があります。今後、組織がCustomer Journey Analyticsで独自のスキーマを使用する予定がある場合、Adobe Analytics スキーマを使用すると、データ管理者やアーキテクトの混乱を招く可能性があります。この障害を軽減するには、いくつかの選択肢があります。

CJA では、Adobe Analytics スキーマを使用できます。 CJA には prop や eVar の概念がなく、他のスキーマフィールドとして扱われます。また、CJA でAdobe Analytics スキーマを使用すると、Adobe Journey OptimizerやReal-time Customer Data Platformなどの他のプラットフォームサービスを使用するのが難しくなる場合があります。
移行ワークフローと同様に、データオブジェクトを使用できます。なお、データオブジェクトを使用するには、各データオブジェクトフィールドを XDM スキーマフィールドにマッピングする必要があります。
Adobe Analyticsの実装を完全にスキップし、独自のスキーマを使用してAdobe Experience Platformにデータを送信できます。このアプローチは理想的な長期的アプローチで、組織がCustomer Journey Analyticsを使い始めることができます。

Web SDK JavaScript ライブラリを実装するために必要な手順

実装タスクの大まかな概要：

Web SDK ワークフローを使用してAdobe Analyticsを実装する方法について詳しくは、この節を参照してください。

タスク

詳細情報

レポートスイートを定義 したことを確認します。

レポートスイートマネージャー

スキーマの設定. Adobe Experience Platform を活用するアプリケーション間で使用するデータ収集を標準化するために、アドビはオープンで公的に文書化された標準である Experience Data Model（XDM）を作成しました。

スキーマ UI の概要

データレイヤーを作成 して、web サイト上のデータのトラッキングを管理します。

データレイヤーの作成

事前ビルドスタンドアロンバージョンをインストールします。CDN のライブラリ（alloy.js）をページで直接参照するか、ダウンロードして独自のインフラストラクチャにホストすることができます。または、NPM パッケージを使用することもできます。

事前ビルドスタンドアロンバージョンのインストールおよびNPM パッケージの使用

データストリームを設定 します。データストリームは、Adobe Experience Platform Web SDK を実装する際のサーバーサイド設定を表します。

データストリームの設定

データストリームに Adobe Analytics サービス を追加します。このサービスは、データをAdobe Analyticsに送信するかどうかと、どのように送信するか、および具体的にどのレポートスイートに送信するかを制御します。

データストリームへの Adobe Analytics サービスの追加

Web SDK を設定 します。手順 4 でインストールしたライブラリが、データストリーム ID （以前のエッジ設定 ID （）で適切に設定されていることを確認します。edgeConfigId））、組織 id （orgId）、およびその他の使用可能なオプションです。変数が適切にマッピングされていることを確認します。

Web SDK の設定
XDM オブジェクト変数のマッピング

コマンドを実行 したり、イベントを追跡 したりします。Web ページにベースコードが実装されたら、SDK を使用してコマンドの実行とイベントの追跡を開始できます。

イベントの送信

実装を実稼動環境にプッシュする前に、実装を拡張して検証します。

recommendation-more-help

b4f6d761-4a8b-4322-b801-c85b9e3be690