AppMeasurementから Web SDKへの移行

Adobe Experience Platform Data Collection にデータストリームを作成します。 このデータストリームにデータを送信すると、データがAdobe Analyticsに転送されます。 今後、この同じデータストリームがCustomer Journey Analyticsにデータを転送します。

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

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

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

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

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

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

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

AppMeasurement.js や s オブジェクトに依存しないように、Analytics 実装を変更します。 代わりに、正しい形式の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にデータを送信するための適切なリンクトラッキング変数が自動的に設定されます。 自動リンクトラッキングを無効にする場合は、falseconfigure コマンド内でこのプロパティを ​ に設定します。

• 手動のリンクトラッキング:web SDKには、pageview 呼び出しと非 pageview 呼び出しの間に別のコマンドはありません。 ペイロードオブジェクト内でその区別をしてください。

  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 はサイトで不要になり、このスクリプトへのすべての参照を削除できます。