文件Experience PlatformWeb SDK 教學課程

建立標籤規則

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

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

瞭解如何使用標籤規則，透過XDM物件將事件傳送至Adobe Experience Platform Edge Network。 標籤規則是事件、條件和動作的組合，可告知標籤屬性執行動作。 透過Platform Web SDK，規則可用來將事件與正確的資料傳送至Platform Edge Network。

學習目標

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

  • 使用命名慣例來管理標籤內的規則
  • 使用更新變數和傳送事件動作來傳送包含XDM欄位的事件
  • 跨多個規則棧疊多組XDM欄位
  • 將個別或整個陣列資料元素對應至XDM物件
  • 將標籤規則發佈至開發程式庫

先決條件

您熟悉資料收集標籤和Luma示範網站，並已完成教學課程中先前的課程：

命名慣例

若要管理標籤中的規則，建議遵循標準命名慣例。 本教學課程使用五部分命名慣例：

  • [位置] - [事件] - [用途] - [訂單]

其中；

  1. location ​是規則觸發所在網站的一或多個頁面
  2. event ​是規則的觸發器
  3. purpose ​是規則執行的主要動作
  4. order ​是規則與其他規則關聯時應引發的順序

建立標籤規則

在標籤中，規則是用來在不同的條件下執行動作（引發呼叫）。 Platform Web SDK標籤擴充功能包含本課程使用的兩個動作：

  • 更新變數 ​將資料元素對應到XDM物件中的屬性
  • 傳送事件 ​將XDM物件傳送至Experience Platform Edge Network

在本課程的其餘部分中，我們會：

  1. 使用​ 更新變數 ​動作建立規則，以定義XDM欄位的「全域設定」。

  2. 使用​ 更新變數 ​動作建立其他規則，覆寫我們的「全域設定」，並在特定條件下（例如在產品頁面上新增產品詳細資訊）貢獻其他XDM欄位。

  3. 使用​ 傳送事件 ​動作建立另一個規則，該動作會將完整的XDM物件傳送至Adobe Experience Platform Edge Network。

所有這些規則將使用"順序"選項正確排序。

這部影片會概述此程式：

video poster

https://video.tv.adobe.com/v/3454038/?learn=on&enablevpops&captions=chi_hant

全域設定欄位

若要為全域XDM欄位建立標籤規則：

  1. 開啟您在本教學課程中使用的標籤屬性

  2. 前往左側導覽中的​ 規則

  3. 選取​ 建立新規則 ​按鈕

    建立規則

  4. 將規則命名為 all pages - library loaded - set global variables - 1

  5. 在​ 事件 ​區段中，選取​ 新增

    為規則命名並新增事件

  6. 使用​ 核心擴充功能 ​並選取​ 載入的程式庫（頁面頂端） ​作為​ 事件型別

  7. 選取​ 進階 ​下拉式清單，並輸入1作為​ 訂單

    note note
    NOTE
    訂單編號越低，執行的時間就越早。 因此，我們提供「全域組態」低訂購數量。

  8. 選取​ 保留變更 ​以返回主規則畫面
    選取程式庫已載入觸發器

  9. 在​ 動作 ​區段中，選取​ 新增

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

  11. 作為​ 動作型別，請選取​ 更新變數

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

    更新變數結構描述

現在，將您的資料元素對應到您的XDM物件所使用的結構描述。 您可以對應至個別屬性或整個物件。 在此範例中，您會對應至個別屬性：

  1. 找到eventType欄位並加以選取

  2. 輸入值web.webpagedetails.pageViews

    note tip
    TIP
    若要瞭解要填入eventType欄位中的值，您必須移至結構描述頁面，並選取eventType欄位以檢視右側邊欄上的建議值。 如有需要，您也可以輸入新值。
    結構描述頁面 🔗 上的eventType建議值

  3. 接著，在結構描述中尋找identityMap物件並加以選取

  4. 對應至identityMap.loginID資料元素

    更新變數身分對應

    note tip
    TIP
    如果資料元素為Null，XDM欄位將不會納入網路要求中。 因此，當使用者未驗證，且identityMap.loginID資料元素為Null時，將不會傳送identityMap物件。 這就是我們可在「全域設定」中加以定義的原因。

  5. 向下捲動，直到您達到​ web ​物件為止

  6. 選取以開啟

  7. 將下列資料元素對應至對應的web XDM變數

    • web.webPageDetials.name ​至%page.pageInfo.pageName%
    • web.webPageDetials.server ​至%page.pageInfo.server%
    • web.webPageDetials.siteSection ​至%page.pageInfo.hierarchie1%

  8. 將 web.webPageDetials.pageViews.value 設為 1

    更新變數內容

    note tip
    TIP
    雖然Adobe Analytics不需要將設為web.webpagedetails.pageViews的eventType或web.webPageDetails.pageViews.value來處理作為頁面檢視的信標，但為其他下游應用程式指出頁面檢視的標準方式會很有用。

  9. 選取「保留變更」，然後在下一個畫面中選取「儲存」規則，以完成建立規則

