文件Experience PlatformWeb SDK 教學課程

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

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

建立對象：

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

了解如何將事件轉送與 Adob​​e 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
您也可以使用網頁瀏覽器網路工具、篩選/ee要求、開啟信標​ 裝載 並向下展開至您要尋找的變數，以尋找XDM物件路徑。 然後以滑鼠右鍵按一下，並選取「複製屬性路徑」。 以下是瀏覽器檢視區高度的範例：
事件轉送XDM路徑

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

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

  3. 選取以​ 建立新資料元素

    事件轉寄新資料元素

  4. Name ​資料元素environment.browserDetails.viewportHeight

  5. 在​ 副檔名 ​下，離開CORE

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

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

  8. 選取​ 儲存

    事件轉送ECID路徑

  9. 建立其他資料元素

  10. 名稱，它ecid

  11. 在​ 副檔名 ​下，離開CORE

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

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

  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 Platform偵錯工具上，從左側導覽開啟​ 記錄檔

  3. 選取​ Edge ​標籤，然後選取​ 連線 ​以檢視PlatformEdge Network要求

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

  4. 重新載入頁面

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

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

    事件轉送偵錯工具

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

    事件轉寄驗證查詢字串

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

    事件轉寄符合資料

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

    事件轉送webhook網站資料

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

下一步：

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