使用Web SDK串流資料以Experience Platform

Last update: Sat Jun 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

undefined
undefined
undefined

了解如何使用 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的資料都會以資料集的形式保留在資料湖中。 A 資料集是用於資料集合的儲存和管理結構，通常是包含結構（欄）和欄位（列）的表格。資料集也包含中繼資料，可說明其儲存資料的各個層面。

讓我們為您的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偵錯工具擴充功能圖示
設定Debugger將標籤屬性對應至您的開發環境，如使用Debugger進行驗證課程
使用 test@adobe.com/test 憑證登入 Luma 網站
返回 Luma 首頁
在Debugger顯示的Platform Web SDK網路信標中，選取「事件」列以在快顯視窗中展開詳細資料
在快顯視窗中搜尋「identityMap」。您應該會在這裡看到lumaCrmId包含authenticatedState、id和primary的三個索引鍵

現在，資料應填入 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
複製並貼上 lumaCRMId 已在您在Experience Platform Debugger中檢查的呼叫中傳遞，此案例中為 112ca06ed53d3db37e4cea49cc45b71e.
如果設定檔中有有效的值， lumaCRMId，設定檔ID會填入主控台中：

若要檢視完整的 客戶設定檔 針對每個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使用即時客戶設定檔。由於您已完成類似的練習，因此會提供簡短的指示。

建立熟客方案：