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

Last update: Mon Jul 22 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 を使用する必要がなくなります。データをAdobeに送信するには、xdm オブジェクトではなく data オブジェクトを使用します。
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 extension to Web SDK extension と Extension to 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 （datastreamId））、組織 ID （orgId）、その他の使用可能なオプションで適切に設定されていることを確認します。変数が適切にマッピングされていることを確認します。

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

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

イベントの送信

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

recommendation-more-help

b4f6d761-4a8b-4322-b801-c85b9e3be690