文件Experience PlatformWeb SDK 教學課程

建立標籤規則

Last update: Thu Mar 05 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

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

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

學習目標

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

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

先決條件

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

命名慣例

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

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

其中；

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

新增Adobe Client Data Layer擴充功能

Luma網站使用事件導向的資料層，稱為Adobe Client Data Layer (ACDL)。 每當發生資料層事件時，就會將其推送至adobeDataLayer陣列。 本教學課程使用名為Adobe Client Data Layer的標籤擴充功能，方便您點選這些事件來建構我們的規則。

若要新增擴充功能：

  1. 移至​延伸模組

  2. 篩選至​Adobe使用者端資料層

  3. 選取​安裝

    新增Adobe使用者端資料層延伸模組

  4. 保留預設設定

  5. 選取​儲存

NOTE
不需要使用Adobe使用者端資料層來實作Experience Platform Web SDK。 許多其他型別的事件通常用於標籤實作（程式庫已載入、DOM已就緒、視窗已載入等）以觸發規則。

建立標籤規則

在標籤中，規則用於執行動作，例如設定變數以及在各種情況下引發網路呼叫。 Experience Platform Web SDK標籤擴充功能包含規則中使用的兩個動作：

  • 更新變數​將資料元素對應至您的XDM或資料變數
  • 傳送事件​進行網路呼叫，以將資料傳送至Experience Platform Edge Network

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

  1. 使用​ 更新變數 ​動作來定義XDM欄位的「全域設定」。

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

  3. 使用​ 傳送事件 ​動作將資料傳送至Adobe Experience Platform Edge Network。

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

這部影片會概述此程式：

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

全域設定欄位

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

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

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

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

    建立規則

  4. 將規則命名為 all pages - adobeDataLayer push - set global variables - 1

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

    為規則命名並新增事件

  6. 使用​ Adobe Client Data Layer ​擴充功能，並選取​ 推送的資料 ​作為​事件型別

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

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

  8. 聆聽​所有活動

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

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

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

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

  13. 以​ 資料元素 ​的身分，選取您在XDM Variable建立資料元素課程中建立的

    更新變數結構描述

  14. 現在，透過將欄位對應到適當的值來指定XDM欄位：

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    XDM欄位 將對應到
    eventType Web Webpagedetails Page Views （開始輸入以檢視建議值）
    identityMap Identity Map個資料元素
    web.webPageDetails.name Page Name個資料元素
    web.webPageDetails.pageViews.value 1
    note tip
    TIP
    如果資料元素為Null，XDM欄位將不會納入網路要求中。 因此，當使用者未驗證，且Identity Map資料元素為Null時，將不會傳送identityMap物件。 這就是我們可以在「全域設定」中安全地定義它的原因。
    note tip
    TIP
    設定web.webPageDetails.pageViews.value可提供標準方式來指示其他下游應用程式的頁面檢視。 Adobe Analytics不需要將網路呼叫作為頁面檢視來處理。

  15. 完成後，您的XDM Variable看起來會像這樣。 請注意，已填入和已部分填入的欄位標示為藍色圓圈的方式：
    XDM變數

  16. 選取​保留變更，然後​ 儲存 ​規則

產品頁面欄位

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

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

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

  1. 選取​新增規則

  2. 將其命名為product detail pages - adobeDataLayer push - set product details variables - 20

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

  4. 在​ 擴充功能 ​底下，選取​Adobe使用者端資料層

  5. 在​ 事件型別 ​下，選取​已推送的資料

  6. 選取以開啟​進階選項，輸入20。 此順序值可確保規則在​ 全域變數規則之後 ​執行。

  7. 聆聽​特定事件

  8. 輸入productView作為​ 要註冊的 ​事件/金鑰

  9. 選取​保留變更

    Analytics XDM規則

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

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

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

  13. 選取XDM Variable做為​資料元素

  14. 將這些XDM欄位對應到適當的值：

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    XDM欄位 將對應到
    eventType Commerce Product Views （開始輸入以檢視建議值）
    commerce.productViews.value 1
    productListItems.name Ecommerce Product Name資料元素（選取​ 提供個別專案 ​和​先新增專案）
    productListItems.sku Ecommerce Product Id個資料元素

  15. 選取​保留變更

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

    note note
    NOTE
    由於此規則的順序較高，因此會覆寫「全域設定」規則中設定的eventType。 eventType只能包含一個值，建議您以最有價值的事件進行設定。
    note tip
    TIP
    在XDM中設定commerce.productViews.value=1會自動對應至Analytics中的prodView事件

