文件Experience PlatformWeb SDK 教學課程

建立標籤規則

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

建立對象：

  • undefined
  • undefined
  • undefined

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

學習目標

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

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

先決條件

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

命名慣例

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

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

其中；

  1. 位置 是規則觸發所在網站的一或多個頁面
  2. 事件 是規則的觸發器
  3. 用途 是規則執行的主要動作
  4. 訂購 是規則相對於其他規則所應引發的順序

建立標籤規則

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

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

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

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

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

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

所有這些規則將使用"訂購」選項。

這部影片會概述此程式：

https://video.tv.adobe.com/v/3427710/?learn=on

全域設定欄位

若要為全域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 資料元素為空， 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
    兩者皆非 eventType 設為 web.webpagedetails.pageViews 也不 web.webPageDetails.pageViews.value 是Adobe Analytics將信標設為頁面檢視加以處理的必要專案，如果有標準方式來指定其他下游應用程式的頁面檢視，就十分實用。

  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. 在右側，啟用 規則運算式 切換

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

  14. 選取 保留變更

    Analytics XDM規則

  15. 在 動作 選取 新增

  16. 選取 Adobe Experience Platform Web SDK 副檔名

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

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

  19. 向下捲動至 commerce 物件

  20. 開啟 產品檢視 物件與集合 值 至 1

    設定產品檢視

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

  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 您透過建立較早的回圈 digitalData.cart.cartEntries Luma上的資料層物件，並將其轉譯為 productListItems XDM結構描述的物件。

如需說明，請參閱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. 在右邊， 不要 啟用 規則運算式 切換

  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. 開啟 productListView 物件與集合 值 至 1

    設定產品檢視

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

  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
    這等於設定 scCheckout Analytics中的事件

規則名稱： 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
    這等於設定 purchase Analytics中的事件

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

  5. 設定 commerce.order.currencyCode 至硬式編碼值 USD

    設定Analytics的purchaseID

    note tip
    TIP
    這等於設定 s.purchaseID 和 s.currencyCode Analytics中的變數

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

  7. 選取 提供整個陣列

  8. 將對應到 cart.productInfo.purchase 資料元素

  9. 選取 保留變更

  10. 選取 儲存

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

Analytics XDM規則

傳送事件規則

現在您已設定變數，您可以建立規則，以使用將完整XDM物件傳送至PlatformEdge 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