透過Edge Network伺服器API內嵌資料
本快速入門手冊說明如何使用Adobe Experience Platform Edge Network Server 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 Cloud ID和用來登入遊戲主機的電子郵件地址來識別玩遊戲的設定檔。 有許多其他屬性可用來追蹤您的人員身分。
選取 「套用」 將此物件加入您的結構描述。
-
在剛剛新增的身分識別物件中選取 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 Cloud ID 定義為主要識別碼，並將電子郵件定義為識別碼。
-
啟用該設定檔結構描述
請參閱在 UI 中建立和編輯結構，了解有關向結構添加和刪除欄位群組和個別欄位的詳細資訊。
設定資料集
您已使用您的結構定義資料模型。您現在必須定義結構，才能使用資料集儲存及管理該資料。
若要設定您的資料集：
-
在 Adobe Experience Platform UI 的左側邊欄中，選取「資料管理」中的 「資料集」。
-
選取 「建立資料集」。
-
選取 「從結構建立資料集」。
-
選取您先前建立的結構並選取 「下一個」。
-
為資料集命名，並 (可選) 提供說明。
-
選取 「完成」。
-
選取 「設定檔」 切換。
系統會提示您啟用設定檔的資料集。資料集一經啟用，即可透過攝取的資料豐富即時客戶設定檔。
note important IMPORTANT 只有當資料集所遵循的結構同樣啟用設定檔時，您才能啟用設定檔的資料集。 
請參閱資料集 UI 指南，了解如何檢視、預覽、建立、刪除資料集的詳細資訊。以及為即時客戶輪廓啟用資料集的方法。
設定資料流
資料流代表實作Adobe Experience Platform Web和Mobile SDK以及Adobe Experience Platform Edge Network伺服器API時的伺服器端設定。 使用Adobe Experience Platform SDK和Edge Network Server API收集資料時，資料會傳送至Adobe Experience Platform Edge Network。 此資料流決定資料要轉送到哪些服務。
在設定中，您想要將從遊戲中收集的資料傳送到Adobe Experience Platform中的資料集。
若要設定您的資料流：
-
在 Adobe Experience Platform UI 中，從左側邊欄的「資料收集」中選取 「資料流」。
-
選取「新資料流」。
-
命名並描述您的資料流。從「事件結構描述」清單中選取您的結構描述。
-
選取 「儲存」。
-
選取 「新增服務」。
-
在「新增服務畫面」中：
-
從「服務」清單中選取 「Adobe Experience Platform」。
-
確保已選取 「啟用」。
-
從「事件資料集」清單中選取您的資料集。
-
保留其他設定並選取 「儲存」 以儲存資料流。
-
您的資料流現在已設定為將從遊戲中收集的資料轉送到Adobe Experience Platform中的資料集。
請參閱資料流概觀，了解如何設定資料流以及如何處理敏感資料的詳細資訊。
使用Edge Network伺服器API
在遊戲開發中，您可以視情況將相關呼叫新增至Adobe Experience Platform Edge 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 Server 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 概觀。