擷取串流資料

在本課程中,您將使用Adobe Experience Platform Web SDK串流資料。

在資料收集介面中,我們必須完成兩項主要工作:

  • 我們必須在Luma網站上實作Web SDK,以將有關網站訪客活動的資料傳送至Adobe Edge網路。 我們將使用標籤(先前稱為Launch)進行簡單的實作

  • 我們必須設定資料串流,告訴Edge網路將資料轉送至何處。 我們會將其設定為將資料傳送至 Luma Web Events Platform沙箱中的資料集。

資料工程師 需要在本教學課程以外擷取串流資料。 實作Adobe Experience Platform的Web或行動SDK時,通常會有Web或行動開發人員參與資料層建立和標籤屬性設定。

在開始練習之前,請觀看這兩個短片,以進一步瞭解串流資料擷取和Web SDK:

NOTE
雖然本教學課程的重點是使用Web SDK從網站串流擷取,但您也可以使用 Adobe行動SDKApache Kafka Connect和其他機制。

需要的許可權

設定許可權 課程,您已設定完成本課程所需的所有存取控制項。

設定資料串流

首先,我們將設定資料串流。 資料串流會告訴Adobe Edge網路,在從Web SDK呼叫收到資料後,應將資料傳送至何處。 例如,您要將資料傳送至Experience Platform、Adobe Analytics或Adobe Target嗎? 資料串流在資料收集使用者介面(前身為Launch)中進行管理,對於透過Web SDK進行資料收集至關重要。

若要建立 資料流:

  1. 登入 Experience Platform資料收集使用者介面

  2. 選取 資料串流 在左側導覽列中

  3. 選取 新增資料串流 按鈕於右上角

    在左側導覽中選取資料串流

  4. 對於 易記名稱,輸入 Luma Platform Tutorial (如果貴公司的多人參加本教學課程,請在結尾加上您的姓名)

  5. 選取 儲存 按鈕

    命名資料流並儲存

在下一個畫面中,您指定要傳送資料的位置。 若要傳送資料給Experience Platform:

  1. 開啟 Adobe Experience Platform 以公開其他欄位
  2. Sandbox,選取 Luma Tutorial
  3. 事件資料集,選取 Luma Web Events Dataset
  4. 如果您使用其他Adobe應用程式,歡迎探索其他區段,以瞭解在這些其他解決方案的「邊緣組態」中需要哪些資訊。 請記住,開發Web SDK不僅是為了將資料串流到Experience Platform中,也是為了取代其他Adobe應用程式使用的所有先前JavaScript程式庫。 「邊緣組態」可用來指定您要傳送資料之各應用程式的帳戶詳細資料。
  5. 選取 儲存
    設定資料流並儲存

邊緣設定儲存後,產生的畫面會顯示已建立用於開發、測試和生產的三個環境。 可以新增其他開發環境:
每個Edge設定可以有多個環境
這三個環境都包含您剛才輸入的平台詳細資料。 不過,這些詳細資料可依環境以不同方式設定。 例如,您可以讓每個環境將資料傳送至不同的Platform沙箱。 在本教學課程中,我們將不會針對資料流執行任何其他自訂。

安裝Web SDK擴充功能

新增屬性

首先,我們必須建立標籤屬性(先前稱為標籤屬性)。 屬性是一個容器,內含從網頁收集詳細資訊並傳送至不同位置所需的所有JavaScript、規則和其他功能。

若要建立屬性:

  1. 前往 屬性 在左側導覽列中
  2. 選取 新增屬性 按鈕
    新增屬性
  3. 作為 名稱,輸入 Luma Platform Tutorial (如果貴公司的多人參加本教學課程,請在結尾加上您的姓名)
  4. 作為 網域,輸入 enablementadobe.com (稍後說明)
  5. 選取 儲存
    屬性詳細資料

新增Web SDK擴充功能

