文件Analytics實作指南

使用Web SDK JavaScript資料庫傳送資料給Adobe Analytics

最後更新: 2025年5月5日

建立對象:

  • 使用者
  • 管理員

此實作路徑牽涉到使用Web SDK JavaScript程式庫的全新Web SDK安裝。 其他實作路徑會在不同頁面上說明:

  • Web SDK標籤擴充功能:使用Web SDK標籤擴充功能的全新Web SDK安裝。 與Web SDK JavaScript程式庫方法(本頁)類似,但您可以使用Adobe Experience Platform資料收集中的標籤來管理實作。 它需要Adobe Analytics ExperienceEvent欄位群組,其中包括要包含在XDM結構描述中的典型Analytics變數。
  • Analytics擴充功能改用Web SDK擴充功能:以順暢而有條不紊的方式,從Adobe Analytics標籤擴充功能移至Web SDK標籤擴充功能。 在您的組織準備好使用Adobe Experience Platform服務(例如Customer Journey Analytics)之前,此方法會抑制使用XDM的需求。 使用data物件而非xdm物件來傳送資料給Adobe。
  • AppMeasurement至Web SDK JavaScript資料庫:移轉至Web SDK的流暢且有條不紊的方法,但不使用標籤。 您可以手動移除Adobe Analytics資料收集程式庫(AppMeasurement.js),並將其取代為Web SDK JavaScript程式庫(alloy.js)。

此實作路徑的優缺點

使用Web SDK JavaScript資料庫將資料傳送至Adobe Analytics有利也有弊。 請仔細權衡每個選項,決定哪種方式最適合您的組織。

優勢缺點
  • 直接方法:此實作路徑比移動現有Adobe Analytics實作的方法更直接。 如果您不需擔心目前的Adobe Analytics實作,請填入適用的Web SDK XDM欄位。
  • 預先定義的結構描述:如果您的組織不需要自己的結構描述,您只需使用以Adobe Analytics為根據的結構描述即可。 即使您邁向Customer Journey Analytics,此概念仍適用;prop和eVar的概念不適用於Customer Journey Analytics,但您可以繼續使用prop和eVar作為簡單的自訂維度。
  • 實作變更需要開發人員介入:若要變更Web SDK實作,您必須與開發團隊合作,編輯網站上的程式碼。 使用Web SDK標籤延伸模組的方法可避免此缺點。
  • 使用特定結構描述鎖定:當您的組織移至Customer Journey Analytics時,您必須選擇繼續使用Adobe Analytics結構描述,或移轉至您自己的組織結構描述(這將是獨立的資料集)。 如果您的組織想要在移至Customer Journey Analytics時同時避免Adobe Analytics結構描述和移轉至個別的資料集,Adobe建議使用下列兩種方法之一:
    • 使用data物件: data物件可讓您傳送資料給Adobe Analytics,而不符合XDM結構描述。 建立組織的結構描述後,您可以使用資料流對應將data物件欄位對應到XDM。 Analytics擴充功能至Web SDK擴充功能和AppMeasurement至Web SDK JavaScript程式庫皆使用此data物件。
    • 完全略過Adobe Analytics:如果您正在實作Web SDK,可以將該資料傳送到Adobe Experience Platform中的資料集,以用於Customer Journey Analytics。 您可以使用任何您喜歡的結構描述;Adobe Analytics完全不參與此工作流程,因此不需要Adobe Analytics ExperienceEvent欄位群組。 此方法產生最少的技術債,但也會將Adobe Analytics完全排除在外。
重要
此實作方法需要您使用為Adobe Analytics設定的結構描述。 如果您的組織計畫在未來使用您自己的方案進行Customer Journey Analytics,使用Adobe Analytics方案可能會對資料管理員或架構師造成混淆。 有幾個選項可以緩解此障礙:
  • 您可以在CJA中使用Adobe Analytics結構描述。 請注意,CJA沒有prop或eVar的概念;它們被視為任何其他結構描述欄位。 也請注意,在CJA中使用Adobe Analytics結構描述會使其他平台服務(例如Adobe Journey Optimizer或Real-time Customer Data Platform)的使用更困難。
  • 您可以使用資料物件,類似於移轉工作流程。 請注意,使用資料物件需要將每個資料物件欄位對應到XDM結構描述欄位。
  • 您可以完全略過Adobe Analytics實施,並使用您自己的結構描述傳送資料給Adobe Experience Platform。 這種做法是理想的長期做法,可讓您的組織開始使用Customer Journey Analytics。

實作Web SDK JavaScript程式庫所需的步驟

實施任務的高層級概觀:

如何使用Web SDK工作流程實作Adobe Analytics,如本節所述。

任務更多資訊
1確定您 已定義報表套裝。報表套裝管理員
2設定結構描述。 為了標準化資料彙集以跨利用 Adobe Experience Platform 的應用程式使用,Adobe 建立了開放且公開記錄標準,即體驗資料模型 (XDM)。結構描述UI總覽
3建立資料層 來管理您網站上的資料追蹤。建立資料層
4安裝預先建立的獨立版本。您可以直接在您的頁面上參考 CDN 上的程式庫 (alloy.js),或將其下載並託管在您自己的基礎結構上。或者,您可以使用 NPM 套件。安裝預先建立的獨立版本和使用 NPM 套件
5設定資料流。資料流代表實施 Adobe Experience Platform Web SDK 時的伺服器端設定。設定資料流
6將 Adobe Analytics 服務 新增到您的資料流。此服務可控制資料是否及如何傳送至Adobe Analytics,以及特定要將資料傳送到哪些報表套裝。將 Adobe Analytics 服務新增到資料流
7設定 Web SDK。請確認您在步驟4安裝的程式庫已正確設定資料串流ID (先前稱為邊緣組態ID (datastreamId))、組織ID (orgId)及其他可用選項。 請確定變數對應正確。設定Web SDK
XDM物件變數對應
8執行命令 和/或 追蹤事件。在您的網頁上實施基礎程式碼後,您可以開始使用 SDK 執行命令和追蹤事件。傳送事件
9先擴充和驗證您的實施,再將其投入生產。
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690