文件Experience PlatformWeb SDK 教學課程

使用Adobe Experience Platform Web SDK設定Adobe Analytics

Last update: Sat Jun 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • undefined
  • undefined
  • undefined

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

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

Web SDK至Adobe Analytics圖表

學習目標

在本課程結束時，您將能夠：

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

先決條件

若要完成本課程，您必須先：

  • 熟悉並存取Adobe Analytics。

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

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

設定資料串流

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

  1. 前往 資料彙集 介面

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

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

    選取Luma Web SDK資料流

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

  5. 選取 Adobe Analytics 作為 服務

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

  7. 選取 儲存

    資料流儲存分析

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

設定Analytics變數

有數種方式可以在Web 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 PlatformWeb SDK會自動收集一些資料，並以XDM欄位形式將其傳送至PlatformEdge 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產品字串的個別區段是透過下的不同XDM變數設定的。 productListItems 物件。

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

在資料物件中設定變數

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

首先，什麼是 data 物件？ 在任何Web SDK事件中，您都可以傳送包含自訂資料的兩個物件， xdm 物件與 data 物件。 兩者都會傳送至PlatformEdge 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. 這可確保規則在 all pages - library loaded - send event - 50 使用設定基線XDM 更新變數 動作型別。

  6. 選取 保留變更

    Analytics報表套裝覆寫

  7. 在 條件，選取 新增

  8. 離開 邏輯型別 作為 一般

  9. 離開 擴充功能 作為 核心

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

  11. 在右側，離開 規則運算式 切換已停用

  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. 離開 開發 標籤已選取。

    note tip
    TIP
    此索引標籤會決定要在哪個標籤環境中發生覆寫。 對於此體驗，您只需指定開發環境，但當您將此部署至生產環境時，請記得也在 生產 環境。

  21. 選取 Sandbox 在本教學課程中，您會使用

  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

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

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

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

  1. 使用Experience PlatformDebugger的邊緣追蹤功能，驗證平台Edge Network上XDM物件處理資料的方式
  2. 使用Adobe Experience Platform保證驗證Analytics完全處理資料的方式

Experience CloudID驗證

  1. 前往 Luma示範網站

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

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

  4. 若要啟用邊緣追蹤，請前往Experience Platform偵錯工具，在左側導覽中選取 記錄檔，然後選取 Edge 標籤，然後選取 連線

    連線邊緣追蹤

  5. 目前會是空的

    連線的邊緣追蹤

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

  7. 選取以同時開啟 mappedQueryParams 用於檢視Analytics變數的下拉式清單和第二個下拉式清單

    Analytics信標邊緣追蹤

    note tip
    TIP
    第二個下拉式清單會對應至您傳送資料的Analytics報表套裝ID。 這應與您自己的報表套裝相符，而非熒幕擷圖中的報表套裝。

  8. 向下捲動以尋找 c.a.x.identitymap.ecid.[0].id. 這是可擷取ECID的內容資料變數

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

  10. 在Luma網站上，

    Analytics ECID

    note note
    NOTE
    由於您已登入，請花點時間驗證驗證的ID 112ca06ed53d3db37e4cea49cc45b71e 適用於使用者 test@adobe.com 也會擷取至 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 變數中。 這是Analytics的動態語法 s.pageName 變數中。 它會從資料層擷取頁面名稱。

    Analytics產品字串

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

由於您已在產品頁面上，此練習會繼續使用相同的邊緣追蹤來驗證Analytics所擷取的產品資料。 產品字串和電子商務事件都會自動將XDM變數對應至Analytics。 只要您已對應至適當的 productListItem XDM變數，而 為Adobe Analytics設定XDM結構描述，平台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產品字串

    邊緣軌跡處理 commerce 事件與略有不同 productList 維度。 您不會看到內容資料變數的對應方式，與您看到產品名稱對應的方式相同 c.a.x.productlistitem.[0].name 以上。 邊緣追蹤反而會在Analytics中顯示最終事件自動對應 event 變數中。 只要您將對應到適當的XDM，平台Edge Network就會據此對應 commerce 變數，而 為Adobe Analytics設定結構；在此案例中 commerce.productViews.value=1.

  5. 返回Experience PlatformDebugger視窗，向下捲動至 events 變數，已設為 prodView

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

    note tip
    TIP
    此 ecommerce - pdp library loaded - AA (order 20) 規則正在覆寫的值 eventType 由 all pages global content variables - library loaded - AA (order 1) 規則，因為已設定為稍後在順序中觸發

    Analytics產品檢視

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

  1. 新增 滴滴打獵手錶 至購物車

  2. 前往 購物車頁面，檢查邊緣追蹤

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

    Analytics購物車檢視

  3. 繼續結帳，勾選「邊緣追蹤」

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

    Analytics簽出

  4. 只填寫 名字 和 姓氏 欄位並選取 繼續. 在下一頁，選取 下單

  5. 在確認頁面上，檢查邊緣追蹤

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

    Analytics購買

使用Assurance驗證Adobe Analytics

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

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

如您所知， 保證 課程，有數種方式可啟動保證工作階段。 由於您已經透過上次練習起始的邊緣追蹤工作階段開啟Adobe Experience Platform Debugger，因此建議您透過Debugger存取Assurance：
透過Adobe Experience Platform Data Collection提供保證

在 「Web SDK教學課程3」 輸入保證工作階段 "hitdebugger" 並放入事件搜尋列，將結果篩選為Adobe Analytics處理後資料。
保證Adobe分析後處理資料

Experience CloudID驗證

若要驗證Adobe Analytics是否正在擷取ECID，請選取信標並開啟裝載。 此信標的廠商應為 com.adobe.analytics.hitdebugger
Adobe Analytics驗證（含保證）

然後向下捲動至 mcvisId 驗證ECID是否正確擷取
具有保證的Experience CloudID驗證

內容頁面檢視驗證

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

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

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

  1. 尋找裝載，其中 事件 contain prodView
    含保證的產品字串驗證
  2. 向下捲動至 product-string 驗證 Product String.
    • 請注意 Product SKU 和 Merchandizing eVar1.
  3. 進一步向下捲動並驗證 prop1，您已使用上一節中的處理規則加以設定，包含 Product SKU
    具保證的銷售變數驗證產品字串

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

  1. 尋找裝載，其中 事件 contain scView 並驗證產品字串。
    含保證的產品字串驗證
  2. 尋找裝載，其中 事件 contain scCheckout 並驗證產品字串。
    含保證的產品字串驗證
  3. 尋找裝載，其中 事件 contain purchase
    含保證的產品字串驗證
  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