現在您有了屬性,可以使用擴充功能新增Web SDK。 擴充功能是擴充資料收集介面和功能的程式碼套件。 新增擴充功能的方式:

  1. 開啟您的標籤屬性
  2. 前往 擴充功能 在左側導覽列中
  3. 前往 目錄 標籤
  4. 有許多擴充功能可供標籤使用。 使用辭彙篩選目錄 Web SDK
  5. Adobe Experience Platform Web SDK 擴充功能中,選取 安裝 按鈕
    安裝Adobe Experience Platform Web SDK擴充功能
  6. Web SDK擴充功能有數種設定可供使用,但在本教學課程中,我們將只會設定兩種。 更新 邊緣網域data.enablementadobe.com. 此設定可讓您在Web SDK實作中設定第一方Cookie (建議使用)。 在本課程稍後部分中,您會將網站對應 enablementadobe.com 網域至您的標籤屬性。 的CNAME enablementadobe.com 網域已設定為 data.enablementadobe.com 將轉送至Adobe伺服器。 在您自己的網站上實作Web SDK時,必須針對您自己的資料收集目的建立CNAME,例如 data.YOUR_DOMAIN.com
  7. 資料流 下拉式清單,選取您的 Luma Platform Tutorial 資料流。
  8. 歡迎檢視其他設定選項(但請勿變更!) 然後選取 儲存

建立規則以傳送資料

現在我們將建立規則以將資料傳送至Platform。 規則是事件、條件和動作的組合,可指示標籤執行某項動作。 建立規則的方式:

  1. 前往 規則 在左側導覽列中
  2. 選取 建立新規則 按鈕
    建立規則
  3. 將規則命名為 All Pages - Library Loaded
  4. 活動,選取 新增 按鈕
    為規則命名並新增事件
  5. 使用 核心 副檔名 並選取 程式庫已載入(頁面頂端) 作為 事件型別. 此設定表示每當頁面上載入Launch程式庫時,就會觸發規則。
  6. 選取 保留變更 以返回主規則畫面
    新增「程式庫已載入」事件
  7. 離開 條件 空白,因為我們希望此規則在所有頁面上引發(根據我們提供的名稱)
  8. 動作,選取 新增 按鈕
  9. 使用 Adobe Experience Platform Web SDK 副檔名 並選取 傳送事件 作為 動作型別
  10. 在右側,選取 web.webpagedetails.pageViews型別 下拉式清單。 這是我們的其中一個XDM欄位 Luma Web Events Schema
  11. 選取 保留變更 以返回主規則畫面
    新增「傳送事件」動作
  12. 選取 儲存 儲存規則的方式
    儲存規則

在程式庫中發佈規則

接下來,我們將規則發佈至開發環境,以便驗證它是否有效。

若要建立程式庫:

  1. 前往 發佈流程 在左側導覽列中
  2. 選取 新增程式庫
    選取新增程式庫
  3. 對於 名稱,輸入 Luma Platform Tutorial
  4. 對於 環境,選取 Development
  5. 選取 新增所有變更的資源 按鈕。 (除了 Adobe Experience Platform Web SDK 擴充功能與 All Pages - Library Loaded 規則,您也會看到 核心 新增的擴充功能包含所有Launch Web屬性所需的基本JavaScript。)
  6. 選取 儲存並為開發環境建置 按鈕
    建立及建置程式庫

程式庫可能需要幾分鐘的時間才能建置,建置完成後,程式庫名稱左側會顯示一個綠色點:
建置完成

如您所見 發佈流程 畫面中,發佈程式還有許多不在本教學課程的討論範圍內。 我們即將在開發環境中使用單一程式庫。

驗證請求中的資料

新增Adobe Experience Platform Debugger

Experience Platform Debugger是適用於Chrome和Firefox瀏覽器的擴充功能,可協助您檢視在網頁中實作的Adobe技術。 下載您偏好瀏覽器的版本:

如果您從未使用過Debugger,而且此版本與舊版Adobe Experience Cloud Debugger不同,您可能會想觀看這段五分鐘的概述影片:

開啟Luma網站

在本教學課程中,我們使用公開託管版本的Luma示範網站。 請開啟檔案並將其加入書籤:

  1. 在新的瀏覽器標籤中,開啟 Luma網站.
  2. 將頁面加入書籤,以便在教學課程的其餘部分使用

