文件Experience PlatformWeb SDK 教學課程

使用Adobe Experience Platform Web SDK設定Adobe Analytics

Last update: Mon Jun 23 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題:

建立對象:

  • 初學者
  • 中繼
  • 開發人員

瞭解如何使用Adobe Experience Platform Web SDK設定Adobe Analytics、建立標籤規則以將資料傳送至Adobe Analytics,以及驗證Analytics是否如預期擷取資料。

Adobe Analytics是領先業界的應用程式,能夠讓您從使用者觀點瞭解客戶,並掌握客戶情報來為您的企業指引方向。

Web SDK至Adobe Analytics圖表

學習目標

在本課程結束時,您將能夠:

  • 設定資料流以啟用Adobe Analytics
  • 瞭解哪些標準XDM欄位會自動對應至Analytics變數
  • 在資料物件中設定Analytics變數
  • 覆寫資料流,將資料傳送至其他報表套裝
  • 使用Debugger和Assurance驗證Adobe Analytics變數

先決條件

若要完成本課程,您必須先:

  • 熟悉並存取Adobe Analytics。

  • 至少要有一個測試/開發報表套裝ID。 如果您沒有可用於本教學課程的測試/開發報表套裝,請建立一個。

  • 完成本教學課程之初始設定和標籤設定區段中先前的課程。

設定資料串流

Platform Web SDK會將資料從您的網站傳送至Platform Edge Network。 您的資料流接著會告訴Platform Edge Network要將您的資料傳送至哪個Adobe Analytics報表套裝。

  1. 移至資料彙集介面

  2. 在左側導覽中,選取​ 資料串流

  3. 選取先前建立的Luma Web SDK: Development Environment資料流

    選取Luma Web SDK資料流

  4. 選取​ 新增服務
    新增服務至資料流

  5. 選取​ Adobe Analytics ​做為​ 服務

  6. 輸入開發報表套裝的​ 報表套裝ID

  7. 選取​ 儲存

    資料流儲存分析

    TIP
    選取​ 新增報表套裝 ​以新增更多報表套裝等於多套裝標籤。
WARNING
在本教學課程中,您只會針對開發環境設定Adobe Analytics報表套裝。 當您為自己的網站建立資料串流時,應該為測試和生產環境建立其他資料串流和報表套裝。

設定Analytics變數

有數種方式可在網頁SDK實作中設定Analytics變數:

  1. 將XDM欄位自動對應到Analytics變數(自動)。
  2. 在data物件中設定欄位(建議)。
  3. 將XDM欄位對應至Analytics處理規則中的Analytics變數(不再建議使用)。
  4. 直接在XDM結構描述中對應至Analytics變數(不再建議使用)。

自2024年5月起,您不再需要建立XDM結構描述來使用Platform Web SDK實作Adobe Analytics。 data物件(以及您在建立資料元素課程中建立的data.variable資料元素)可用來設定所有自訂Analytics變數。 在資料物件中設定這些變數,會讓現有的Analytics客戶熟悉,比使用處理規則介面更有效率,並防止不必要的資料佔用即時客戶設定檔中的空間(如果您有Real-Time Customer Data Platform或Journey Optimizer,這很重要)。

自動對應的欄位

許多XDM欄位會自動對應至Analytics變數。 如需最新的對應清單,請參閱Adobe Experience Edge中的Analytics變數對應。

如果​ 即使您尚未定義自訂結構描述,也會發生這種情況。 Experience Platform Web SDK會自動收集一些資料,並將其以XDM欄位的形式傳送到Platform Edge Network。 例如,Web SDK會讀取目前頁面URL並以XDM欄位web.webPageDetails.URL形式傳送。 此欄位會轉送至Adobe Analytics,並自動填入Adobe Analytics中的頁面URL報表。

如果您使用XDM結構描述實作適用於Adobe Analytics的Web SDK (如本教學課程中所述),則有些您自訂實作並自動對應至Analytics變數的XDM欄位,如下表所述:

