資料收集端對端總覽

Adobe Experience Platform會收集您的資料並傳輸至其他Adobe產品和第三方目的地。 若要將事件資料從您的應用程式傳送至Experience Platform邊緣網路,請務必瞭解這些核心技術,以及如何設定這些技術,以便在需要時將資料傳送至您所需的目的地。

本指南提供如何使用平台的資料收集功能,透過Edge Network傳送事件的高階教學課程。 本教學課程會具體說明在資料收集UI (前身為Adobe Experience Platform Launch)中安裝和設定Adobe Experience Platform Web SDK標籤擴充功能的步驟。

NOTE
如果您不想使用標籤,也可以選擇手動安裝及設定SDK,但周圍的步驟仍必須如以下所述完成。
所有涉及資料收集UI的步驟也可在Experience Platform UI中執行。

先決條件

本教學課程使用資料收集UI來建立結構、設定資料串流及安裝Web SDK。 若要在UI中執行這些動作,您必須被授與至少一個Web屬性的存取權以及下列專案 屬性權利

  • 開發
  • 管理擴充功能

請參閱以下指南: 管理資料收集的許可權 以瞭解如何授予屬性和屬性許可權的存取權。

若要使用本指南中提到的各種資料收集產品,您也必須有權存取資料串流,並能夠建立和管理結構描述。 如果您需要存取其中任何一項功能,請聯絡您的Adobe帳戶團隊以協助您取得必要的存取權。 請注意,如果您尚未購買Adobe Experience Platform,Adobe會免費提供您使用SDK的必要存取權。

如果您已有Platform的存取權,請務必確保您已擁有 許可權 啟用下列類別:

  • 資料模型製作
  • 身分

請參閱 存取控制UI總覽 以瞭解如何將Platform功能的許可權授與使用者。

程式摘要

為您的網站設定資料收集的流程可概括如下:

  1. 建立結構描述 以判斷資料傳送至Edge Network時的結構方式。
  2. 建立資料串流 以設定要將資料傳送至哪些目的地。
  3. 安裝及設定Web SDK 當您的網站上發生某些事件時,將資料傳送至資料串流的方式。

一旦您可以將資料傳送至Edge Network,您也可以選擇使用 設定事件轉送 貴組織擁有授權。

建立結構描述 schema

體驗資料模型(XDM) 是開放原始碼規格,可為結構形式的資料提供通用結構和定義。 換句話說,XDM是以邊緣網路和其他Adobe Experience Cloud應用程式可採取行動的方式來建構和格式化您的資料的方式。

設定資料收集作業的第一步,是建立XDM結構描述來代表您的資料。 在本教學課程的稍後步驟中,您會將您要傳送的資料對應至此結構描述的結構。

NOTE
XDM結構描述很容易自訂。 以下概述的步驟並非過度規範化,而是特別針對Web SDK的結構需求。 在這些引數之外,您可以任意定義資料的其他結構。

在UI中,選取 方案 ,位於左側導覽器中。 從這裡,您可以看到先前建立的、屬於您組織的結構描述清單。 若要繼續,請選取 建立結構描述,然後選取 XDM ExperienceEvent 下拉式選單中的。

結構描述工作區

會出現一個對話方塊,提示您開始將欄位群組新增到結構描述。 若要使用Web SDK傳送事件,您必須新增欄位群組 AEP Web SDK ExperienceEvent Mixin. 此欄位群組包含由Web SDK程式庫自動收集之資料屬性的定義。

使用搜尋列縮小清單的範圍,協助您更輕鬆地尋找此欄位群組。 找到後,從清單中選取它,然後選取 新增欄位群組.

結構描述工作區

結構描述畫布隨即顯示,顯示XDM結構描述的樹狀結構,包括Web SDK欄位群組提供的欄位。

綱要結構

在樹狀結構中選取要開啟的根欄位 結構描述屬性 在右側邊欄中,您可以為結構描述提供名稱和選擇性說明。

為結構命名

如果您想要將更多欄位新增到結構描述,您可以選取 新增欄位群組 區段。

新增欄位群組

