AppMeasurementからWeb SDKへの移行

Adobe Experience Platform Data Collectionでデータストリームを作成します。 このデータストリームにデータを送信すると、データはAdobe Analyticsに転送されます。 将来的には、このデータストリームがデータをCustomer Journey Analyticsに転送します。

1. Adobe CX Enterpriseに移動し、資格情報を使用してログインします。
2. 右上のホームページまたは製品セレクターを使用して、データ収集​に移動します。
3. 左側のナビゲーションで、データストリーム​を選択します。
4. 新しいデータストリーム​を選択します。
5. 目的の名前を入力し、保存​を選択します。
6. データストリームを作成したら、サービスを追加​を選択します。
7. サービス ドロップダウンメニューで、Adobe Analytics​を選択します。
8. 現在Analytics データを送信しているサイトと同じレポートスイート IDを入力します。 「保存」をクリックします。

これで、データストリームがAdobe Analyticsにデータを受け取って渡す準備が整いました。 コードでWeb SDKを設定する場合は、このIDが必要なので、データストリーム IDに注意してください。

Web SDK configure コマンドを使用して、前の手順で作成したデータストリームを指すように実装を設定します。 configure コマンドは、すべてのページで設定する必要があります。これにより、ライブラリのインストールコードと一緒に含めることができます。

Web SDK configure コマンド内でdatastreamIdおよびorgId プロパティを使用します。

• datastreamIdを、前の手順で取得したデータストリーム IDに設定します。
• 組織のIMS組織にorgIdを設定します。

alloy("configure", {
    datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
    orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg"
});

組織の実装要件に応じて、configure コマンドで他のプロパティをオプションで設定できます。

Analyticsの実装を変更して、AppMeasurement.jsまたはs オブジェクトに依存しないようにします。 代わりに、変数を正しい形式のJavaScript オブジェクトに設定し、Adobeに送信するとJSON オブジェクトに変換します。 サイトに​ データレイヤーを設定すると、同じ値を引き続き参照できるため、値を設定する際に非常に役立ちます。

Adobe Analyticsにデータを送信するには、Web SDK ペイロードで、このオブジェクト内で設定されているすべての分析変数でdata.__adobe.analyticsを使用する必要があります。 このオブジェクト内の変数は、AppMeasurement変数と同じ名前と形式を共有します。 例えば、products変数を設定する場合は、XDMと同様に個々のオブジェクトに分割しないでください。 代わりに、s.products変数を設定する場合は、文字列として正確に含めます。

{
  "data": {
    "__adobe": {
      "analytics": {
        "products": "Shoes,Men's sneakers,1,49.99"
      }
    }
  }
}

最終的には、このペイロードにはすべての必要な値が含まれ、実装内のs オブジェクトへのすべての参照が削除されます。 このペイロードオブジェクトを設定するには、JavaScriptの任意のリソース（個々の値を設定するためのドット表記法を含む）を使用できます。

// Define the payload and set objects within it
var dataObj = {data: {__adobe: {analytics: {}}}};
dataObj.data.__adobe.analytics.pageName = window.document.title;
dataObj.data.__adobe.analytics.eVar1 = "Example value";

// Alternatively, set values in an object and use a spread operator to achieve identical results
var a = new Object;
a.pageName = window.document.title;
a.eVar1 = "Example value";
var dataObj = {data:{__adobe:{analytics:{...a}}}};

s.t()とs.tl()を呼び出すすべてのインスタンスを更新し、sendEvent コマンドに置き換えます。 考慮すべきシナリオは3つあります。

• ページビュートラッキング: ページビュートラッキング呼び出しをWeb SDK sendEvent コマンドに置き換えます。

  code language-js
  // If your current implementation has this line of code: s.t(); // Replace it with this line of code. The dataObj object contains the variables to send. alloy("sendEvent", dataObj);

• 自動リンクトラッキング: clickCollectionEnabled設定プロパティはデフォルトで有効になっています。 Adobe Analyticsにデータを送信するための正しいリンクトラッキング変数が自動的に設定されます。 自動リンクトラッキングを無効にする場合は、configure コマンド内でこのプロパティをfalseに設定します。

• 手動リンクトラッキング: Web SDKには、ページビュー呼び出しと非ページビュー呼び出しの間に個別のコマンドがありません。 ペイロードオブジェクト内でその区別を提供します。

  code language-js
  // If your current implementation has this line of code: s.tl(true,"o","Example custom link"); // Replace it with these lines of code. Add the required fields to the dataObj object. dataObj.data.__adobe.analytics.linkName = "Example custom link"; dataObj.data.__adobe.analytics.linkType = "o"; dataObj.data.__adobe.analytics.linkURL = "https://example.com"; alloy("sendEvent", dataObj);

AppMeasurementとs オブジェクトへの参照をすべて削除したら、変更内容を開発環境に公開して、新しい実装が機能することを検証します。 すべてが正しく機能することを検証したら、更新を実稼動環境に公開できます。

正しく移行された場合、AppMeasurement.jsはサイト上で不要になり、このスクリプトへのすべての参照を削除できます。