資料收集端對端總覽
Adobe Experience Platform會收集您的資料並傳輸至其他Adobe產品和第三方目的地。 若要將事件資料從您的應用程式傳送至Experience PlatformEdge Network,請務必瞭解這些核心技術,以及如何設定這些技術,以在需要時將資料傳送至您所需的目的地。
本指南提供高階教學課程,說明如何使用Platform的資料收集功能,透過Edge Network傳送事件。 本教學課程會具體說明在資料收集UI (前身為Adobe Experience Platform Launch)中安裝和設定Adobe Experience Platform Web SDK標籤擴充功能的步驟。
先決條件
本教學課程使用資料收集UI來建立結構、設定資料串流及安裝Web SDK。 若要在UI中執行這些動作,您必須被授與至少一個Web屬性的存取權以及下列屬性權利:
- 開發
- 管理擴充功能
請參閱管理資料彙集的許可權指南,瞭解如何授予屬性和屬性許可權的存取權。
若要使用本指南中提到的各種資料收集產品,您也必須有權存取資料串流,並能夠建立和管理結構描述。 如果您需要存取其中任何一項功能,請聯絡您的Adobe帳戶團隊以協助您取得必要的存取權。 請注意,如果您尚未購買Adobe Experience Platform,Adobe會免費提供您使用SDK的必要存取權。
如果您已經擁有Platform的存取權,您必須確定您已啟用下列類別下的所有許可權:
- 資料模型製作
- 身分
請參閱存取控制UI總覽,瞭解如何將Platform功能的許可權授與使用者。
程式摘要
為您的網站設定資料收集的流程可概括如下:
- 建立結構描述,以決定資料傳送至Edge Network時的結構方式。
- 建立資料流以設定要將您的資料傳送到哪些目的地。
- 安裝並設定Web SDK,以便在您的網站上發生某些事件時,將資料傳送至資料流。
一旦您能夠將資料傳送至Edge Network,如果您組織擁有事件轉送的授權,您也可選擇性設定事件轉送。
建立結構描述 schema
Experience Data Model (XDM)是開放原始碼規格,以結構描述的形式提供資料的一般結構和定義。 換句話說,XDM是以可由Edge Network和其他Adobe Experience Cloud應用程式執行的方式建構和格式化您的資料的一種方式。
設定資料收集作業的第一步,是建立XDM結構描述來代表您的資料。 在本教學課程的稍後步驟中,您會將您要傳送的資料對應至此結構描述的結構。
在UI中,選取左側導覽中的 結構描述。 從這裡,您可以看到先前建立的、屬於您組織的結構描述清單。 若要繼續,請選取 建立結構描述,然後從下拉式選單中選取 XDM ExperienceEvent。
會出現一個對話方塊,提示您開始將欄位群組新增到結構描述。 若要使用Web SDK傳送事件,您必須新增欄位群組 AEP Web SDK ExperienceEvent Mixin。 此欄位群組包含由Web SDK程式庫自動收集之資料屬性的定義。
使用搜尋列縮小清單的範圍,協助您更輕鬆地尋找此欄位群組。 找到後,請先從清單中選取它,再選取 新增欄位群組。
結構描述畫布隨即顯示,顯示XDM結構描述的樹狀結構,包括Web SDK欄位群組提供的欄位。
選取樹狀結構中的根欄位以開啟右側邊欄中的 結構描述屬性,您可以在其中提供結構描述的名稱和選擇性描述。
如果您想要將更多欄位新增到結構描述中,您可以選取左側邊欄中 欄位群組 區段下的 新增 來執行此操作。
新增您需要的欄位後,選取 儲存 以儲存結構描述。
建立資料串流 datastream
資料串流是一種設定,可告知Edge Network您希望將資料傳送到的位置。 具體而言,資料串流會指定您要將資料傳送至哪些Experience Cloud產品,以及您想要如何在每個產品中處理和儲存資料。
在左側導覽中選取 資料串流。 從這裡,您可以從清單中選取要編輯的現有資料流,或是選取 新增資料流 以建立新的設定。
資料串流的設定需求取決於您要將資料傳送至哪些產品和功能。 如需每個產品組態選項的詳細資訊,請參閱資料串流總覽。
安裝及設定Web SDK install
建立方案和資料流後,下一步就是安裝和設定Platform Web SDK,以開始傳送資料給Edge Network。
此程式可彙總如下:
- 在標籤屬性上安裝Adobe Experience Platform Web SDK以存取其功能。
- 建立XDM物件資料元素,將您網站上的變數對應到您先前建立的XDM結構描述結構。
- 建立規則以告知SDK何時應將資料傳送至Edge Network。
- 建置並安裝程式庫以在您的網站上實作規則。
在標籤屬性上安裝SDK install-sdk
在左側導覽中選取 標籤 以顯示標籤屬性清單。 您可以視需要選擇現有屬性進行編輯,也可以改為選取 新增屬性。
如果建立新屬性,請提供描述性名稱,並將平台設定為 Web。 提供Web屬性的完整網域,然後選取 儲存。
屬性的概述頁面隨即顯示。 從這裡,在左側導覽中選取 擴充功能,然後選取 目錄。 尋找Platform Web SDK的清單(可選擇使用搜尋列來縮小結果範圍),並選取 安裝。
SDK的設定頁面隨即顯示。 大部分必要值都會自動填入預設值,您可以視需要選擇變更。
不過,在安裝SDK之前,您必須選取資料流,讓資料流知道要將您的資料傳送至何處。 在 資料串流 底下,使用下拉式功能表選取您在先前步驟設定的資料串流。 設定資料串流後,請選取 儲存 以完成將SDK安裝到屬性。
建立XDM資料元素 data-element
為了讓SDK將資料傳送至Edge Network,該資料必須對應至您在先前步驟中建立的XDM結構描述。 此對應可透過使用資料元素來完成。
在UI中,選取 資料元素,然後選取 建立新資料元素。
在下一個畫面中,選取擴充功能下拉式清單中的 Adobe Experience Platform Web SDK,然後為資料元素型別選取 XDM物件。
隨即顯示XDM物件型別的組態對話方塊。 該對話方塊會自動選取您的Platform沙箱,從這裡您可以看到在該沙箱中建立的所有結構描述。 從清單中選取您先前建立的XDM結構描述。
結構描述的結構隨即顯示。 所有具有星號(*)的欄位都表示在觸發事件時自動填入的欄位。 對於所有其他欄位,您可以探索結構描述的結構並填寫其餘資料。
%
)包圍),將可全域存取的變數從您網站的使用者端(cartAbandonsTotal
)對應至XDM欄位。完成將資料對應到結構描述後,請先提供資料元素的名稱,再選取 儲存。
建立規則
儲存資料元素後,下一步就是建立規則,每當網站上發生特定事件(例如客戶將產品新增至購物車時)時,就會傳送給Edge Network。
您幾乎可以為任何可能發生在您網站上的事件設定規則。 例如,本節說明如何建立客戶提交表單時會觸發的規則。 以下HTML代表具有「加入購物車」表單的簡單網頁,此表單將成為規則的主題:
<!DOCTYPE html>
<html>
<body>
<form id="add-to-cart-form">
<label for="item">Product:</label><br>
<input type="text" id="item" name="item"><br>
<label for="amount">Amount:</label><br>
<input type="number" id="amount" name="amount" value="1"><br><br>
<input type="submit" value="Add to Cart">
</form>
</body>
</html>
在資料收集UI中,選取左側導覽中的 規則,然後選取 建立新規則。
在下一個畫面中,提供規則的名稱。 從這裡,下一步是決定規則的事件(換句話說,規則將於何時引發)。 選取事件下的 新增。
事件組態頁面即會顯示。 若要設定事件,您必須先選取事件型別。 事件型別由擴充功能提供。 若要設定「表單提交」事件,例如,請選取 核心 擴充功能,然後在 表單 類別下選取 提交 事件型別。
表單提交事件可讓您使用CSS選取器來參照要引發規則的特定元素。 在下列範例中,已使用ID add-to-cart-form
,因此此規則只會針對「加入購物車」表單觸發。 選取 保留變更 以將事件新增至規則。
規則設定頁面會重新顯示,顯示事件已新增。 您可以進一步新增條件至規則,以縮小"If"的範圍。
否則,下一步就是新增動作,讓規則在觸發時執行。 選取 動作 下的 新增 以繼續。
動作組態頁面隨即顯示。 若要取得傳送資料給Edge Network的規則,請為擴充功能選取 Adobe Experience Platform Web SDK,並為動作型別選取 傳送事件。
畫面會更新,以顯示其他選項來設定傳送事件動作。 在 型別 底下,您可以提供自訂型別值來填入eventType
XDM欄位。 在 XDM資料 下,提供您先前建立的XDM資料型別的名稱(以百分比符號包圍),或選取資料庫圖示(
)以從清單中選取它。 這是最終將傳送至Edge Network的資料。
完成時選取 保留變更。
完成規則設定後,請選取 儲存 以完成程式。
建置及安裝程式庫 library
設定規則後,您就可以將其新增至標籤程式庫、將該程式庫建置至環境,並在您的網站上安裝該建置。
若要瞭解如何建立程式庫、將擴充功能和規則新增至程式庫,以及將該程式庫建置至環境,請參閱標籤檔案中有關管理程式庫的指南。 建立程式庫時,請務必包含Platform Web SDK擴充功能以及您先前建立的資料收集規則。
建立程式庫並將其組建指派給環境後,您就可以將該環境安裝在網站的使用者端。 如需詳細資訊,請參閱安裝環境的相關章節。
在網站上安裝環境後,您就可以使用Adobe Experience Platform Debugger測試您的實作。
設定事件轉送(選擇性) event-forwarding
在設定SDK將資料傳送至Edge Network後,您就可以設定事件轉送,以告知Edge Network您要將資料傳送至何處。
若要使用事件轉送,您必須先建立事件轉送屬性。 在左側導覽中選取 事件轉送,然後選取 新增屬性。 在選取 儲存 之前,提供屬性的名稱。
建立事件轉送屬性後,下一步就是建立規則以決定應傳送資料的位置。 事件轉送屬性的規則與標籤屬性的建構方式大致相同,唯一例外是不能指定任何事件(因為事件轉送只會處理直接從資料流接收的事件)。 對於規則的動作,您可以使用其中一個可用的事件轉送擴充功能,或改用自訂程式碼來傳送事件。
與之前類似,設定規則後,您必須將其新增至程式庫,並將該程式庫建置至環境。
建置完成後,最後一個步驟是更新您先前設定的資料流,並啟用事件轉送。 若要開始,請導覽至 資料串流,並從清單中選取有問題的資料串流。 從這裡,啟用事件轉送的切換,並提供您剛設定的屬性和環境名稱。
後續步驟
本指南提供如何使用Platform Web SDK傳送資料給Edge Network的高階端對端總覽。 如需各種相關元件和服務的詳細資訊,請參閱本指南中的檔案連結。