XDM至Analytics自動對應的變數
Adobe Analytics變數
identitymap.ecid.[0].id
mid
web.webPageDetails.name
s.pageName
web.webPageDetails.server
s.server
web.webPageDetails.siteSection
s.channel
commerce.productViews.value
prodView
commerce.productListViews.value
scView
commerce.checkouts.value
scCheckout
commerce.purchases.value
購買
commerce.order.currencyCode
s.currencyCode
commerce.order.purchaseID
s.purchaseID
productListItems[].SKU
s.products=;product name;;;;; (primary - see note below)
productListItems[].name
s.products=;product name;;;;; (備援 — 請參閱下方的注意事項)
productListItems[].quantity
s.products=;;product quantity;;;
productListItems[].priceTotal
s.product=;;;product price;

Analytics產品字串的個別區段是透過productListItems物件下的不同XDM變數設定的。

NOTE
自2022年8月18日起,productListItems[].SKU優先對應至s.products變數中的產品名稱。
​>只有在productListItems[].SKU不存在時,設定為productListItems[].name的值才會對應至產品名稱。 否則,它將會取消對應,並可在內容資料中使用。
​>請勿將空字串或Null設定為productListItems[].SKU。 這會產生不想要的效果,讓對應至s.products變數中的產品名稱。

在資料物件中設定變數

但evar、prop和事件呢? 在data物件中設定變數,是使用Web SDK設定這些Analytics變數的建議方式。 在資料物件中設定變數也可覆寫任何自動對應的變數。

首先,data物件是什麼? 在任何Web SDK事件中,您都可以傳送包含自訂資料的兩個物件: xdm物件和data物件。 兩者都會傳送至Platform Edge Network,但只有xdm物件會傳送至Experience Platform資料集。 可以使用「資料收集的資料準備」功能,將data物件中的屬性在Edge上對應至xdm欄位,否則不會傳送至Experience Platform。 這使其成為將資料傳送至Analytics等應用程式(並非原生建置在Experience Platform上)的理想方式。

以下是通用Web SDK呼叫中的兩個物件:

資料和xdm物件

Adobe Analytics已設定為在data.__adobe.analytics物件中尋找任何屬性,並將這些屬性用於Analytics變數。

現在來看看這是如何運作的。 讓我們以頁面名稱設定eVar1和prop1,看看如何覆寫XDM對應的值

  1. 開啟標籤規則all pages - library loaded - set global variables - 1
  2. 新增新的​ 動作
  3. 選取​ Adobe Experience Platform Web SDK ​擴充功能
  4. 選取​ 動作型別 ​做為​ 更新變數
  5. 選取data.variable做為​ 資料元素
  6. 選取​ 分析 ​物件
  7. 將eVar1設為page.pageInfo.pageName資料元素
  8. 設定prop1以複製eVar1的值
  9. 若要測試XDM對應值的覆寫,請在​ 其他屬性 ​區段中,將頁面名稱設為靜態值test
  10. 儲存規則

現在,我們需要在傳送事件規則中包含資料物件。

  1. 開啟標籤規則all pages - library loaded - send event - 50
  2. 開啟​ 傳送事件 ​動作
  3. 選取data.variable作為​ 資料
  4. 選取​ 保留變更
  5. 選取​ 儲存

傳送資料至不同的報表套裝

訪客位於特定頁面時,您可能會想要變更要傳送至哪個Adobe Analytics報表套裝資料。 這需要在資料串流和規則中進行設定。

設定報表套裝覆寫的資料流

若要在資料流中設定Adobe Analytics報表套裝覆寫設定:

  1. 開啟您的資料串流

  2. 編輯​ Adobe Analytics ​設定,方法是開啟 更多 功能表,然後選取​ 編輯

    覆寫資料流

  3. 選取​ 進階選項 ​以開啟​ 報表套裝覆寫

  4. 選取您要覆寫的報告套裝。 在這種情況下,Web SDK Course Dev和Web SDK Course Stg

  5. 選取​ 儲存

    覆寫資料流

設定報表套裝覆寫規則

