從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 命令。 我們需考慮三種情況：

• 頁面檢視追蹤：以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和非頁面檢視呼叫之間沒有個別的命令。 在裝載物件內提供該區別。

  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 您的網站上不再需要，可以移除此指令碼的所有參考。