文件Experience PlatformWeb SDK 教學課程

使用Adobe Experience Platform Web SDK設定Adobe Analytics

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

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

瞭解如何使用Adobe Analytics Web SDK設定Adobe Experience Platform、建立標籤規則以將資料傳送至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變數。 如需最新的對應清單，請參閱AdobeExperience 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產品字串的個別區段是透過productListItems物件下的不同XDM變數設定的。

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

在資料物件中設定變數

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

首先，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。 這可確保規則在設定基準線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. 保留​ 開發 ​索引標籤處於選取狀態。

    note tip
    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應用程式的PlatformEdge Network伺服器端要求，以及如何使用Assurance檢視完全處理的裝載。

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

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

Experience CloudID驗證

  1. 前往Luma示範網站

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

  3. 開啟Experience Platform偵錯工具，然後將網站上的標籤屬性切換到您自己的開發屬性

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

    連線Edge追蹤

  5. 目前會是空的

    已連線的Edge追蹤

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

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

    Analytics信標Edge追蹤

    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
    由於您已登入，請花點時間驗證使用者​**test@adobe.com**​的驗證ID 112ca06ed53d3db37e4cea49cc45b71e，此驗證識別碼也已在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動態語法。 它會從資料層擷取頁面名稱。

    Analytics產品字串

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

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

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

  5. 返回Experience Platform偵錯工具視窗，向下捲動至events變數，變數設為prodView

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

    note tip
    TIP
    ecommerce - pdp library loaded - AA (order 20)規則正在覆寫all pages global content variables - library loaded - AA (order 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保證可協助您檢查、證明、模擬及驗證您如何收集資料或透過您的網站和行動應用程式提供體驗。

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

如您在保證課程中瞭解到的那樣，有數種方式可啟動保證工作階段。 由於您已經使用上次練習起始的Edge追蹤工作階段開啟Adobe Experience Platform Debugger，建議您透過Debugger存取Assurance ：
透過Adobe Experience Platform資料彙集 保證

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

Experience CloudID驗證

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

然後向下捲動至​ mcvisId，驗證是否已正確擷取ECID
具有保證的Experience Cloud識別碼驗證

內容頁面檢視驗證

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

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

依照使用上述Experience Platform偵錯工具驗證時所使用的相同驗證使用案例，繼續使用相同的信標來驗證Ecommerce Events和Product String。

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

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

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