讓我們建立規則,將額外的頁面檢視呼叫傳送至不同的報表套裝。 使用資料流覆寫功能,透過​ 傳送事件 ​動作變更頁面的報表套裝。

  1. 建立新規則,將其命名為homepage - library loaded - AA report suite override - 51

  2. 選取​ 事件 ​下的加號以新增觸發器

  3. 在​ 擴充功能 ​下,選取​ 核心

  4. 在​ 事件型別 ​下,選取​ 載入的程式庫(頁面頂端)

  5. 選取以開啟​ 進階選項,輸入51。 這可確保規則在設定基準線XDM為​ 更新變數 ​動作型別的all pages - library loaded - send event - 50之後執行。

  6. 選取​ 保留變更

    Analytics報表套裝覆寫

  7. 在​ 條件 ​下,選取以​ 新增

  8. 保留​ 邏輯型別 ​為​ 一般

  9. 保留​ 擴充功能 ​為​ 核心

  10. 選取​ 條件型別 ​作為不含查詢字串​ 的 ​路徑

  11. 在右側,保留​ Regex ​切換功能為停用

  12. 在​ 路徑下,等於 ​設定/content/luma/us/en.html。 對於Luma示範網站,這可確保規則只在首頁上觸發

  13. 選取​ 保留變更

    Analytics報表套裝覆寫條件

  14. 在​ 動作 ​下,選取​ 新增

  15. 以​ 延伸模組 ​身分,選取​ Adobe Experience Platform Web SDK

  16. 作為​ 動作型別,請選取​ 傳送事件

  17. 以​ XDM資料 ​身分,選取您在建立資料元素課程中建立的xdm.variable.content資料元素

  18. 以​ 資料 ​的身分,選取您在建立資料元素課程中建立的data.variable資料元素

    Analytics資料流覆寫

  19. 向下捲動至​ 資料流設定覆寫 ​區段

  20. 保留​ 開發 ​索引標籤處於選取狀態。

    TIP
    此索引標籤會決定要在哪個標籤環境中發生覆寫。 對於此練習,您僅指定開發環境,但當您將此部署到生產環境時,請記得也在​ 生產 ​環境中這樣做。
  21. 選取您用於教學課程的​ 沙箱

  22. 選取​ 資料流,在此案例中為Luma Web SDK: Development Environment

  23. 在​ 報告套裝 ​底下,選取您要覆寫的報告網站。 在這種情況下,tmd-websdk-course-stg。

  24. 選取​ 保留變更

  25. 並​ 儲存 ​您的規則

    Analytics資料流覆寫

建置您的開發環境

將更新的規則新增至Luma Web SDK Tutorial標籤程式庫,並重新建置開發環境。

恭喜!下一步是透過Experience Platform Web SDK驗證您的Adobe Analytics實作。

使用Debugger驗證Adobe Analytics

瞭解如何使用Adobe Analytics Debugger的Edge追蹤功能來驗證Experience Platform是否擷取ECID、頁面檢視、產品字串以及電子商務事件。

在Debugger課程中,您已瞭解如何使用Platform Debugger和瀏覽器開發人員控制檯來檢查使用者端XDM請求,其方式與為AppMeasurement.js Analytics實作除錯類似。 您也瞭解如何驗證傳送至Adobe應用程式的Platform Edge Network伺服器端請求,以及如何使用Assurance檢視完全處理的裝載。

若要驗證Analytics是否可透過Experience Platform Web SDK正確擷取資料,您必須進一步執行下列兩個步驟:

  1. 使用Experience Platform Debugger的Edge追蹤功能,驗證XDM物件在Edge Network上處理資料的方式
  2. 驗證Analytics使用Adobe Experience Platform Assurance完整處理資料的方式

Experience Cloud ID驗證

  1. 前往Luma示範網站

  2. 選取右上方的登入按鈕,並使用認證u: test@test.com p:測試進行驗證

  3. 開啟Experience Platform Debugger並將網站上的標籤屬性切換為您自己的開發屬性

  4. 若要啟用Edge追蹤,請前往Experience Platform Debugger,在左側導覽中選取「記錄檔」,然後選取「Edge」標籤,再選取「連線」

    連線Edge追蹤

  5. 目前會是空的

    已連線的Edge追蹤

  6. 重新整理Luma頁面並再次檢查Experience Platform Debugger,您應該會看到資料顯示。 以​ Analytics自動對應 ​開頭的列是Adobe Analytics信標

  7. 選取以開啟mappedQueryParams下拉式清單和第二個下拉式清單,檢視Analytics變數

    Analytics信標Edge追蹤

    TIP
    第二個下拉式清單會對應至您傳送資料的Analytics報表套裝ID。 這應與您自己的報表套裝相符,而非熒幕擷圖中的報表套裝。
  8. 向下捲動以尋找c.a.x.identitymap.ecid.[0].id。 這是可擷取ECID的內容資料變數

  9. 持續向下捲動,直到看到Analytics mid變數為止。 這兩個ID都和您裝置的Experience Cloud ID相符。

  10. 在Luma網站上:

    Analytics ECID

    NOTE
    由於您已登入,請花點時間驗證使用者​**test@test.com**​的驗證ID b642b4217b34b1e8d3bd915fc65c4452,此驗證識別碼也已在c.a.x.identitymap.lumacrmid.[0].id中擷取

