Web SDK を使用したAdobe Analyticsへのデータの送信
作成対象：
- 開発者
Experience PlatformWeb SDK は、Experience PlatformEdge Networkを介してAdobe Analyticsにデータを送信できます。 Adobeでは、Web SDK を使用してAdobe Analyticsにデータを送信するためのいくつかのオプションを提供しています。
- Adobe Analytics ExperienceEvent フィールドグループ をスキーマに追加してから、
XDMオブジェクトを使用します。 dataオブジェクトを使用してXDM スキーマを使用せずにAdobe Analyticsにデータを送信します。- 自動生成された コンテキストデータ変数および 処理ルールを使用します。
XDM オブジェクトの使用
Adobe Analyticsに特有の事前定義済みスキーマを使用する場合は、Adobe Analytics ExperienceEvent スキーマフィールドグループをスキーマに追加できます。 追加したら、Web SDK の xdm オブジェクトを使用してこのスキーマにデータを入力し、レポートスイートにデータを送信できます。 Edge Networkにデータが到達すると、XDM オブジェクトがAdobe Analyticsで認識できる形式に変換されます。
Web SDK を使用してAdobe Analyticsにデータを送信する方法は 2 つあります。
XDM フィールドの詳細とAdobe Analytics変数へのマッピング方法については、Adobe Analytics実装ガイドの XDM オブジェクト変数の Analytics へのマッピングを参照してください。
data オブジェクトの使用
XDM オブジェクトを使用する代わりに、データオブジェクトを使用することもできます。 データオブジェクトは、現在AppMeasurementを使用している実装に向けられているので、Web SDK へのアップグレードがはるかに容易になります。
Web SDK への移行方法の詳細については、AppMeasurementと Analytics タグ拡張機能のどちらを使用しているかにより、次のガイドを参照してください。
データオブジェクトフィールドの完全なリファレンスとAdobe Analytics変数へのマッピング方法については、Adobe Analytics実装ガイドの Analytics へのデータオブジェクト変数のマッピングに関するドキュメントを参照してください。
コンテキストデータ変数の使用
自動的にマッピングされない変数は、 コンテキストデータ変数として使用できます。 その後、 処理ルールを使用して、コンテキストデータ変数を Analytics 変数にマッピングできます。 例えば、次のようなカスタム XDM スキーマがあるとします。
{
"xdm": {
"key":"value",
"animal": {
"species": "Raven",
"size": "13 inches"
},
"array": [
"v0",
"v1",
"v2"
],
"objectArray":[{
"ad1": "300x200",
"ad2": "60x240",
"ad3": "600x50"
}]
}
}
その後、これらのフィールドは、処理ルールインターフェイスで使用できるコンテキストデータキーになります。
a.x.key //value
a.x.animal.species //Raven
a.x.animal.size //13 inches
a.x.array.0 //v0
a.x.array.1 //v1
a.x.array.2 //v2
a.x.objectarray.0.ad1 //300x200
a.x.objectarray.1.ad2 //60x240
a.x.objectarray.2.ad3 //600x50
FAQ
Adobe AnalyticsのAppMeasurementでは、ページビューの呼び出し（t() メソッド）とリンクトラッキングコールの呼び出し（tl() メソッド）が別々に使用されます。 代わりに、Web SDK は、ページビューとリンクトラッキングの両方を送信するための sendEvent コマンドのみを提供します。 イベントに含めるデータによって、そのデータがAdobe Analyticsの ページビューまたは ページイベントかどうかが決まります。
デフォルトでは、すべてのイベントは、Adobe Analyticsではページビューと見なされます。 Web SDK イベントをAdobe Analytics リンクトラッキング呼び出しに設定する場合は、次のフィールドを設定します。
- XDM オブジェクト:
xdm.web.webInteraction.name、web.webInteraction.type、web.webInteraction.URL - データオブジェクト:
data.__adobe.analytics.linkName、data.__adobe.analytics.linkTypeおよびdata.__adobe.analytics.linkURL - コンテキストデータ：サポートされていません
詳しくは 🔗Adobe Analytics導入ガイドの tl() メソッドを参照してください。
configure コマンドで clickCollectionEnabled を有効にすると、これらのフィールドに値が設定されます。
データストリームに送信されたすべてのイベントは、設定済みのすべてのサービスに渡されます。 例えば、パーソナライゼーションと Analytics に対して個別の呼び出しを行う場合、両方のイベントが Analytics と Target に送信されます。 これらのイベントは、Analytics レポートに記録され、バウンス率などの指標に影響を与える可能性があります。
Web SDK を使用する場合、通常、これらの呼び出しは sendEvent コマンドで組み合わされます。