產品頁面欄位

現在，開始在其他循序規則中使用​ 更新變數 ​以擴充XDM物件，然後再將其傳送到平台Edge Network。

TIP
規則順序會決定觸發事件時先執行哪個規則。 如果兩個規則具有相同的事件型別，數字最低的規則會先執行。

首先，請追蹤Luma產品詳細資料頁面上的產品檢視：

  1. 選取​ 新增規則

  2. 將其命名為ecommerce - library loaded - set product details variables - 20

  3. 選取[事件]下的 +符號 以新增觸發器

  4. 在​ 擴充功能 ​下，選取​ 核心

  5. 在​ 事件型別 ​下，選取​ 載入的程式庫（頁面頂端）

  6. 選取以開啟​ 進階選項，輸入20。 此順序值可確保規則在​ 設定全域設定的all pages - library loaded - set global variables - 1之後執行。

  7. 選取​ 保留變更

    Analytics XDM規則

  8. 在​ 條件 ​下，選取以​ 新增

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

  10. 保留​ 延伸模組 ​為​ 核心

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

  12. 在右側，啟用​ Regex ​切換

  13. 在​ 路徑下，等於 ​設定/products/。 對於Luma示範網站，這可確保規則僅在產品頁面上觸發

  14. 選取​ 保留變更

    Analytics XDM規則

  15. 在​ 動作 ​下，選取​ 新增

  16. 選取​ Adobe Experience Platform Web SDK ​擴充功能

  17. 選取​ 動作型別 ​做為​ 更新變數

  18. 選取xdm.variable.content做為​ 資料元素

  19. 向下捲動至commerce物件

  20. 開啟​ productViews ​物件並將​ 值 ​設定為1

    設定產品檢視

    note tip
    TIP
    在XDM中設定commerce.productViews.value=1會自動對應至Analytics中的prodView事件

  21. 向下捲動至eventType並將其設定為commerce.productViews

    note note
    NOTE
    由於此規則的順序較高，因此會覆寫「全域設定」規則中設定的eventType。 eventType只能包含一個值，建議您以最有價值的事件進行設定。

  22. 向下捲動至並選取productListItems陣列

  23. 選取​ 提供個別專案

  24. 選取​ 新增專案

    正在設定產品檢視事件

    note caution
    CAUTION
    productListItems ​是array資料型別，因此預期資料會以元素集合的形式進入。 由於Luma示範網站的資料層結構，以及由於一次只能在Luma網站上檢視一個產品，因此您可個別新增專案。 在您自己的網站上實作時，根據資料層結構，您或許可以提供整個陣列。

  25. 選取以開啟​ 專案1

  26. 將​ productListItems.item1.SKU ​對應至%product.productInfo.sku%

    產品SKU XDM物件變數

  27. 選取​ 保留變更

  28. 選取​ 儲存 ​以儲存規則

購物車欄位

您可以將整個陣列對應至XDM物件，前提是陣列符合XDM結構描述的格式。 您先前建立的自訂程式碼資料元素cart.productInfo會透過Luma上的digitalData.cart.cartEntries資料層物件進行回圈，並將其轉譯為XDM結構描述之productListItems物件的必要格式。

如需說明，請參閱Luma網站資料層（左）與轉譯資料元素（右）下方比較：

XDM物件陣列格式

比較資料元素與productListItems結構（提示，它應該相符）。

IMPORTANT
請注意數值變數的轉譯方式，資料層中的字串值（例如price和qty）會重新格式化為資料元素中的數字。 這些格式需求對於Platform中的資料完整性很重要，並在設定結構描述步驟中確定。 在範例中，數量 ​使用​ 整數 ​資料型別。
XDM結構描述資料型別