報表套裝覆寫驗證

您在上方設定了Luma首頁的資料流覆寫。 驗證此設定的方式

  1. 在套用覆寫之後尋找具有​ 資料流設定的資料列。 您可在這裡找到針對報表套裝覆寫設定的主要報表套裝和其他報表套裝。

    Analytics報表套裝覆寫清單驗證

  2. 向下捲動至以​ Analytics自動對應 ​開頭的列,並驗證reportSuiteIds是否顯示您在覆寫設定中指定的報表套裝

    Analytics報表套裝覆寫呼叫驗證

內容頁面檢視驗證

移至Didi Sport Watch產品頁面之類的產品頁面。 驗證Analytics是否擷取內容頁面檢視。

  1. 尋找c.a.x.web.webpagedetails.pageviews.value=1。

  2. 向下捲動以檢視gn變數。 這是s.pageName變數的Analytics動態語法。 它會從資料層擷取頁面名稱。

    NOTE
    如果您在先前的練習中使用data物件覆寫xdm物件,gn值可能是test。

    Analytics產品字串

產品字串和電子商務事件驗證

由於您已在產品頁面上,此練習會繼續使用相同的Edge追蹤來驗證Analytics所擷取的產品資料。 產品字串和電子商務事件都會自動將XDM變數對應至Analytics。 在為Adobe Analytics設定XDM結構描述時,只要您已對應至適當的productListItem XDM變數,Platform Edge Network就會負責將資料對應至適當的分析變數。

首先驗證Product String是否已設定

  1. 尋找c.a.x.productlistitems.[0].sku。 變數會擷取您在本課程中先前對應至productListItems.item1.sku的資料元素值

  2. 也尋找c.a.x.productlistitems.[0]._experience.analytics.customdimensions.evars.evar1。 變數會擷取您對應至productListItems.item1._experience.analytics.customdimensions.evars.evar1的資料元素值

  3. 向下捲動以檢視pl變數。 這是Analytics產品字串變數的動態語法

  4. 請注意,資料層的產品名稱會對應至產品字串的c.a.x.productlistitems.[0].sku和product引數。 此外,資料層的產品標題會對應至產品字串中的銷售evar1。

    Analytics產品字串

    Edge追蹤處理commerce個事件的方式與productList個維度略有不同。 您不會看到內容資料變數的對應方式,與看到產品名稱對應至上述c.a.x.productlistitem.[0].name的方式相同。 Edge追蹤反而會在Analytics event變數中顯示最終事件自動對應。 只要您在設定Adobe Analytics的結構描述時對應到適當的XDM commerce變數,Platform Edge Network就會相應地對應它;在此例中是commerce.productViews.value=1。

  5. 返回Experience Platform Debugger視窗,向下捲動至events變數,變數設為prodView

  6. 另請注意c.a.x.eventType已設為commerce.productViews,因為您位於產品頁面。

    TIP
    ecommerce - library loaded - set product details variables - 20規則正在覆寫all pages - library loaded - set global variables - 1規則設定的eventType的值,因為它設定為稍後在順序中觸發

    Analytics產品檢視

