使用Web SDK串流資料以Experience Platform

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

初學者
中繼
開發人員

了解如何使用 Platform Web SDK 將 Web 資料串流傳輸至 Adobe Experience Platform。

Experience Platform是所有新Experience Cloud應用程式的骨幹，例如Adobe Real-time Customer Data Platform、Adobe Customer Journey Analytics和Adobe Journey Optimizer。這些應用程式在設計上使用Platform Web SDK作為收集網頁資料的最佳方法。

Web SDK與Adobe Experience Platform圖表

Experience Platform會使用您先前建立的相同XDM結構描述，從Luma網站擷取事件資料。當該資料傳送至PlatformEdge Network時，資料流設定可以將其轉送至Experience Platform。

學習目標

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

在Adobe Experience Platform中建立資料集
設定資料流以傳送Web SDK資料至Adobe Experience Platform
為即時客戶個人檔案啟用串流網頁資料
驗證資料已著陸Platform資料集和即時客戶設定檔中
將忠誠度計畫資料範例擷取至Platform
建立簡單的平台對象

先決條件

若要完成本課程，您必須先：

擁有Adobe Experience Platform應用程式的存取權，例如Real-time Customer Data Platform、Journey Optimizer或Customer Journey Analytics
完成本教學課程之初始設定和標籤設定區段中先前的課程。

NOTE

如果您沒有任何Platform應用程式，您可以略過本課程或一起閱讀。

建立資料集

所有成功內嵌至Adobe Experience Platform的資料都會以資料集的形式保留在資料湖中。資料集是資料集合的儲存和管理結構，通常是包含結構描述（欄）和欄位（列）的表格。資料集也包含中繼資料，可說明其儲存資料的各個層面。

讓我們為您的Luma Web事件資料設定資料集：

移至Experience Platform或Journey Optimizer介面
確認您是在本教學課程使用的開發沙箱中
從左側導覽開啟 資料管理>資料集
選取 建立資料集
選取 從結構描述建立資料集 選項
選取在先前的課程中建立的Luma Web Event Data結構描述，然後選取 下一步
為資料集提供名稱和選用的描述。此練習請使用Luma Web Event Data，然後選取完成

資料集現在已設定為開始從Platform Web SDK實作收集資料。

設定資料串流

現在您可以設定您的資料串流，將資料傳送至Adobe Experience Platform。資料流是標籤屬性、平台Edge Network和Experience Platform資料集之間的連結。

開啟資料彙集介面
從左側導覽中選取 資料串流
開啟您在設定資料流課程Luma Web SDK中建立的資料流
選取 新增服務
選取 Adobe Experience Platform 做為服務
選取Luma Web Event Data做為 事件資料集
選取「儲存」。

當您在Luma示範網站上產生對應至標籤屬性的流量時，資料會以Experience Platform填入資料集！

驗證資料集

此步驟對於確保資料已抵達資料集至關重要。驗證傳送至資料集的資料有兩個方面。

使用Experience Platform偵錯工具進行驗證
使用預覽資料集進行驗證
使用查詢服務進行驗證

Experience Platform Debugger

這些步驟與您在偵錯工具課程中所執行的步驟大致相同。不過，由於資料只有在資料流中啟用後才會傳送至Platform，因此您必須產生更多範例資料：

開啟Luma示範網站並選取Experience Platform偵錯工具擴充功能圖示
設定偵錯工具將標籤屬性對應至您的開發環境，如使用偵錯工具驗證課程中所述
使用 test@adobe.com/test 憑證登入 Luma 網站
返回 Luma 首頁
在Debugger顯示的Platform Web SDK網路信標中，選取「事件」列以在快顯視窗中展開詳細資料

Debugger中的
在快顯視窗中搜尋「identityMap」。您應該會在這裡看到lumaCrmId包含authenticatedState、id和primary的三個索引鍵
Debugger中的

現在，資料應填入Luma Web Event Data資料集，並準備好「預覽資料集」驗證。

預覽資料集

若要確認資料已著陸Platform的資料湖，快速選項是使用 預覽資料集 功能。 Web SDK資料會以微批次處理至資料湖，並定期在平台介面中重新整理。您可能需要10到15分鐘的時間才能看到您產生的資料。

在Experience Platform介面中，選取左側導覽中的 資料管理>資料集 以開啟 資料集 儀表板。

控制面板會列出貴組織的所有可用資料集。系統會顯示每個列出資料集的詳細資訊，包括其名稱、資料集所遵守的結構描述，以及最新擷取執行的狀態。
選取您的Luma Web Event Data資料集以開啟其 資料集活動 畫面。

活動畫麵包含以視覺效果呈現訊息使用率的圖表，以及成功和失敗批次的清單。
從 資料集活動 畫面中，選取靠近熒幕右上角的 預覽資料集，以預覽最多100列的資料。如果資料集空白，則會停用預覽連結。

在預覽視窗中，資料集的結構描述階層檢視會顯示在右側。

查詢資料

在Experience Platform介面中，選取左側導覽中的 資料管理>查詢 以開啟查詢畫面。
選取 建立查詢
首先，執行查詢以檢視資料湖中表格的所有名稱。在查詢編輯器中輸入SHOW TABLES，然後按一下播放圖示以執行查詢。
在結果中，請注意資料表的名稱類似於luma_web_event_data的情況
現在，使用參考您表格的簡單查詢來查詢表格（請注意，查詢預設將限製為100個結果）： SELECT * FROM "luma_web_event_data"
過了一會兒，您應該會看到網頁資料的範例記錄。

