從Adobe Analytics標籤擴充功能移轉至Web SDK標籤擴充功能
此實作路徑涉及從Adobe Analytics標籤擴充功能移轉至Web SDK標籤擴充功能的方法。 其他實作路徑會在不同頁面上說明:
- AppMeasurement至Web SDK JavaScript資料庫:移轉至Web SDK的流暢且有條不紊的方法,但不使用標籤。 請改為手動移除Adobe Analytics資料收集程式庫(
AppMeasurement.js
),並將其取代為Web SDK JavaScript程式庫(alloy.js
)。 - Web SDK標籤擴充功能:全新的Web SDK安裝,您可使用Adobe Experience Platform資料彙集中的標籤來管理實作。 它需要Adobe Analytics ExperienceEvent欄位群組,其中包括要包含在XDM結構描述中的典型Analytics變數。
- Web SDK JavaScript程式庫:使用Web SDK JavaScript程式庫(
alloy.js
)的全新Web SDK安裝。 自行管理實作,而不使用標籤UI。 它需要Adobe Analytics ExperienceEvent欄位群組,其中包括要包含在XDM結構描述中的典型Analytics變數。
此實作路徑的優缺點
使用此移轉方法的優缺點。 請仔細權衡每個選項,決定哪種方式最適合您的組織。
- 您的網站上沒有程式碼變更:因為您的實作已安裝標籤,所以可以在標籤介面中進行所有移轉更新。
- 使用您現有的實作:此方法不需要全新實作。 雖然這確實需要新的規則動作,但您可以以最小的變更重複使用現有的資料元素和規則條件。
- 不需要結構描述:對於移轉至Web SDK的這個階段,您不需要XDM結構描述。 相反地,您可以填入
data
物件,這會直接將資料傳送到Adobe Analytics。 一旦移轉至Web SDK完成,您就可以為貴組織建立結構描述,並使用資料流對應來填入適用的XDM欄位。 如果移轉流程的這個階段需要結構描述,貴組織將被強制使用Adobe Analytics XDM結構描述。 使用此結構描述會使您的組織未來更難以使用您自己的結構描述。
- 實作技術債:由於此方法使用您現有實作的修改形式,因此可能更難追蹤實作邏輯並在需要時執行變更。 自訂程式碼可能特別難以偵錯。
- 需要對應才能將資料傳送至Platform:當您的組織準備使用Customer Journey Analytics時,您必須將資料傳送至Adobe Experience Platform中的資料集。 此動作要求
data
物件中的每個欄位必須是資料流對應工具中的專案,以將其指派給XDM結構描述欄位。 此工作流程只需對應一次,不需要變更實作。 不過,這是在XDM物件中傳送資料時不需要的額外步驟。
Adobe建議在下列情況下使用此實施路徑:
- 您已有使用Adobe Analytics標籤擴充功能的現有實作。 如果您有使用AppMeasurement的實作,請改為遵循從AppMeasurement移轉至Web SDK。
- 您打算在未來使用Customer Journey Analytics,但不想從頭開始使用Web SDK實作來取代您的Analytics實作。 在Web SDK上從頭開始取代實作需要花費最大心力,但同時也提供最可行的長期實作架構。 如果您的組織願意執行乾淨的Web SDK實作,請參閱Customer Journey Analytics使用手冊中的透過Adobe Experience Platform Web SDK擷取資料。
移轉至Web SDK所需的步驟
下列步驟包含需努力達成的具體目標。 按一下每個步驟,以取得如何完成的詳細指示。
在Adobe Experience Platform Data Collection中建立資料流。 當您傳送資料至此資料流時,它會轉送資料至Adobe Analytics。 未來,相同的資料流會將資料轉送給Customer Journey Analytics。
- 導覽至experience.adobe.com並使用您的認證登入。
- 使用右上方的首頁或產品選擇器來導覽至 資料彙集。
- 在左側導覽中,選取 資料串流。
- 選取「新資料流」。
- 輸入想要的名稱,然後選取 儲存。
- 建立資料流後,請選取 新增服務。
- 在服務下拉式功能表中,選取 Adobe Analytics。
- 輸入與您目前傳送分析資料的目標網站相同的報表套裝ID。 按一下「儲存」。
您的資料流現在已準備好接收資料並傳遞給Adobe Analytics。
本節將準備您的標籤,以利後續步驟中進行的大量移轉作業。
-
按一下Adobe Experience Platform介面左上方的漢堡圖示,然後選取 標籤。
-
選取所需的標籤屬性。
-
在標籤屬性的左側導覽中,選取 擴充功能。
-
選取頂端附近的 目錄,檢視所有可用擴充功能的清單。
-
搜尋並選取 Adobe Experience Platform Web SDK 擴充功能,然後按一下右側的 安裝。
-
擴充功能組態設定隨即顯示。 找出「資料串流」段落,然後選取您在上一步中建立的資料串流。
-
選取「儲存」。
您的標籤屬性現在已安裝Web SDK。
資料物件資料元素提供直覺式架構,可設定Web SDK用來傳送至資料流的裝載。 您在下列步驟中更新的大部分規則都會與此資料元素互動。
-
在標籤介面的左側導覽中,選取 資料元素。
-
選取 新增資料元素
-
為資料元素執行下列設定:
- 名稱:您想要的任何專案,例如「資料層」或「資料物件」
- 擴充功能: Adobe Experience Platform Web SDK
- 資料元素型別: 變數
- 核取方塊可以保持原樣
-
在右側,選取下列設定:
- 屬性選項按鈕: 資料
- 解決方案: Adobe Analytics
-
選取「儲存」。
您的標籤屬性現在擁有更新每個規則所需的一切。
此步驟包含移轉至Web SDK所需的大部分工作,且需要瞭解您實作的運作方式。 以下提供範例來作為如何編輯典型標籤規則的範例。 更新實作中的所有標籤規則,以Web SDK擴充功能取代Adobe Analytics擴充功能的所有參考。
-
在標籤介面的左側導覽中,選取 規則。
-
選取要編輯的規則。
-
選取動作 Adobe Analytics — 設定變數
-
記下此規則內設定的所有Analytics變數。 納入在下拉式功能表中設定的變數,以及在自訂程式碼中設定的變數。
-
將動作組態變更為下列設定:
- 擴充功能: Adobe Experience Platform Web SDK
- 動作型別:更新變數
-
確定已在右側的下拉式清單中選取您的資料物件。
-
將Analytics變數設定為與其在Analytics擴充功能中設定的相同個別值。
- 在標籤介面中設定的變數可直接轉譯為相同的值。
- 在自訂程式碼中設定的字串變數需要調整很小。 不要使用
s
物件,改用data.__adobe.analytics
。 例如,s.eVar1
會轉譯為data.__adobe.analytics.eVar1
。 - 自訂程式碼中的Analytics設定變數和方法呼叫可能需要修改實作邏輯。 檢視每個個別變數,以判斷如何使用Web SDK達成其同等專案。
-
使用Web SDK擴充功能復寫所有規則邏輯後,請選取 保留變更。
-
對使用Adobe Analytics擴充功能設定值的每個動作設定重複這些步驟。 此步驟包含使用標籤介面設定的變數和使用自訂程式碼設定的變數。 自訂程式碼區塊無法在任何地方參照
s
物件。
上述步驟僅適用於設定值的規則。 下列步驟會取代所有使用動作組態 傳送信標的動作。
-
選取傳送信標的規則。
-
選取動作 Adobe Analytics — 傳送信標。
-
將動作組態變更為下列設定:
- 擴充功能: Adobe Experience Platform Web SDK
- 動作型別: 傳送事件
-
在右側,將動作設定變更為下列專案:
-
選取 「保留變更」。
-
對使用Adobe Analytics傳送信標的每個動作設定重複這些步驟。
發佈更新規則的工作流程,與標籤設定的任何其他變更相同。
- 在標籤介面的左側導覽中,選取 發佈流程。
- 選取 新增資料庫。
- 為此標籤認可命名,例如「升級至Web SDK」。
- 選取 新增所有變更的資源。
- 選取「儲存」。
- 發佈工作流程會顯示橘色點,表示正在建置。 圓點變成綠色後,您的變更即可在開發環境中使用。
- 在開發環境中測試您的變更,以確保所有規則皆正確引發,且資料物件會填入預期值。
- 準備就緒後,請提交程式庫進行核准、建置到測試環境,最後核准並發佈到生產環境。
當您的標籤實作完全在Web SDK上後,您就可以停用Adobe Analytics擴充功能。
- 在標籤介面的左側導覽中,選取 擴充功能。
- 尋找並選取Adobe Analytics擴充功能。 在右側,選取 停用。
- 依照上述相同的發佈工作流程,發佈移除Adobe Analytics擴充功能。
- 擴充功能在生產環境中停用後,您就可以完全解除安裝。 選取擴充功能,選取右側的三個點功能表,然後選取 解除安裝。
- 按照上面的相同發佈工作流程,將這些變更發佈到生產環境。
此時,您的Analytics實作已完全放在Web SDK上,並已為未來移至Customer Journey Analytics做好充分準備。