設定事件轉送屬性

了解如何使用Experience PlatformWeb SDK資料來使用事件轉送屬性。

事件轉送是「資料收集」中可用的新屬性類型。事件轉送功能可讓您直接從Adobe Experience Platform邊緣網路（而非傳統的用戶端瀏覽器），將資料傳送給協力廠商、非Adobe廠商。在事件轉送概觀.

若要在Adobe Experience Platform中使用事件轉送，必須先使用下列三個選項中的一或多個，將資料傳送至Adobe Experience Platform邊緣網路：

注意

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

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

學習目標

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

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

先決條件

包括事件轉發的軟體許可證。事件轉送是資料收集的付費功能。如需詳細資訊，請連絡您的Adobe帳戶團隊。
在您的Experience Cloud組織中啟用事件轉送。
事件轉送的使用者權限。 (輸入 Admin Console，在Adobe Experience Platform Launch產品下方，平台 > Edge 全部屬性權利)。一旦獲得授權，您應該會看到事件轉送在資料收集介面的左側導覽器中：
Adobe Experience Platform Web或Mobile SDK，設定為傳送資料至邊緣網路。您必須完成本教學課程的下列課程：
- 初始配置
- 標籤設定

建立事件轉送屬性

首先，請建立事件轉送屬性：

開啟資料收集介面
選擇 事件轉送 從左側導覽
選擇 新屬性.
為屬性命名。在這種情況下 Server-Side - Web SDK Course
選取「儲存」。

設定資料流

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

若要在資料流中設定Target:

前往資料收集介面
在左側導覽列中，選取 資料流
選取先前建立的 Luma Web SDK 資料流
選擇 添加服務
選擇 事件轉送 作為服務
在 屬性ID 下拉式清單中，選取您為事件轉送屬性指定的名稱，在此案例中為 Server-Side - Web SDK Course
在 環境ID 下拉式清單中，選取您要連結事件轉送環境至的標籤環境（在此例中為） Development

秘訣

若要將資料傳送至Adobe組織以外的事件轉送環境，請選取 手動輸入ID 並貼入ID。建立事件轉送屬性時，會提供ID。
選取「儲存」。

當您準備好透過發佈流程促銷您的變更時，請對測試和生產資料流重複這些步驟。

將資料從Platform Edge Network轉發到非Adobe解決方案

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

注意

Webhook是一種半即時整合不同系統的方法。 Webhook.site 是協力廠商工具，可讓您輕鬆檢查、測試和自動化（透過視覺化的自訂動作產生器或WebhookScript）任何傳入的HTTP要求或電子郵件。

重要

您必須已建立資料元素並將其對應至XDM物件，以及已設定的標籤規則，且已在程式庫內建置這些變更至標籤環境，以便進一步處理。若尚未，請參閱 標籤設定 步驟必要條件區段。這些步驟可確保將資料傳送至平台邊緣網路，您可從該處設定事件轉送屬性，將資料轉送至非Adobe解決方案。

建立事件轉送資料元素

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

重要

在事件轉送中參考XDM欄位與其他內容時，有一個主要語法差異。若要參考事件轉送屬性中的資料，資料元素路徑必須包含 arc.event 前置詞：

其中 arc 代表 Adobe Response Context。
例如︰arc.event.xdm.web.webPageDetails.URL

如果此路徑指定不正確，則不會收集資料。

在本練習中，您會將瀏覽器檢視區高度和Experience CloudID從XDM物件轉送至Webhook。 XDM欄位路徑由設定XDM結構教訓。

秘訣

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

前往 事件轉送 您最近建立的屬性
在左側導覽列中，選取 資料元素
選擇 建立新資料元素
將資料元素命名為 environment.browserDetails.viewportHeight
在 擴充功能，離開 CORE
在 資料元素類型，選取 Path
輸入包含瀏覽器檢視區高度的XDM物件路徑 arc.event.xdm.environment.browserDetails.viewportHeight
選擇儲存
建立其他資料元素
名稱 it ecid
在 擴充功能，離開 CORE
在 資料元素類型，選取 Path
輸入包含Experience CloudID的XDM物件路徑 arc.event.xdm.identityMap.ECID.0.id
選擇儲存

注意

請務必將 arc.event. 前置詞。此外，請務必遵循XDM物件欄位名稱的確切大小寫，ECID命名空間必須以全大寫表示。

秘訣

使用您自己的網站時，您可以使用網頁瀏覽器網路工具找到XDM物件路徑，並篩選 /ee 請求，開啟信標裝載並向下切入您要尋找的變數。然後，用滑鼠按一下滑鼠右鍵，然後選取「複製屬性路徑」。以下是「瀏覽器檢視區高度」的範例：

安裝Adobe雲端連接器擴充功能

若要將資料傳送至協力廠商位置，請先安裝 Adobe雲端連接器擴充功能。

選擇 擴充功能 在左側導覽列上
選取目錄標籤
搜尋 Adobe雲端連接器，選取安裝

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

建立事件轉送規則

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

事件 & 條件:
- 標籤:所有規則皆由必須在規則中指定的事件觸發，例如 Library Loaded - Page Top. 條件為選用。
- 事件轉送:假設傳送至Platform Edge Network的每個事件都是轉送資料的觸發器。因此，事件事件轉送規則中必須選取的項目。若要管理哪些事件會觸發事件轉送規則，您必須設定條件。
資料元素代碼化:
- 標籤:資料元素名稱會以 % 在規則中使用時，會顯示在資料元素名稱的開頭和結尾。例如 %viewportHeight%。
- 事件轉送:資料元素名稱會以標籤 {{ 在開頭和 }} 在規則中使用時，會顯示在資料元素名稱的結尾。例如 {{viewportHeight}}。
規則動作順序:
- 事件轉送規則的「動作」區段一律會依序執行。儲存規則時，請確認動作順序正確。此執行序列無法像使用標籤一樣非同步執行。

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

前往 Webhook.site
查找 您的唯一URL，您會將此作為事件轉送規則中的URL要求
選擇 複製到剪貼簿
請保持此視窗開啟，因為您將能夠驗證Webhook即時擷取的事件轉送資料
回去 資料收集 > 事件轉送 > 規則從左側導覽
選擇 建立新規則
為其命名 all events - ad cloud connector - webhook
新增動作
在 擴充功能，選取 Adobe雲端連接器
在 動作類型，選取 進行擷取呼叫
將您的網頁連結URL貼入 URL 欄位
在 [查詢參數]，您會新增先前建立的兩個資料元素。
在金鑰欄類型 viewPortHeight. 在值欄，輸入 {{environment.browserDetails.viewportHeight}} 資料元素，方法是在中輸入資料元素或從資料元素選取器圖示中選取
選擇 +新增其他 添加其他查詢參數
在金鑰欄類型 ecid. 在值欄中，輸入 {{ecid}} 資料元素
選擇 保留變更
您的規則應如下所示
選擇儲存