文件Experience PlatformWeb SDK 教學課程

使用Platform Web SDK資料設定事件轉送

Last update: Fri Apr 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Beginner
  • Intermediate
  • Developer

瞭解如何將事件轉送與Adobe Experience Platform Web SDK資料搭配使用。

事件轉寄是「資料收集」中可用的全新屬性型別。 事件轉送可讓您直接從Adobe Experience PlatformEdge Network傳送資料給第三方非Adobe廠商，而非傳統的使用者端瀏覽器。 在中進一步瞭解事件轉送的優點 事件轉送概觀.

Web SDK和事件轉送圖

若要在Adobe Experience Platform中使用事件轉送，必須先使用下列一個或多個選項，將資料傳送至Adobe Experience PlatformEdge Network：

NOTE
Platform Web SDK和Platform Mobile SDK不需要透過標籤進行部署，但建議使用標籤來部署這些SDK。

完成本教學課程中先前的課程後，您應使用Web SDK傳送資料至PlatformEdge Network。 資料進入平台Edge Network後，您就可以啟用事件轉送，並使用事件轉送屬性將資料傳送至非Adobe解決方案。

學習目標

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

  • 建立事件轉送屬性
  • 將事件轉送屬性連結至Platform Web SDK資料流
  • 瞭解標籤屬性資料元素與規則之間的差異，以及事件轉送屬性資料元素與規則
  • 建立事件轉送資料元素
  • 設定事件轉送規則
  • 驗證事件轉送屬性是否成功傳送資料

先決條件

建立事件轉送屬性

從建立事件轉送屬性開始：

  1. 開啟 資料收集介面

  2. 選取 事件轉送 從左側導覽

  3. 選取​ 「新屬性」。
    事件轉送屬性

  4. 為屬性命名。 在這種情況下， Server-Side - Web SDK Course

  5. 選取「儲存」。
    事件轉送屬性儲存

設定資料串流

若要讓事件轉送使用您傳送至PlatformEdge Network的資料，您必須將新建立的事件轉送屬性連結至用來將資料傳送至Adobe解決方案的相同資料流。

若要在資料流中設定Target：

  1. 前往 資料彙集 介面

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

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

    選取Luma Web SDK資料流

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

  5. 選取 事件轉送 作為 服務

  6. 在 屬性ID 在下拉式清單中，選取您為事件轉送屬性提供的名稱，在此案例中為 Server-Side - Web SDK Course

  7. 在 環境ID 在此案例中，在下拉式清單中選取您要連結事件轉送環境的標籤環境 Development

    note tip
    TIP
    若要將資料傳送至Adobe組織外部的事件轉送環境，請選取「 」 手動輸入ID 並貼入ID。 建立event-forwarding屬性時，系統就會提供ID。

  8. 選取「儲存」。

    事件轉送資料流啟用

當您準備好透過發佈流程提升您的變更時，請針對中繼和生產資料串流重複這些步驟。

將資料從平台Edge Network轉送至非Adobe解決方案

在本練習中，您將瞭解如何設定事件轉送資料元素、設定事件轉送規則，以及使用名為的第三方工具進行驗證 Webhook.site.

NOTE
webhook是以半即時方式整合不同系統的方式。 Webhook.site 是協力廠商工具，可讓您輕鬆檢查、測試和自動化（透過視覺化自訂動作產生器或WebhookScript）任何傳入的HTTP請求或電子郵件。
IMPORTANT
您必須已建立資料元素並將元素對應至XDM物件，且已設定標籤規則，並在程式庫中將這些變更建立至標籤環境，才能繼續進行。 若未包含，請參閱 標籤設定 中的步驟 必備條件 區段。 這些步驟可確保將資料傳送至PlatformEdge Network，且您可以從中設定事件轉送屬性，以將資料轉送至非Adobe解決方案。

建立事件轉送資料元素

您先前使用Platform Web SDK標籤擴充功能設定的XDM物件，會成為事件轉送屬性中資料元素的資料來源。 您可以使用已在標籤屬性中設定的相同資料作為事件轉送的資料來源。

IMPORTANT
在事件轉送中參照XDM欄位與其他內容時，有一個關鍵語法差異。 若要參照事件轉送屬性中的資料，資料元素路徑必須包含 arc.event 前置詞：
  • 其中 arc 代表 Adobe Response Context。
  • 例如︰arc.event.xdm.web.webPageDetails.URL
如果未正確指定此路徑，則不會收集資料。

在本練習中，您會將瀏覽器檢視區高度和Experience CloudID從XDM物件轉送至webhook。 XDM欄位路徑是由以下期間建立的XDM架構決定： 設定XDM結構描述 課程。