我們之所以使用這個託管網站 enablementadobe.com 在 網域 初始標籤屬性設定的欄位,以及我們使用的原因 data.enablementadobe.com 作為我們在 Adobe Experience Platform Web SDK 副檔名。 我有一個計畫!

Luma首頁

使用Experience Platform偵錯工具來對應至您的標籤屬性

Experience Platform Debugger有一種很酷的功能,可讓您使用其他標籤屬性來取代現有的標籤屬性。 這對於驗證非常有用,可讓我們略過本教學課程中的許多實作步驟。

  1. 請確定您已開啟Luma網站,並選取Experience PlatformDebugger擴充功能圖示

  2. Debugger將會開啟並顯示硬式編碼實作的部分詳細資料,這些詳細資料與本教學課程無關(您可能需要在開啟Debugger後重新載入Luma網站)

  3. 確認Debugger為"已連線至Luma",如下圖所示,然後選取"鎖定」圖示可將Debugger鎖定至Luma網站。

  4. 選取 登入 按鈕以進行驗證。

  5. 現在移至 Launch 在左側導覽列中

  6. 選取設定索引標籤

  7. 在它顯示的右側 頁面內嵌程式碼,開啟 動作 下拉式清單,然後選取 取代
    選取動作>取代

  8. 由於您已通過驗證,Debugger將會提取您可用的Launch屬性和環境。 選取您的 Luma Platform Tutorial 屬性

  9. 選取您的 Development 環境

  10. 選取 套用 按鈕
    選取替代標籤屬性

  11. Luma網站現在將重新載入 使用您的標籤屬性. 救命,我已經被黑進去了! 開玩笑的。
    已取代標籤屬性

  12. 前往 摘要 在左側導覽中,檢視您的詳細資訊 Launch 屬性
    摘要標籤

  13. 現在移至 AEP Web SDK ,以檢視 網路要求

  14. 開啟 事件

    Adobe Experience Platform Web SDK請求

  15. 請注意我們能看到的 web.webpagedetails.pageView 我們指定的事件型別 傳送事件 動作,以及其他附加在上的現成可用變數 AEP Web SDK ExperienceEvent Mixin 格式
    事件詳細資料

  16. 這些型別的請求詳細資訊也會顯示在瀏覽器的網頁開發人員工具中 網路 標籤。 開啟並重新載入頁面。 篩選呼叫,使用 interact 若要尋找呼叫,請選取該呼叫,然後檢視 標頭 標籤, 請求裝載 區域。
    網路索引標籤

  17. 前往 回應 標籤,並記下ECID值如何包含在回應中。 複製此值,因為您將在下一個練習中使用它來驗證設定檔資訊。
    網路索引標籤

驗證Experience Platform中的資料

您可以檢視到達Platform的資料批次,以驗證資料是否登陸 Luma Web Events Dataset. (我知道,這稱為串流資料擷取,但現在我的意思是,它會以批次方式到達! 它會即時串流至設定檔,因此可用於即時細分和啟動,但每15分鐘會批次傳送至資料湖。)

驗證資料:

  1. 在Platform使用者介面,前往 資料集 在左側導覽列中
  2. 開啟 Luma Web Events Dataset 並確認批次已到。 請記住,每15分鐘傳送一次,因此您可能需要等待批次顯示。
  3. 選取 預覽資料集 按鈕
    開啟資料集
  4. 在預覽強制回應視窗中,請注意如何選取左側結構描述的不同欄位,以預覽這些特定資料點:
    預覽欄位

您也可以確認新設定檔是否顯示:

  1. 在Platform使用者介面,前往 設定檔 在左側導覽列中
  2. 選取 ECID 名稱空間並搜尋您的ECID值(從回應中複製)。 設定檔會有專屬的ID,獨立於ECID。
  3. 選取 設定檔ID 以開啟設定檔
    尋找並開啟設定檔
  4. 選取 活動 索引標籤以檢視您檢視的頁面
    設定檔事件 \

新增自訂資料至事件