購物車欄位

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

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

XDM物件陣列格式

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

NOTE
在教學課程的這個階段，您將無法執行_satellite.getVar('Ecommerce Cart Products')。
IMPORTANT
將欄位從資料層對應至XDM時，請確定欄位符合XDM欄位的資料型別。 在上述範例中，quantity和priceTotal必須是整數，否則記錄不會擷取到Platform。
XDM結構描述資料型別

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

  1. 建立名為cart page - adobeDataLayer push - set cart variables - 20的新規則

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

  3. 在​ 擴充功能 ​底下，選取​Adobe使用者端資料層

  4. 在​ 事件型別 ​下，選取​已推送的資料

  5. 選取以開啟​進階選項，輸入20。 此順序值可確保規則在​ 全域變數規則之後 ​執行。

  6. 聆聽​特定事件

  7. 輸入cartView作為​ 要註冊的 ​事件/金鑰

  8. 選取​保留變更

    購物車規則的 事件

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

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

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

  12. 選取XDM Variable做為​資料元素

  13. 將這些XDM欄位對應到適當的值：

    table 0-row-2 1-row-2 2-row-2 3-row-2
    XDM欄位 將對應到
    eventType Commerce Product List (Cart) Views （開始輸入以檢視建議值）
    commerce.productListViews.value 1
    productListItems Ecommerce Cart Products資料元素（選取​先提供整個陣列）
    note tip
    TIP
    在XDM中設定commerce.productListViews.value=1會自動對應至Analytics中的scView事件

  14. 選取​保留變更

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

訂單確認欄位

建立另一個購買事件規則：

  1. 建立名為order confirmation - adobeDataLayer push - set purchase variables - 20的新規則

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

  3. 在​ 擴充功能 ​底下，選取​Adobe使用者端資料層

  4. 在​ 事件型別 ​下，選取​已推送的資料

  5. 選取以開啟​進階選項，輸入20。 此順序值可確保規則在​ 全域變數規則之後 ​執行。

  6. 聆聽​特定事件

  7. 輸入purchase作為​ 要註冊的 ​事件/金鑰

  8. 選取​保留變更

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

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

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

  12. 選取XDM Variable做為​資料元素

  13. 將這些XDM欄位對應到適當的值：

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
    XDM欄位 將對應到
    eventType Commerce Purchases （開始輸入以檢視建議值）
    commerce.productListViews.value 1
    commerce.order.purchaseID Ecommerce Purchase Id個資料元素
    commerce.order.currencyCode USD
    productListItems Ecommerce Cart Products資料元素（選取​先提供整個陣列）
    note tip
    TIP
    將XDM中的commerce.productListViews.value設定為1、commerce.order.purchaseID和commerce.order.currencyCode會自動分別對應到Analytics中的purchase、s.purchaseID和s.currencyCode變數。

  14. 選取​保留變更

  15. 選取​儲存

傳送事件規則

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

  1. 建立名為all pages - adobeDataLayer push - send event - 50的新規則

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

  3. 在​ 擴充功能 ​底下，選取​Adobe使用者端資料層

  4. 在​ 事件型別 ​下，選取​已推送的資料

  5. 選取以開啟​進階選項，輸入50 （可能是預設值）。 此順序值可確保規則在​ 變數設定規則之後 ​執行。

  6. 聆聽​所有活動

  7. 選取​保留變更

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

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

  10. 選取​ 動作型別 ​做為​傳送事件變數

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

  12. 以​ XDM ​身分，選取在上一堂課中建立的XDM Variable資料元素

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

    新增傳送事件動作

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

    儲存規則

屬性中應有下列規則：

驗證規則清單

在程式庫中發佈規則

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

若要建立程式庫：

  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