TIP
您也可以使用網頁瀏覽器網路工具，篩選以尋找XDM物件路徑 /ee 要求，開啟信標 裝載 並向下鑽研至您要尋找的變數。 然後以滑鼠右鍵按一下，並選取「複製屬性路徑」。 以下是瀏覽器檢視區高度的範例：
事件轉送XDM路徑

  1. 前往 事件轉送 您最近建立的屬性

  2. 在左側導覽中選取 資料元素

  3. 選擇以 建立新資料元素

    事件轉寄新資料元素

  4. 名稱 資料元素 environment.browserDetails.viewportHeight

  5. 在 副檔名，離開 CORE

  6. 在 資料元素型別，選取 Path

  7. 輸入包含瀏覽器檢視區高度的XDM物件路徑 arc.event.xdm.environment.browserDetails.viewportHeight

  8. 選取 儲存

    事件轉送ECID路徑

  9. 建立其他資料元素

  10. 名稱 it ecid

  11. 在 副檔名，離開 CORE

  12. 在 資料元素型別，選取 Path

  13. 輸入包含Experience CloudID的XDM物件路徑 arc.event.xdm.identityMap.ECID.0.id

  14. 選取 儲存

    事件轉送ECID路徑

    note caution
    CAUTION
    請務必包含 arc.event. 路徑中的前置詞。 此外，請確保遵循與XDM物件欄位名稱完全相同的大小寫，ECID名稱空間必須全部大寫。
    note tip
    TIP
    使用您自己的網站時，您可以使用網頁瀏覽器網路工具找到XDM物件路徑，並篩選 /ee 要求，開啟信標 裝載 並向下鑽研至您要尋找的變數。 然後以滑鼠右鍵按一下，並選取「複製屬性路徑」。 以下是瀏覽器檢視區高度的範例：
    事件轉送XDM路徑

安裝Adobe Cloud Connector擴充功能

若要將資料傳送至協力廠商位置，您必須先安裝 Adobe雲端聯結器 副檔名。

  1. 選取 擴充功能 在左側導覽

  2. 選取 目錄 標籤

  3. 搜尋 Adobe雲端聯結器，選取 安裝

    事件轉送ECID路徑

不需要擴充功能設定。 透過此擴充功能，您現在可以將資料轉送至非Adobe解決方案！

建立事件轉送規則

在標籤屬性中設定規則與事件轉送屬性中設定規則之間有幾個主要差異：

  • 活動 & 條件：

    • 標籤：所有規則都是由必須在規則中指定的事件觸發，例如 Library Loaded - Page Top. 條件為選用。
    • 事件轉送：我們假設每個傳送至PlatformEdge Network的事件都是轉送資料的觸發條件。 因此， 活動 即必須在事件轉送規則中選取的位置。 若要管理哪些事件會觸發事件轉送規則，您必須設定條件。

  • 資料元素代碼化：

    • 標籤：資料元素名稱會以 % 在規則中使用時，位於資料元素名稱的開頭和結尾。 例如 %viewportHeight%。

    • 事件轉送：資料元素名稱會使用進行代碼化： {{ 在開頭和 }} 在規則中使用時，會位於資料元素名稱的結尾。 例如 {{viewportHeight}}。

  • 規則動作順序：

    • 事件轉送規則的「動作」區段一律依序執行。 儲存規則時，請確認動作順序正確。 此執行序列無法像標籤一樣以非同步方式執行。

若要設定將資料轉送至webhook的規則，您必須先取得個人webhook：

  1. 前往 Webhook.site

  2. 尋找 您的唯一URL，您可將此用作為事件轉送規則中的URL要求

  3. 選取 複製到剪貼簿

  4. 保持此視窗開啟，因為您將能夠驗證Webhook即時擷取的事件轉送資料

    複製Webhook URL

  5. 返回 資料彙集 > 事件轉送 > 規則 從左側導覽

  6. 選取 建立新規則

    事件轉寄新規則

  7. 將其命名 all events - ad cloud connector - webhook

  8. 新增動作

  9. 在 副檔名，選取 Adobe雲端聯結器

  10. 在 動作型別，選取 進行擷取呼叫

  11. 將您的Webhook URL貼入 URL 欄位

    複製Webhook URL

  12. 在 [查詢引數]，您可新增先前建立的兩個資料元素。

  13. 在 索引鍵 中的欄型別 viewPortHeight. 在 值 欄，輸入 {{environment.browserDetails.viewportHeight}} 輸入資料元素或從資料元素選取器圖示中選取

  14. 選取 +新增另一個 以新增另一個查詢引數

  15. 在 索引鍵 中的欄型別 ecid. 在值欄中，輸入 {{ecid}} 資料元素

  16. 選取 保留變更

    新增查詢引數

  17. 您的規則應如下所示

  18. 選取 儲存

    儲存事件轉送規則

建立及建置程式庫

建立程式庫，並建置事件轉送開發環境的所有變更，如同您在標籤屬性中一般的作法。

NOTE
如果您尚未將測試和生產事件轉送屬性連結至資料流，您會看到開發環境是建立程式庫的唯一選項。

儲存事件轉送規則

驗證事件轉送規則

現在您可以使用Platform Debugger和Webhook.site來驗證事件轉送屬性：

  1. 請依照以下步驟操作 切換標籤庫 於 Luma示範網站 至您在資料流中將事件轉送屬性對應到的Web SDK標籤屬性。

  2. 重新載入頁面之前，Experience PlatformDebugger會開啟 記錄檔 從左側導覽

  3. 選取 Edge 索引標籤，然後選取 連線 若要檢視平台Edge Network請求

    事件轉送邊緣網路工作階段

  4. 重新載入頁面

  5. 您將看到其他請求，這些請求可讓您檢視平台Edge Network傳送給WebHook的伺服器端請求

  6. 焦點驗證的要求是顯示Edge網路所傳送之完整建構URL的要求

    事件轉送偵錯工具

  7. 請注意viewPortHeight和ecid查詢字串引數

    事件轉寄驗證查詢字串

  8. 它們符合XDM物件中看到的資料

    事件轉寄符合資料

  9. 最後，驗證中的資料符合專案 Webhook.site 以及檢視您開啟的Webhook視窗

    事件轉送webhook網站資料

恭喜！您已設定事件轉送！

下一步：

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