建立頁面名稱的資料元素

  1. 在資料收集標籤介面中,於 Luma Platform Tutorial 屬性,開啟 選取工作程式庫 下拉式清單,然後選取 Luma Platform Tutorial 資料庫。 此設定可讓您更輕鬆地向程式庫發佈其他更新。

  2. 現在移至 資料元素 在左側導覽列中

  3. 選取 建立新資料元素 按鈕

    建立新的資料元素

  4. 作為 名稱,輸入 Page Name

  5. 作為 資料元素型別,選取 JavaScript Variable

  6. 作為 javascript變數名稱,輸入 digitalData.page.pageInfo.pageName

  7. 若要協助標準化值的格式,請勾選 強制小寫值清除文字

  8. 請確定 Luma Platform Tutorial 已選取作為工作程式庫

  9. 選取 儲存至程式庫
    建立頁面名稱的資料元素

將頁面名稱對應至XDM物件資料元素

現在,我們將頁面名稱對應至Web SDK。

IMPORTANT
為了完成此任務,我們需要確保您的使用者首先有權存取Prod沙箱。 如果您還無法從其他產品設定檔存取Prod沙箱,請快速開啟 Luma Tutorial Platform 設定檔並新增許可權專案 沙箱 > Prod. 之後,在資料元素頁面上按住SHIFT鍵重新載入,即可清除您的快取
新增Prod沙箱

資料元素 頁面:

  1. 建立新的資料元素
  2. 作為 名稱,輸入 XDM Object
  3. 作為 副檔名,選取 Adobe Experience Platform Web SDK
  4. 作為 資料元素型別,選取 XDM object
  5. 作為 Sandbox,選取您的 Luma Tutorial 沙箱
  6. 作為 結構描述,選取您的 Luma Web Events Schema
  7. 選取 web.webPageDetails.name 欄位
  8. 作為 ,選取圖示以開啟資料元素選取強制回應視窗,然後選擇 Page Name 資料元素
  9. 選取 儲存至程式庫
    將頁面名稱對應至XDM物件資料元素

此相同程式用於將網站上的其他自訂資料對應至XDM欄位。

新增XDM資料至您的「傳送事件」動作

現在,您已將資料對應至XDM欄位,可以將它包含在您的「傳送事件」動作中:

  1. 前往 規則 畫面
  2. 開啟您的 All Pages - Library Loaded 規則
  3. 開啟 Adobe Experience Platform Web SDK - Send Event 動作
  4. 作為 XDM資料,選取圖示以開啟資料元素選取強制回應視窗,然後選擇 XDM Object 資料元素
  5. 選取 保留變更 按鈕
    新增XDM資料至您的「傳送事件」動作
  6. 現在,由於您已 Luma Platform Tutorial 您選取作為最近幾個練習的工作程式庫,您最近的變更已直接儲存至程式庫。 您不必透過發佈流程畫面發佈變更,只要開啟藍色按鈕上的下拉式清單,然後選取 儲存至程式庫並建置
    儲存至程式庫並建置

這會開始建立新的標籤程式庫,其中包含您剛才進行的三項變更。

驗證XDM資料

如前所述,當您使用Debugger對應至您的標籤屬性時,現在應該能夠重新載入Luma首頁,並看到頁面名稱欄位會填入請求中!
驗證XDM資料

您也可以透過預覽資料集和設定檔,驗證在Platform中收到的頁面名稱資料。

傳送其他身分

您的Web SDK實作現在正在傳送以Experience CloudID (ECID)作為主要識別碼的事件。 ECID會由Web SDK自動產生,且每個裝置和瀏覽器皆不重複。 根據他們使用的裝置和瀏覽器,單一客戶可以有多個ECID。 那麼,我們如何取得此客戶的統一檢視,並將其線上活動連結至CRM、忠誠度和離線購買資料? 為此,我們會在工作階段期間收集其他身分,並透過身分拼接決定性地連結其設定檔。

如果您還記得,我曾說過我們會使用ECID和CRM ID作為在中網頁資料的身分 對應身分 課程。 現在來使用Web SDK收集CRM ID!

新增CRM ID的資料元素

首先,我們將CRM ID儲存在資料元素中:

  1. 在標籤介面中,新增資料元素 CRM Id
  2. 作為 資料元素型別,選取 javascript變數
  3. 作為 javascript變數名稱,輸入 digitalData.user.0.profile.0.attributes.username
  4. 選取 儲存至程式庫 按鈕(Luma Platform Tutorial 仍應為您的工作程式庫)
    新增CRM ID的資料元素