現在，我們將陣列對應至XDM物件：

  1. 建立名為ecommerce - library loaded - set shopping cart variables - 20的新規則

  2. 選取[事件]下的 +符號 以新增觸發器

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

  4. 在​ 事件型別 ​下，選取​ 載入的程式庫（頁面頂端）

  5. 選取以開啟​ 進階選項，輸入20

  6. 選取​ 保留變更

    Analytics XDM規則

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

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

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

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

  11. 在右側，不 ​啟用​ Regex ​切換

  12. 在​ 路徑下，等於 ​設定/content/luma/us/en/user/cart.html。 對於Luma示範網站，這可確保規則僅在購物車頁面上觸發

  13. 選取​ 保留變更

    Analytics XDM規則

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

  15. 選取​ Adobe Experience Platform Web SDK ​擴充功能

  16. 選取​ 動作型別 ​做為​ 更新變數

  17. 選取xdm.variable.content做為​ 資料元素

  18. 向下捲動至commerce物件，並選取以開啟它。

  19. 開啟​ productListViews ​物件並將​ 值 ​設定為1

    設定產品檢視

    note tip
    TIP
    在XDM中設定commerce.productListViews.value=1會自動對應至Analytics中的scView事件

  20. 選取eventType並設為commerce.productListViews

  21. 向下捲動至並選取​ productListItems ​陣列

  22. 選取​ 提供整個陣列

  23. 對應至​ cart.productInfo ​資料元素

  24. 選取​ 保留變更

  25. 選取​ 儲存 ​以儲存規則

建立兩個其他規則，用於遵循相同模式的結帳和購買，但有下列差異：

規則名稱： ecommerce - library loaded - set checkout variables - 20

  1. 條件： /content/luma/us/en/user/checkout.html

  2. 將 eventType 設為 commerce.checkouts

  3. 將 commerce.checkout.value 設為 1

    note tip
    TIP
    這相當於在Analytics中設定scCheckout事件

規則名稱： ecommerce - library loaded - set purchase variables - 20

  1. 條件： /content/luma/us/en/user/checkout/order/thank-you.html

  2. 將 eventType 設為 commerce.purchases

  3. 將 commerce.purchases.value 設為 1

    note tip
    TIP
    這相當於在Analytics中設定purchase事件

  4. 將commerce.order.purchaseID設定為cart.orderId資料元素

  5. 將commerce.order.currencyCode設為硬式編碼值USD

    設定Analytics的purchaseID

    note tip
    TIP
    這相當於在Analytics中設定s.purchaseID和s.currencyCode變數

  6. 向下捲動至並選取​ productListItems ​陣列

  7. 選取​ 提供整個陣列

  8. 對應至​ cart.productInfo.purchase ​資料元素

  9. 選取​ 保留變更

  10. 選取​ 儲存

完成後，您應該會看到下列已建立的規則。

Analytics XDM規則

傳送事件規則

現在您已設定變數，您可以建立規則以使用​ 傳送事件 ​動作將完整的XDM物件傳送至Platform Edge Network。

  1. 在右側，選取​ 新增規則 ​以建立另一個規則

  2. 將規則命名為 all pages - library loaded - send event - 50

  3. 在​ 事件 ​區段中，選取​ 新增

  4. 使用​ 核心擴充功能 ​並選取Library Loaded (Page Top)做為​ 事件型別

  5. 選取​ 進階 ​下拉式清單，並在​ 順序 ​中輸入50。 這將確保此規則在您設定的所有其他規則（以1或20作為其順序）之後引發。

  6. 選取​ 保留變更 ​以返回主規則畫面
    選取程式庫已載入觸發器

  7. 在​ 動作 ​區段中，選取​ 新增

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

  9. 作為​ 動作型別，請選取​ 傳送事件

  10. 以​ XDM ​身分，選取在上一堂課中建立的xdm.variable.content資料元素

  11. 選取​ 保留變更 ​以返回主規則畫面

    新增傳送事件動作

  12. 選取​ 儲存 ​以儲存規則

    儲存規則

在程式庫中發佈規則

接下來，將規則發佈至您的開發環境，以便您可以驗證其是否有效。

若要建立程式庫：

  1. 前往左側導覽中的​ 發佈流程

  2. 選取​ 新增資料庫

    選取新增資料庫

  3. 為​ 名稱 ​輸入Luma Web SDK Tutorial

  4. 針對​ 環境，選取Development

  5. 選取​ 新增所有變更的資源

    note note
    NOTE
    您應會看見先前課程中建立的所有標籤元件。 核心擴充功能包含所有Web標籤屬性所需的基本JavaScript。

  6. 選取​ 儲存並建置以供開發

    建立並建置程式庫

程式庫可能需要幾分鐘的時間才能建置，建置完成後，程式庫名稱左側會顯示一個綠色點：

建置完成

如您在發佈流程畫面上所見，發佈程式還有更多內容，這不在本教學課程的討論範圍內。 本教學課程僅在您的開發環境中使用單一程式庫。

現在，您已準備好使用Adobe Experience Platform Debugger驗證請求中的資料。

下一步

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