透過Adobe Experience PlatformEdge Network伺服器API內嵌資料
本快速入門手冊說明如何使用Adobe Experience PlatformEdge Network伺服器API和Edge Network，將追蹤資料從裝置（例如IoT裝置、機上盒、遊戲主機、案頭應用程式）直接擷取到Adobe Experience Platform。 然後將這些資料用於Customer Journey Analytics。
若要完成此作業，您必須：
-
在 Adobe Experience Platform 中 設定結構和資料集，定義您要收集的資料的模型 (結構)，以及實際收集資料的位置 (資料集)。
-
設定資料流 以設定 Adobe Experience Platform Edge Network，將收集的資料路由至您在 Adobe Experience Platform 中設定的資料集。
-
使用Server API，直接從案頭、遊戲主機、IoT裝置或機上盒上執行的應用程式或遊戲傳送資料至您的資料流。
-
部署和驗證。有一個讓您可反複進行開發程式的環境，一旦一切通過驗證，就可在您的生產環境中上線發佈。
-
在 Customer Journey Analytics 中 設定連線。此連線應 (至少) 包含您的 Adobe Experience Platform 資料集。
-
在 Customer Journey Analytics 中 設定資料檢視，定義您要在 Analysis Workspace 中使用的量度和維度。
-
在 Customer Journey Analytics 中 設定專案，建立您的報告和視覺效果。
設定結構和資料集
若要將資料內嵌至Adobe Experience Platform，您必須先定義要收集哪些資料。 所有擷取至 Adobe Experience Platform 的資料都必須符合標準的非正常結構，才能由下游能力和功能識別並處理。Experience Data Model (XDM)是標準架構，提供結構形式的結構。
定義結構後，您可以使用一個或多個資料集來儲存及管理資料收集。資料集是資料集合（通常是表格）的儲存和管理結構，其中包含結構（欄）和欄位（列）。
擷取至 Adobe Experience Platform 的所有資料都必須符合預先定義的結構，才能以資料集形式持續保存。
設定結構
您想要從在主機上玩遊戲的設定檔追蹤一些最低限度的資料，例如身分識別、分數、進度和其他資訊。
您必須先定義用來模型化此資料的結構描述。
若要設定您的結構：
-
在 Adobe Experience Platform UI 的左側邊欄中，選取「資料管理」中的 「結構」。
-
選取 建立結構描述。
. -
在建立架構精靈的選取類別步驟中：
-
選取 體驗事件。
note info INFO 體驗事件結構描述可用來模型化設定檔的_行為_ （像是場景名稱、要新增至購物車的推播按鈕）。 個別設定檔結構可用來建立設定檔_屬性_ (例如姓名、電子郵件、性別) 模型。 -
選取 「下一步」。
-
-
在建立結構描述精靈的名稱和檢閱步驟中：
-
為您的結構描述輸入 結構描述顯示名稱 和（選擇性） 描述。
-
選取 「完成」。
-
-
在範例結構描述的結構標籤中：
-
在「欄位群組」中選取 「+ 新增」。
欄位群組是可重複使用的物件和屬性集合，可讓您輕鬆擴充結構。
-
在新增欄位群組對話方塊中，從清單中選取 遮光燈 欄位群組。 此欄位群組的建立是為了追蹤使用者在主機上玩名為Blinding Light的虛構遊戲的進度。
您可以選取預覽按鈕，以查看屬於此欄位群組之欄位的預覽，例如
scores > afterMatch。
選取 「返回」 來關閉預覽。
-
選取 「新增欄位群組」。
-
-
選取結構描述名稱旁的 +。
-
在欄位屬性面板中，輸入
identification作為欄位名稱，識別 作為顯示名稱，選取 物件 作為型別，並選取 ExperienceEvent Core v2.1 作為欄位群組。note note NOTE 如果該欄位群組無法使用，請尋找另一個包含身分欄位的欄位群組。 或者建立新欄位群組和新增新的身分識別欄位 （例如 ecid、crmId和其他您需要的欄位）至欄位群組，並選取該新欄位群組。
識別物件會將識別功能新增至結構描述。 在您的案例中，您想要使用Experience CloudID和電子郵件地址來識別玩遊戲的設定檔，以便登入遊戲主機。 有許多其他屬性可用來追蹤您的人員身分。
選取 「套用」 將此物件加入您的結構。
-
在剛剛新增的識別物件中選取 ecid 欄位，然後在右側面板的「身分命名空間」清單中，選取 「身分」 和 「主要身分」 和 ECID。
您正在指定 Experience Cloud Identity 作為 Adobe Experience Platform Identity 服務可用於結合 (拼接) 設定檔行為與相同 ECID 的主要身分。
選取 「套用」。您會看到指紋圖示出現在 ecid 屬性中。
-
在剛剛新增的識別物件中選取 「電子郵件」 欄位，然後在「欄位屬性」面板的「身分命名空間」清單中選取 「身分」 和 「電子郵件」。
您正在指定電子郵件地址作為 Adobe Experience Platform Identity 服務可用於結合 (拼接) 設定檔行為的另一個身分。
選取 「套用」。您會看到指紋圖示出現在電子郵件屬性中。
選取 「儲存」。
-
選取顯示結構名稱之結構的根元素，然後選取 「設定檔」 切換。
系統會提示您啟用設定檔的結構。啟用後，根據此結構將資料擷取至資料集時，該資料就會合併至即時客戶設定檔中。
如需詳細資訊，請參閱啟用結構以用於即時客戶設定檔。
note important IMPORTANT 儲存啟用設定檔的結構後，便無法再為設定檔停用該結構。 
-
選取 「儲存」，即可儲存您的結構。
您已建立最低架構模型，以模擬您可以從遊戲擷取的資料。 該結構可讓您使用 Experience Cloud Identity 和電子郵件地址來識別設定檔。為設定檔啟用結構描述後，即可確保從主機遊戲擷取的資料會新增至即時客戶設定檔。
在行為資料旁邊，您還可以從主控台擷取設定檔屬性資料（例如登入主控台的設定檔詳細資訊）。
若要擷取設定檔資料，您可以：
-
根據 XDM 個別設定檔架構類別建立結構。
-
將「設定檔核心 v2」欄位群組新增至結構。
-
根據「設定檔核心 v2」欄位群組新增識別物件。
-
將Experience CloudID定義為主要識別碼，並將電子郵件定義為識別碼。
-
啟用該設定檔結構
請參閱在 UI 中建立和編輯結構，了解有關向結構添加和刪除欄位群組和個別欄位的詳細資訊。
設定資料集
您已使用您的結構定義資料模型。您現在必須定義結構，才能使用資料集儲存及管理該資料。
若要設定您的資料集：
-
在 Adobe Experience Platform UI 的左側邊欄中，選取「資料管理」中的 「資料集」。
-
選取 「建立資料集」。
-
選取 「從結構建立資料集」。
-
選取您先前建立的結構並選取 「下一個」。
-
為資料集命名，並 (可選) 提供說明。
-
選取 「完成」。
-
選取 「設定檔」 切換。
系統會提示您啟用設定檔的資料集。資料集一經啟用，即可透過擷取的資料豐富即時客戶設定檔。
note important IMPORTANT 只有當資料集所遵循的結構同樣啟用設定檔時，您才能啟用設定檔的資料集。 
請參閱資料集 UI 指南，了解如何檢視、預覽、建立、刪除資料集的詳細資訊。以及為即時客戶設定檔啟用資料集的方法。
設定資料流
資料流代表實作Adobe Experience Platform Web和Mobile SDK以及Adobe Experience PlatformEdge Network伺服器API時的伺服器端設定。 使用Adobe Experience Platform SDK和Edge Network伺服器API收集資料時，資料會傳送至Adobe Experience PlatformEdge Network。 是決定要將資料轉送至哪些服務的資料流。
在設定中，您想要將從遊戲中收集的資料傳送到Adobe Experience Platform中的資料集。
若要設定您的資料流：
-
在 Adobe Experience Platform UI 中，從左側邊欄的「資料收集」中選取 「資料流」。
-
選取「新資料流」。
-
命名並描述您的資料流。從「事件結構」清單中選取您的結構。
-
選取 「儲存」。
-
選取 「新增服務」。
-
在「新增服務畫面」中：
-
從「服務」清單中選取 「Adobe Experience Platform」。
-
確保已選取 「啟用」。
-
從「事件資料集」清單中選取您的資料集。
-
保留其他設定並選取 「儲存」 以儲存資料流。
-
您的資料流現在已設定為將從遊戲中收集的資料轉送到Adobe Experience Platform中的資料集。
請參閱資料流概觀，了解如何設定資料流以及如何處理敏感資料的詳細資訊。
使用Edge Network伺服器API
在遊戲開發中，您可以視情況將相關呼叫新增至Adobe Experience PlatformEdge Network伺服器API。
例如，若要更新播放器的分數，您可使用：
curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
"event": {
"xdm": {
"identityMap": {
"Email_LC_SHA256": [
{
"id": "0c7e6a405862e402eb76a70f8a26fc732d07c32931e9fae9ab1582911d2e8a3b",
"primary": true
}
]
},
"eventType": "game.scoreUpdate",
"{sandbox}": {
"scores": {
"afterMatch": 132391",
}
},
"timestamp": "2021-08-09T14:09:20.859Z"
}
}
}'
在範例POST要求中，{DATASTREAM_ID}指向您先前設定的範例資料流的識別碼。 {sandbox}是您的沙箱的唯一名稱，可識別自訂遮光燈欄位群組的路徑。
如需如何使用Edge Network伺服器API的詳細資訊，請參閱互動式資料集合和非互動式資料集合。
設定連線
若要在 Customer Journey Analytics 中使用 Adobe Experience Platform 資料，您可以建立連線，其中包含設定結構、資料集和工作流程所產生的資料。
連線可讓您將資料集從 Adobe Experience Platform 整合到工作區。若要針對這些資料集製作報表，必須先為Adobe Experience Platform和Workspace中的資料集建立連線。
若要建立連線，請執行以下操作：
-
在 Customer Journey Analytics UI 中，選取頂部導覽中的 「連線」。
-
選取 「建立新連線」。
-
在「無標題連線」畫面中：
在「連線設定」中為連線命名並提供說明。
從「資料設定」的「沙箱」清單中選取正確沙箱，並從「每日事件平均數」清單中選取每日事件數。
選取 「新增資料集」。
在新增資料集的選取資料集步驟：
-
選取您先前建立的資料集和/或您要納入連線中的其他相關資料集
-
選取 「下一步」。
在新增資料集的資料集設定步驟：
-
對於每個資料集：
-
在 Adobe Experience Platform 中，從資料集結構描述中所定義的可用身分中選取人員 ID。
-
從「資料來源類型」清單中選取正確的資料來源。如果您指定 「其他」，請為您的資料來源新增說明。
-
根據您的偏好設定，設定 匯入所有新資料 和 資料集回填現有資料。
-
-
選取 「新增資料集」。
選取 「儲存」。
-
如需如何建立和管理連線，以及如何選取和合併資料集的詳細資訊，請參閱連線概觀。
設定資料檢視
資料檢視是特定於 Customer Journey Analytics 的容器，可讓您決定如何詮釋來自連線的資料。它指定 Analysis Workspace 中可用的所有維度和量度，以及這些維度和量度從哪些欄取得資料。資料檢視是為了在 Analysis Workspace 中報告資料而定義的。
若要建立資料檢視，請執行以下操作：
-
在 Customer Journey Analytics UI 中，選取頂部導覽中的 「資料檢視」。
-
選取 「建立新的資料檢視」。
-
在設定步驟：
從「連線」清單中選取您的連線。
為連線命名，並 (可選) 提供說明。
選取 「儲存並繼續」。
-
在元件步驟：
將您要納入的任何結構欄位和/或標準元件新增至量度或維度元件框。
選取 「儲存並繼續」。
-
在設定步驟：
保留設定原樣並選取 「儲存並完成」。
如需如何建立和編輯資料檢視、可在資料檢視中使用哪些元件，以及如何使用篩選器和工作階段設定的詳細資訊，請參閱資料檢視概觀。
設定專案
Analysis Workspace 是彈性的瀏覽器工具，可讓您根據資料快速建立分析及分享見解。您可以使用工作區專案合併資料元件、表格和視覺效果，進行分析並與貴組織的任何人分享。
若要建立專案，請執行以下操作：
-
在 Customer Journey Analytics UI 中，選取頂部導覽中的 「專案」。
-
在左側導覽中選取 「專案」。
-
選取 「建立專案」。
選取 「空白專案」。
-
從清單中選取您的資料檢視。
-
若要建立您的第一個報表，請在面板的自由表格上開始拖放維度和量度。
如需如何使用元件、視覺效果和面板建立專案和建立分析的詳細資訊，請參閱 Analysis Workspace 概觀。