NOTE
請參閱以下指南: 新增欄位群組 XDM檔案中有關如何搜尋不同欄位群組以符合您使用案例的詳細步驟。
最佳實務是只為您計畫透過Edge Network傳送的資料新增欄位。 將欄位新增到結構描述並儲存後,之後只能對結構描述進行附加變更。 請參閱以下小節: 結構描述演化的規則 以取得詳細資訊。

新增所需的欄位後,請選取 儲存 以儲存結構。

儲存結構描述

建立資料串流 datastream

資料串流是一種設定,可告知Edge Network您要將資料傳送至何處。 具體而言,資料串流會指定您要將資料傳送至哪些Experience Cloud產品,以及您想要如何在每個產品中處理和儲存資料。

NOTE
如果您想使用 事件轉送 (假設您的組織已獲得功能授權),您必須以啟用Adobe產品的相同方式,為資料流啟用它。 有關此程式的詳細資訊,請參見 稍後區段.

選取 資料串流 ,位於左側導覽器中。 從這裡,您可以從清單中選取要編輯的現有資料流,也可以透過選取來建立新設定 新增資料串流.

資料串流

資料串流的設定需求取決於您要將資料傳送至哪些產品和功能。 如需每個產品組態選項的詳細資訊,請參閱 資料串流概觀.

安裝及設定Web SDK install

建立方案和資料流後,下一步就是安裝和設定Platform Web SDK,以開始傳送資料給Edge Network。

NOTE
本節使用資料收集UI來設定Web SDK標籤擴充功能,但您也可以改用原始程式碼來安裝和設定。 如需詳細資訊,請參閱下列指南:
另請注意,即使您只想使用事件轉送,您仍必須如所述安裝和設定SDK,才能在設定事件轉送 後續步驟.

此程式可彙總如下:

  1. 在標籤屬性上安裝Adobe Experience Platform Web SDK 以存取其功能。
  2. 建立XDM物件資料元素 將網站上的變數對應至您先前建立的XDM結構描述的結構。
  3. 建立規則 告訴SDK何時應將資料傳送至Edge Network。
  4. 建置及安裝程式庫 ,以在您的網站上實作規則。

在標籤屬性上安裝SDK install-sdk

選取 標籤 ,以顯示標籤屬性清單。 您可以視需要選擇要編輯的現有屬性,也可以選取 新增屬性 而非。

屬性

如果建立新屬性,請提供描述性名稱並設定 Platform 至 Web. 提供Web屬性的完整網域,然後選取 儲存.

建立屬性

屬性的概述頁面隨即顯示。 從這裡,選擇 擴充功能 在左側導覽中,然後選取 目錄. 尋找Platform Web SDK的清單(可選擇使用搜尋列來縮小結果範圍)並選取 安裝.

安裝Web SDK

SDK的設定頁面隨即顯示。 大部分必要值都會自動填入預設值,您可以視需要選擇變更。

設定Web SDK

不過,在安裝SDK之前,您必須選取資料流,讓資料流知道要將您的資料傳送至何處。 在 資料串流,使用下拉式選單來選取您在 更早的步驟. 設定資料流後,選取 儲存 以完成SDK至屬性的安裝。

設定資料流並儲存

建立XDM資料元素 data-element

為了讓SDK將資料傳送至Edge Network,該資料必須對應至您在 上一步. 此對應可透過使用資料元素來完成。

在UI中,選取 資料元素,然後選取 建立新資料元素.

建立新資料元素

在下一個畫面,選取 Adobe Experience Platform Web SDK 在 副檔名 下拉式清單,然後選取 xdm物件 (資料元素型別)。

XDM物件型別

隨即顯示XDM物件型別的組態對話方塊。 該對話方塊會自動選取您的Platform沙箱,從這裡您可以看到在該沙箱中建立的所有結構描述。 從清單中選取您先前建立的XDM結構描述。

XDM物件型別

結構描述的結構隨即顯示。 所有欄位都有星號(*)表示在觸發事件時自動填入的欄位。 對於所有其他欄位,您可以探索結構描述的結構並填寫其餘資料。

將資料對應至XDM欄位

