建立事件轉送屬性

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

  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

    秘訣
    若要將資料傳送至Adobe組織外部的事件轉送環境,請選取​ 手動輸入ID ​並貼入ID。 建立event-forwarding屬性時,系統就會提供ID。
  8. 選取「儲存」。

    事件轉送資料流啟用

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

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

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

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

建立事件轉送資料元素

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

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

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

秘訣
您也可以使用網頁瀏覽器網路工具、篩選/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路徑

    注意
    請務必在路徑中加入arc.event.首碼。 此外,請確保遵循與XDM物件欄位名稱完全相同的大小寫,ECID名稱空間必須全部大寫。
    秘訣
    使用您自己的網站時,您可以透過網頁瀏覽器網路工具找到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. 選取​ 儲存

    儲存事件轉送規則