將CRM ID新增至「身分對應」資料元素

現在我們已擷取CRM ID值,我們必須將其與名為的特殊資料元素型別建立關聯。 身分對應 資料元素:

  1. 新增資料元素 Identities

  2. 作為 副檔名,選取 Adobe Experience Platform Web SDK

  3. 作為 資料元素型別,選取 身分對應

  4. 作為 名稱空間,輸入 Luma CRM Id,也就是 名稱空間 我們在先前的課程中建立

    note warning
    WARNING
    Adobe Experience Platform Web SDK擴充功能2.2版可讓您使用Platform帳戶中的實際值,從預先填入的下拉式清單中選取名稱空間。 很遺憾,此功能尚未「沙箱感知」,因此 Luma CRM Id 值可能不會出現在下拉式清單中。 這可能會妨礙您完成此練習。 確認後,我們會張貼因應措施。
  5. 作為 ID,選取圖示以開啟資料元素選取強制回應視窗,然後選擇 CRM Id 資料元素

  6. 作為 已驗證狀態,選取 已驗證

  7. 離開 主要 未勾選. 由於CRM ID未提供給Luma網站的大部分訪客,因此您絕對 不想將ECID覆寫為主要識別碼. 極少數使用案例會使用ECID以外的任何專案作為主要識別碼。 我通常不會在這些指示中提及預設設定,但我在此呼籲您稍後在自己的實施中避免感到頭痛。

  8. 選取 儲存至程式庫 按鈕(Luma Platform Tutorial 仍應為您的工作程式庫)
    將CRM ID新增至「身分對應」資料元素

NOTE
您可以使用以傳遞多個識別碼 身分對應 資料型別。

將身分對應資料元素新增至XDM物件

還有一個資料元素我們必須更新,那就是XDM物件資料元素。 更新三個個別的資料元素來傳遞這個身分看起來可能有點奇怪,但此程式旨在針對多個身分進行縮放。 不用擔心,本課程快要結束了!

  1. 開啟您的XDM物件資料元素
  2. 開啟IdentityMap XDM欄位
  3. 作為 資料元素,選取圖示以開啟資料元素選取強制回應視窗,然後選擇 Identities 資料元素
  4. 現在,由於您已 Luma Platform Tutorial 您選取作為最近幾個練習的工作程式庫,您最近的變更已直接儲存至程式庫。 您不必透過發佈流程畫面發佈變更,您可以開啟藍色按鈕上的下拉式清單,然後選取 儲存至程式庫並建置
    將IdentityMap資料元素新增至XDM物件

驗證身分

若要驗證Web SDK現在是否正在傳送CRM ID:

  1. 開啟 Luma網站
  2. 根據先前的指示,使用Debugger將其對應至您的標籤屬性
  3. 選取 登入 Luma網站右上角的連結
  4. 使用憑證登入 test@adobe.com/test
  5. 驗證後,請在Debugger中檢查Experience PlatformWeb SDK呼叫(Adobe Experience Platform Web SDK > 網路要求 > 事件 ),您應該會看到 lumaCrmId
    在Debugger中驗證身分
  6. 使用ECID名稱空間和值再次查詢使用者設定檔。 在設定檔中,您會看到CRM ID,也會看到「忠誠度ID」和設定檔詳細資料,例如姓名和電話號碼。 所有身分和資料都已拼接到一個即時客戶個人檔案中!
    在Platform中驗證身分

其他資源

做得好!這是Web SDK和Launch的大量相關資訊。 完整式實作涉及的範圍更廣,但這些是協助您開始使用,並在Platform中檢視成果的基礎。

NOTE
現在您已完成串流擷取課程,您可以移除 Prod 來自您的的sandbox Luma Tutorial Platform 產品設定檔

資料工程師,如果您願意的話,可跳至 執行查詢課程.

資料架構師,您可以 合併原則

recommendation-more-help
513160b6-bf42-4c58-abdd-4f817b1cccad