從AppMeasurement移轉至Web SDK
此實作路徑涉及從AppMeasurement實作移轉至Web SDK JavaScript程式庫實作的方法式移轉方法。 其他實作路徑會在不同頁面上說明:
- Analytics擴充功能新增至Web SDK擴充功能:以順暢且系統的方式從Adobe Analytics標籤擴充功能移至Web SDK標籤擴充功能。 在您的組織準備好使用Adobe Experience Platform服務(例如Customer Journey Analytics)之前,此方法會抑制使用XDM的需求。 使用
data
物件而非xdm
物件以傳送資料給Adobe。 - Web SDK JavaScript程式庫:全新Web SDK安裝,使用Web SDK JavaScript程式庫(
alloy.js
)。 自行管理實作,而不使用標籤UI。 它需要Adobe Analytics ExperienceEvent欄位群組,其中包括要包含在XDM結構描述中的典型Analytics變數。 - Web SDK標籤擴充功能:全新的Web SDK安裝,您可使用Adobe Experience Platform資料彙集中的標籤管理實作。 它需要Adobe Analytics ExperienceEvent欄位群組,其中包括要包含在XDM結構描述中的典型Analytics變數。
此實作路徑的優缺點
使用此移轉方法的優缺點。 請仔細權衡每個選項,決定哪種方式最適合您的組織。
- 使用您現有的實施:雖然此方法需要一些實作變更,但不需要從頭開始全新的實作。 您可以使用現有的資料層和程式碼,只需對實作邏輯進行最低限度的變更。
- 不需要結構描述:針對移轉至Web SDK的這個階段,您不需要XDM結構描述。 反之,您可以填入
data
物件,會將資料直接傳送至Adobe Analytics。 一旦移轉至Web SDK完成,您就可以為貴組織建立結構描述,並使用資料流對應來填入適用的XDM欄位。 如果移轉流程的這個階段需要結構描述,貴組織將被強制使用Adobe Analytics XDM結構描述。 使用此結構描述會使您的組織未來更難以使用您自己的結構描述。
- 實作變更需要開發人員干預:如果您想要變更Web SDK實作,必須與開發團隊合作,編輯網站上的程式碼。 採用的方法 移轉至Web SDK標籤擴充功能 可避免此缺點。
- 實作技術債務:由於此方法使用您現有實施的修改形式,日後追蹤實施邏輯及執行變更時,可能會較困難。
- 需要對應才能將資料傳送至Platform:當您的組織準備好使用Customer Journey Analytics時,您必須將資料傳送至Adobe Experience Platform中的資料集。 此動作需要
data
物件是資料流對應工具中的專案,可將其指派給XDM結構描述欄位。 此工作流程只需對應一次,不需要變更實作。 不過,這是在XDM物件中傳送資料時不需要的額外步驟。
Adobe建議在下列情況下使用此實施路徑:
- 您已有使用Adobe AnalyticsAppMeasurementJavaScript程式庫的現有實作。 如果您有使用Adobe Analytics標籤擴充功能的實作,請依照 從Adobe Analytics標籤擴充功能移轉至Web SDK標籤擴充功能 而非。
- 您打算在未來使用Customer Journey Analytics,但不想從頭開始使用Web SDK實作來取代您的Analytics實作。 在Web SDK上從頭開始取代實作需要花費最大心力,但同時也提供最可行的長期實作架構。 如果您的組織願意徹底實施Web SDK,請參閱 透過Adobe Experience Platform Web SDK內嵌資料 在Customer Journey Analytics使用手冊中。
移轉至Web SDK所需的步驟
下列步驟包含需努力達成的具體目標。 按一下每個步驟,以取得如何完成的詳細指示。
在Adobe Experience Platform Data Collection中建立資料流。 當您傳送資料至此資料流時,它會轉送資料至Adobe Analytics。 未來,相同的資料流會將資料轉送給Customer Journey Analytics。
- 瀏覽至 experience.adobe.com 並使用您的憑證登入。
- 使用右上方的首頁或產品選擇器來導覽至 資料彙集.
- 在左側導覽中選取 資料串流.
- 選取「新資料流」。
- 輸入所要的名稱,然後選取 儲存.
- 建立資料流後,選取 新增服務.
- 在服務下拉式功能表中,選取 Adobe Analytics.
- 輸入與您目前傳送分析資料的目標網站相同的報表套裝ID。 按一下「儲存」。
您的資料流現在已準備好接收資料並傳遞給Adobe Analytics。 請記下資料串流ID,因為此ID在程式碼中設定Web SDK時是必要的。
alloy.js
因此可以使用其方法呼叫。 另請參閱 使用JavaScript程式庫安裝Web SDK 以取得詳細資訊和要使用的程式碼區塊。使用Web SDK將您的實作設定為指向上一步驟中建立的資料流 configure
命令。 此 configure
命令必須在每個頁面上設定,因此您可以將其與程式庫安裝程式碼一併納入。
使用 edgeConfigId
和 orgId
Web SDK中的屬性 configure
命令:
- 設定
edgeConfigId
與上一步驟中擷取的資料串流ID比對。 - 設定
orgId
至您組織的IMS組織。
code language-js |
---|
|
您可以選擇在中設定其他屬性 configure
會根據貴組織的實作需求執行命令。
變更您的Analytics實作,使其不依賴 AppMeasurement.js
或 s
物件。 請改為將變數設為格式正確的JavaScript物件,這會在傳送至Adobe時轉換為JSON物件。 擁有 資料層 在設定值時,您可在您的網站上獲得極大的協助,因為您可以繼續參考這些相同的值。
若要將資料傳送至Adobe Analytics,Web SDK裝載必須使用 data.__adobe.analytics
在此物件中設定所有analytics變數。 此物件中的變數與其AppMeasurement變數的對應變數具有相同的名稱和格式。 例如,如果您設定 products
變數,請勿像使用XDM時一樣將其分割為個別物件。 請改為將其加入為字串,準確地說,如果您將 s.products
變數:
code language-json |
---|
|
最終,此裝載包含所有所需值,以及 s
實作中的物件即會移除。 您可以使用JavaScript提供的任何資源來設定此裝載物件,包括點標籤法來設定個別值。
code language-js |
---|
|
更新您呼叫的所有執行個體 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
您的網站上不再需要,可以移除此指令碼的所有參考。
此時,您的Analytics實作已完全放在Web SDK上,並已為未來移至Customer Journey Analytics做好充分準備。