NOTE
上方的熒幕擷圖示範如何從網站的使用者端(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中,選取 規則 在左側導覽中,然後選取 建立新規則.

規則

在下一個畫面中,提供規則的名稱。 從這裡,下一步是決定規則的事件(換句話說,規則將於何時引發)。 選取 新增 在 活動.

名稱規則

事件組態頁面即會顯示。 若要設定事件,您必須先選取事件型別。 事件型別由擴充功能提供。 例如,若要設定「表單提交」事件,請選取 核心 擴充功能,然後選取 提交 事件型別,在 表單 類別。

NOTE
如需AdobeWeb擴充功能所提供的不同事件型別(包括如何設定)的詳細資訊,請參閱 Adobe擴充功能參考 標籤檔案中。

表單提交事件可讓您使用 CSS選取器 以參照要在其上引發規則的特定元素。 在以下範例中,ID add-to-cart-form ,因此此規則只會針對「加入購物車」表單觸發。 選取 保留變更 將事件新增至規則。

事件設定

規則設定頁面會重新顯示,顯示事件已新增。 您可以縮小"如果",方法為將更多條件新增至規則。

否則,下一步就是新增動作,讓規則在觸發時執行。 選取 新增動作 以繼續。

新增動作

動作組態頁面隨即顯示。 若要取得將資料傳送至Edge Network的規則,請選取 Adobe Experience Platform Web SDK 擴充功能的,以及 傳送事件 (適用於動作型別)。

動作型別

畫面會更新,以顯示其他選項來設定傳送事件動作。 在 型別,您可以提供自訂型別值來填入 eventType XDM欄位。 在 XDM資料,提供您先前建立的XDM資料型別名稱(由百分比符號包圍),或選取資料庫圖示( 資料庫圖示 )以從清單中選取它。 這些資料最終將傳送至Edge Network。

選取 保留變更 完成後。

動作設定

設定完規則後,選取 儲存 以完成程式。

儲存規則

建置及安裝程式庫 library

設定規則後,您就可以將其新增至標籤程式庫、將該程式庫建置至環境,並在您的網站上安裝該建置。

NOTE
如果您尚未在資料收集UI中設定環境,您必須先設定環境,然後才能建立組建。 請參閱以下小節: 設定Web屬性的環境 標籤檔案中以取得詳細資訊。

若要瞭解如何建立程式庫、將擴充功能和規則新增至程式庫,以及將該程式庫建置至環境,請參閱以下指南: 管理程式庫 標籤檔案中。 建立程式庫時,請務必包含Platform Web SDK擴充功能以及您先前建立的資料收集規則。

建立程式庫並將其組建指派給環境後,您就可以將該環境安裝在網站的使用者端。 請參閱以下小節: 安裝環境 以取得詳細資訊。

在網站上安裝環境後,您可以 測試您的實作 使用Adobe Experience Platform Debugger。

設定事件轉送(選擇性) event-forwarding

NOTE
事件轉送僅適用於已獲得授權的組織。

設定SDK將資料傳送至Edge Network後,您就可以設定事件轉送,通知Edge Network您要傳送資料的位置。

若要使用事件轉送,您必須先建立事件轉送屬性。 選取 事件轉送 在左側導覽中,然後選取 新增屬性. 在選取之前提供屬性的名稱 儲存.

建立事件轉送屬性後,下一步就是建立規則以決定應傳送資料的位置。 事件轉送屬性的規則與標籤屬性的建構方式大致相同,唯一例外是不能指定任何事件(因為事件轉送只會處理直接從資料流接收的事件)。 對於規則的動作,您可以使用其中一個可用的事件轉送擴充功能,或改用自訂程式碼來傳送事件。

事件轉送規則

與之前類似,設定規則後,您必須將其新增至程式庫,並將該程式庫建置至環境。

建置完成後,最後一個步驟是更新資料流 先前設定 並啟用事件轉送。 若要開始,請導覽至 資料串流 並從清單中選取相關資料流。 從這裡,啟用事件轉送的切換,並提供您剛設定的屬性和環境名稱。

事件轉送資料串流

後續步驟

本指南提供如何使用Platform Web SDK傳送資料至Edge Network的高階端對端總覽。 如需各種相關元件和服務的詳細資訊,請參閱本指南中的檔案連結。

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1