驗證為Analytics設定的其餘電子商務事件和產品字串

  1. 將Didi Sport Watch加入購物車

  2. 前往購物車頁面,檢查Edge追蹤

    • eventType已設定為commerce.productListViews
    • events: "scView",和
    • 產品字串已設定

    分析購物車檢視

  3. 繼續結帳,檢查Edge追蹤

    • eventType已設定為commerce.checkouts
    • events: "scCheckout",和
    • 產品字串已設定

    Analytics簽出

  4. 填寫送貨表單上的​ 名字 ​和​ 姓氏 ​欄位,然後選取​ 繼續。 在下一頁,選取​ 下訂單

  5. 在確認頁面上,檢查Edge追蹤

    • eventType已設定為commerce.purchases
    • 正在設定的購買事件events: "purchase"
    • 正在設定的貨幣代碼變數cc: "USD"
    • 已在pi中設定購買識別碼
    • 設定產品名稱、數量和價格的產品字串pl

    Analytics購買

使用Assurance驗證Adobe Analytics

Adobe Experience Platform Assurance可協助您檢查、證明、模擬及驗證您如何收集資料,或如何透過您的網站和行動應用程式提供體驗。

在上一個練習中,您已驗證Adobe Analytics是否使用Experience Platform Debugger的Edge追蹤功能來擷取ECID、頁面檢視、產品字串以及電子商務事件。 接下來,您可以使用Adobe Experience Platform Assurance驗證這些相同事件,這是在Edge追蹤中存取相同資料的替代介面。

如您在Assurance課程中所瞭解,有數種方式可啟動Assurance工作階段。 由於您已經以Edge追蹤工作階段開啟了Adobe Experience Platform Debugger (從上次練習開始),因此建議您透過Debugger存取Assurance:
透過Adobe Experience Platform資料彙集 Assurance

在​ 「網頁SDK教學課程3」 Assurance工作階段中,在事件搜尋列中輸入​ 「hitdebugger」,將結果篩選為Adobe Analytics後續處理資料。
Assurance Adobe Analytics後續處理的資料

Experience Cloud ID驗證

若要驗證Adobe Analytics是否正在擷取ECID,請選取信標並開啟裝載。 此信標的廠商應為​ com.adobe.analytics.hitdebugger
使用Assurance進行 Adobe Analytics驗證

然後向下捲動至​ mcvisId,驗證是否已正確擷取ECID
使用Assurance進行 Experience Cloud ID驗證

內容頁面檢視驗證

使用相同的信標,驗證內容頁面檢視是否已對應至正確的Adobe Analytics變數。
向下捲動至​ pageName ​以驗證Page Name是否已正確擷取:

>[!NOTE]
>
>如果您在先前的練習中使用'data'物件覆寫'xdm'物件,則'pageName'值可能是'test'。

![使用Assurance驗證頁面名稱](assets/assurance-hitdebugger-content-pagename.png)

產品字串和電子商務事件驗證

依照使用上述Experience Platform Debugger進行驗證時所使用的相同驗證使用案例,繼續使用相同的指標來驗證Ecommerce Events和Product String。

  1. 尋找​ 事件 ​包含prodView的承載
    使用Assurance進行 產品字串驗證
  2. 向下捲動至​ product-string ​以驗證Product String。
    • 記下Product SKU和Merchandizing eVar1。
  3. 進一步向下捲動,驗證您使用上一節中的處理規則設定的prop1是否包含Product SKU
    產品字串(含Assurance的銷售變數驗證)

檢閱購物車、結帳和購買事件,繼續驗證實施。

  1. 尋找​ 事件 ​包含scView的裝載,並驗證產品字串。
    使用Assurance進行 產品字串驗證
  2. 尋找​ 事件 ​包含scCheckout的裝載,並驗證產品字串。
    使用Assurance進行 產品字串驗證
  3. 尋找​ 事件 ​包含purchase的承載
    使用Assurance進行 產品字串驗證
  4. 驗證purchase事件時,請注意Product String應該包含Product SKU、Product Quantity和Product Total Price。
  5. 此外,針對purchase,請驗證purchase-id及/或purchaseId是否已設定

恭喜!您成功了! 本課程已結束,現在您已準備好透過Platform Web SDK為您自己的網站實施Adobe Analytics。

下一步:

NOTE
感謝您花時間學習Adobe Experience Platform Web SDK。 如果您有任何疑問、想分享一般意見或有關於未來內容的建議,請在這篇Experience League社群討論貼文上分享
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4