從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 configure命令中使用datastreamId和orgId屬性：

• 將datastreamId設定為在上一步中擷取的資料串流識別碼。
• 將orgId設定為您組織的IMS組織。

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

• 頁面檢視追蹤：以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在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，而且可移除此指令碼的所有參考。