ERROR

如果您收到「未布建表格」錯誤，請仔細檢查表格的名稱。也可能是微批次資料尚未抵達資料湖。 10-15分鐘後再試一次。

INFO

如需Adobe Experience Platform查詢服務的詳細資訊，請參閱Platform教學課程一節中的探索資料。

為即時客戶個人檔案啟用資料集和結構描述

對於Real-time Customer Data Platform和Journey Optimizer的客戶，下一步是啟用即時客戶個人檔案的資料集和結構描述。從Web SDK串流的資料會是流入Platform的眾多資料來源之一，而您想要將網頁資料與其他資料來源結合，以建置360度客戶設定檔。若要深入瞭解即時客戶個人檔案，請觀看此短片：

https://video.tv.adobe.com/v/27251?learn=on&captions=eng

CAUTION

使用您自己的網站和資料時，建議在啟用資料以用於即時客戶個人檔案之前，先對資料進行更強大的驗證。

若要啟用資料集：

開啟您建立的資料集，Luma Web Event Data
選取 設定檔切換 以開啟
確認您要啟用資料集

若要啟用結構描述：

開啟您建立的結構描述，Luma Web Event Data
選取 設定檔切換 以開啟

選取 此結構描述的資料將在identityMap欄位中包含主要身分。

note important
IMPORTANT
傳送到Real-Time Customer Profile的每個記錄都需要主要身分。一般而言，身分欄位會在結構描述中加上標籤。但是，使用身分對應時，結構描述中不會顯示身分欄位。此對話方塊是確認您心中有一個主要身分，且您會在傳送資料時，在身分對應中指定該身分。如您所知，Web SDK會使用身分對應，以Experience CloudID (ECID)作為預設主要身分，並以已驗證的ID作為主要身分（若可用）。

note important

IMPORTANT

傳送到Real-Time Customer Profile的每個記錄都需要主要身分。一般而言，身分欄位會在結構描述中加上標籤。但是，使用身分對應時，結構描述中不會顯示身分欄位。此對話方塊是確認您心中有一個主要身分，且您會在傳送資料時，在身分對應中指定該身分。如您所知，Web SDK會使用身分對應，以Experience CloudID (ECID)作為預設主要身分，並以已驗證的ID作為主要身分（若可用）。

選取啟用
選取儲存以儲存更新的結構描述

現在結構描述也針對設定檔啟用。

IMPORTANT

為設定檔啟用結構描述後，如果不重設或刪除整個沙箱，就無法停用或刪除它。此外，此時之後無法從結構描述中移除欄位。

使用您自己的資料時，我們建議您依照下列順序操作：

首先，將一些資料內嵌到資料集中。
解決資料擷取程式期間發生的任何問題（例如資料驗證或對應問題）。
為設定檔啟用資料集和結構描述
視需要重新內嵌資料

驗證設定檔

您可以在Platform介面(或Journey Optimizer介面)中查詢客戶設定檔，確認資料已著陸Real-Time Customer Profile。顧名思義，設定檔會即時填入，因此不會像資料集中的驗證資料一樣延遲。

首先，您必須產生更多範例資料。重複本課程中先前步驟以在Luma網站對應至您的標籤屬性時登入。 Inspect Platform Web SDK要求，以確定其會傳送包含lumaCRMId的資料。

在Experience Platform介面中，選取左側導覽中的客戶 > 設定檔
作為 身分識別名稱空間 使用lumaCRMId
複製並貼上您在Experience Platform偵錯工具中檢查之呼叫中傳遞的lumaCRMId的值，此案例中為112ca06ed53d3db37e4cea49cc45b71e。
如果lumaCRMId的設定檔中有有效值，則主控台中會填入設定檔ID：

若要檢視每個ID的完整 客戶設定檔，請在主視窗中選取 設定檔識別碼。

note note
NOTE
請注意，您可以選取「設定檔ID」的超連結，或者如果您選取該列，則會開啟右邊的功能表，您可以在其中選取「設定檔ID」超連結

在這裡，您可以看到連結至lumaCRMId的所有身分識別，例如ECID。

客戶設定檔

您現已啟用適用於Experience Platform的Platform Web SDK (以及Real-Time CDP！以及Journey Optimizer！和Customer Journey Analytics！)。

建立忠誠度方案並擷取範例資料

Real-time Customer Data Platform和Journey Optimizer的客戶可望完成此練習。

將Web SDK資料擷取至Adobe Experience Platform後，您即可將資料擷取至Platform的其他資料來源加以擴充。例如，當使用者登入Luma網站時，身分圖表會在Experience Platform中建構，而所有其他已啟用設定檔的資料集可能會連結在一起，以建置即時客戶設定檔。若要實際瞭解此情況，請在Adobe Experience Platform中快速建立另一個資料集，其中包含一些忠誠度資料範例，以便您可以搭配Real-time Customer Data Platform和Journey Optimizer使用即時客戶設定檔。由於您已完成類似的練習，因此會提供簡短的指示。

建立熟客方案：