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 コマンドは、ライブラリのインストールコードと一緒に含めることができるように、すべてのページで設定する必要があります。

の使用 edgeConfigId および orgId web SDK 内のプロパティ configure コマンド：

• を edgeConfigId を前の手順で取得したデータストリーム ID に変更します。
• を orgId を組織の IMS 組織に送信します。

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

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

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

データをAdobe Analyticsに送信するには、Web SDK ペイロードがを使用する必要があります data.__adobe.analytics このオブジェクト内で設定されたすべての 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にデータを送信するための適切なリンクトラッキング変数が自動的に設定されます。 自動リンクトラッキングを無効にする場合は、このプロパティをに設定します。 false 内 configure コマンド。

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