將範例資料匯入Adobe Experience Platform

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

主題：
API

建立對象：

經驗豐富
開發人員

瞭解如何設定包含範例資料的 Experience Platform 沙箱環境。您可以使用 Postman 集合來建立欄位群組、綱要、資料集，然後將範例資料匯入 Experience Platform。

範例資料使用案例

Experience Platform業務使用者通常必須完成一系列步驟，包括識別欄位群組、建立結構描述、準備資料、建立資料集，然後擷取資料，然後才能探索Experience Platform提供的行銷功能。本教學課程會自動執行部分步驟，讓您儘快將資料放入Platform沙箱。

本教學課程著重於名為Luma的虛構零售品牌。他們投資於Adobe Experience Platform，以將忠誠度、CRM、產品目錄和離線購買資料結合到即時客戶設定檔中，並啟用這些設定檔，以將他們的行銷提升到新的境界。我們已產生Luma的範例資料，在本教學課程的其餘部分中，您會將此資料匯入您的其中一個Experience Platform沙箱環境中。

NOTE

此教學課程的最終結果是一個沙箱，其中包含與資料架構師和資料工程師的Adobe Experience Platform快速入門教學課程類似的資料。它在2023年4月更新，以支援Journey Optimizer挑戰。 2023年6月更新，將驗證方法切換至OAuth。

先決條件

您有權存取Experience Platform API，且知道如何驗證。如果沒有，請檢閱此教學課程。
您可以存取Experience Platform開發沙箱。
您知道您的Experience Platform租使用者ID。您可以透過提出已驗證的API要求來取得它
或是在您登入Platform帳戶時，從URL擷取連結。例如，在以下URL中，租使用者是"techmarketingdemos" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home。

使用Postman postman

設定環境變數

在依照這些步驟操作之前，請確定您已下載Postman應用程式。我們開始吧！

下載platform-utils-main.zip檔案，其中包含本教學課程所需的所有檔案。

note note
NOTE
platform-utils-main.zip檔案中包含的使用者資料是虛構的，僅供示範使用。

從下載資料夾中，將platform-utils-main.zip檔案移至您電腦的所需位置，然後加以解壓縮。
在luma-data資料夾中，在文字編輯器中開啟所有json檔案，並將_yourTenantId的所有執行個體取代為您自己的租使用者ID，前面加上底線。
在文字編輯器中開啟luma-offline-purchases.json、luma-inventory-events.json和luma-web-events.json，並更新所有時間戳記，以便事件發生在上個月（例如，搜尋"timestamp":"2022-11並取代年份和月份）

請記下解壓縮資料夾的位置，因為您稍後在設定FILE_PATH Postman環境變數時需要它：

note note
NOTE
若要取得Mac上的檔案路徑，請瀏覽至`platform-utils-main`資料夾，以滑鼠右鍵按一下該資料夾，然後選取取得資訊選項。

note note
NOTE
若要在視窗中取得檔案路徑，請按一下開啟所需資料夾的位置，然後在位址列中的路徑右邊按一下滑鼠右鍵。複製位址以取得檔案路徑。

開啟Postman並從 工作區 下拉式功能表建立工作區：
為您的工作區輸入名稱和選用的摘要，然後按一下 建立Workspace。當您建立新工作區時，Postman將會切換至該工作區。
現在調整一些設定，以在此工作區中執行Postman集合。在Postman的標題中，按一下齒輪圖示並選取設定以開啟設定強制回應視窗。您也可以使用鍵盤快速鍵(CMD/CTRL + ，)來開啟強制回應視窗。

在General標籤下，將要求逾時（以毫秒為單位）更新為5000 ms並啟用allow reading file outside this directory

note note
NOTE
如果檔案是從工作目錄內載入，則當相同的檔案儲存在其他裝置上時，該檔案將會順利地在裝置間執行。不過，如果您想要從工作目錄外部執行檔案，則必須開啟設定以表示相同的目的。如果您的`FILE_PATH`與Postman的工作目錄路徑不同，則應啟用此選項。

關閉設定面板。
選取環境，然後選取匯入：
匯入下載的json環境檔案，DataInExperiencePlatform.postman_environment
在Postman的右上角下拉式清單中選取您的環境，然後按一下眼睛圖示以檢視環境變數：
請確定已填入下列環境變數。若要瞭解如何取得環境變數的值，請檢視向Experience PlatformAPI進行驗證教學課程，以取得逐步指示。
- CLIENT_SECRET
- Adobe Developer Console中的API_KEY—Client ID
- SCOPES
- TECHNICAL_ACCOUNT_ID
- IMS
- Adobe Developer Console中的IMS_ORG—Organization ID
- SANDBOX_NAME
- TENANT_ID — 請確定以底線開頭，例如_techmarketingdemos
- CONTAINER_ID
- platform_end_point
- FILE_PATH — 使用您已解壓縮platform-utils-main.zip檔案的本機資料夾路徑。請確定它包含資料夾名稱，例如/Users/dwright/Desktop/platform-utils-main
儲存更新的環境

匯入Postman集合

接下來，您需要將集合匯入Postman。

選取集合，然後選擇匯入選項：
匯入下列集合：
- 0-Authentication.postman_collection.json
- 1-Luma-Loyalty-Data.postman_collection.json
- 2-Luma-CRM-Data.postman_collection.json
- 3-Luma-Product-Catalog.postman_collection.json
- 4-Luma-Offline-Purchase-Events.postman_collection.json
- 5-Luma-Product-Inventory-Events.postman_collection.json
- 6-Luma-Test-Profiles.postman_collection.json
- 7-Luma-Web-Events.postman_collection.json

驗證

接下來，您需要驗證並產生使用者權杖。請注意，本教學課程中使用的代號產生方法僅適用於非生產用途。本機簽署會從協力廠商主機載入JavaScript程式庫，而遠端簽署會將私密金鑰傳送至Adobe擁有且運作的Web服務。雖然Adobe不會儲存此私密金鑰，但生產金鑰絕不可與任何人共用。

開啟0-Authentication集合、選取OAuth: Request Access Token要求，然後按一下SEND以驗證及取得存取權杖。
檢閱環境變數，並注意ACCESS_TOKEN現已填入。

匯入資料

現在您可以準備資料並將其匯入您的Platform沙箱。您匯入的Postman系列將完成所有繁重的工作！

開啟1-Luma-Loyalty-Data集合，然後按一下[概述]索引標籤上的[執行 ]以啟動集合執行器。

在集合執行器視窗中，確定從下拉式清單中選取環境、將延遲更新為4000ms、勾選 儲存回應 選項，並確定執行順序正確無誤。按一下 執行Luma忠誠度資料 按鈕

集合匯入

note note
NOTE
1-Luma-Loyalty-Data 會建立客戶忠誠度資料的結構描述。此結構描述是以XDM個別設定檔類別、標準欄位群組以及自訂欄位群組和資料型別為基礎。集合會使用結構描述建立資料集，並將範例客戶忠誠度資料上傳至Adobe Experience Platform。

note note
NOTE
如果在Postman收集執行程式期間，有任何收集要求失敗，請停止執行並逐一執行收集要求。

如果一切順利，Luma-Loyalty-Data集合中的所有要求應該都會通過。
現在，讓我們登入Adobe Experience Platform介面並導覽至資料集。
開啟Luma Loyalty Dataset資料集，在資料集活動視窗下，您可以檢視擷取1000筆記錄的成功批次執行。您也可以按一下「預覽資料集」選項，驗證擷取的記錄。您可能需要等候數分鐘，以確認已建立1000個新設定檔片段。
重複步驟1至3以執行其他集合：
- 2-Luma-CRM-Data.postman_collection.json會為客戶的CRM資料建立結構描述和填入的資料集。此結構描述以XDM個人設定檔類別為基礎，該類別包含人口統計細節、個人聯絡細節、偏好設定細節和自訂身分欄位群組。
- 3-Luma-Product-Catalog.postman_collection.json會建立結構描述並填入產品目錄資訊的資料集。此結構描述是以自訂產品目錄類別為基礎，並使用自訂產品目錄欄位群組。
- 4-Luma-Offline-Purchase-Events.postman_collection.json會建立結構描述，並填入客戶的離線購買事件資料集。此結構描述以XDM ExperienceEvent類別為基礎，並包含自訂身分和Commerce詳細資料欄位群組。
- 5-Luma-Product-Inventory-Events.postman_collection.json會建立結構描述，並填入與進貨及無庫存產品相關之事件的資料集。此結構描述是以自訂業務事件類別和自訂欄位群組為基礎。
- 6-Luma-Test-Profiles.postman_collection.json會建立結構描述，並填入包含要在Adobe Journey Optimizer中使用的測試設定檔的資料集
- 7-Luma-Web-Events.postman_collection.json會建立結構描述，並以簡單的歷史Web資料填入資料集。

驗證

範例資料經過設計，在執行集合時，可以建立結合來自多個系統的資料的即時客戶設定檔。忠誠度、CRM和離線購買資料集的第一筆記錄就是很好的例子。查詢該設定檔以確認已擷取資料。在Adobe Experience Platform介面中：

移至 設定檔 > 瀏覽
選取Luma Loyalty Id作為 身分名稱空間
搜尋5625458做為 身分值
開啟Daniel Wright設定檔

TIP

如果您沒有看到設定檔，請檢查資料集頁面，確認所有資料集都已成功建立並內嵌資料。如果情況良好，請等候15分鐘，然後檢視檢視器中是否有設定檔可用。如果資料擷取發生問題，請檢查錯誤訊息，以嘗試找出問題。您也可以嘗試在資料集頁面上啟用錯誤診斷，並拖放json資料檔案以重新內嵌資料。

開啟設定檔

瀏覽屬性和事件索引標籤中的資料後，您應該會看到設定檔包含來自各種資料檔的資料：
離線購買事件檔案的事件資料

後續步驟

如果您想瞭解Adobe Journey Optimizer，此沙箱包含您進行Journey Optimizer挑戰所需的一切

如果您想瞭解合併原則、資料控管、查詢服務和區段產生器，請跳到資料架構師和資料工程師快速入門教學課程🔗中的第11課。本其他教學課程的先前課程會讓您手動建立這些Postman集合剛才填入的所有內容 — 開心地開始吧！

如果您想要建置範例Web SDK實作以連結至此沙箱，請前往
使用Web SDK教學課程實作Adobe Experience Cloud。設定Web SDK教學課程的「初始設定」、「標籤設定」和「設定Experience Platform」課程後，使用密碼test使用luma-crm.json檔案中的前10個電子郵件地址登入Luma網站，以檢視設定檔片段與本教學課程中上傳的資料合併。

如果您想要建立範例行動SDK實作以連結至此沙箱，請前往
在行動應用程式教學課程中實作Adobe Experience Cloud。設定Web SDK教學課程的「初始設定」、「應用程式實作」和「Experience Platform」課程後，使用luma-crm.json檔案中的第一個電子郵件地址登入Luma網站，檢視設定檔片段與本教學課程中上傳的資料合併。

重設沙箱環境 reset-sandbox

重設非生產沙箱會刪除與該沙箱關聯的所有資源（結構描述、資料集等），同時維護沙箱的名稱和關聯的許可權。此「乾淨」沙箱可繼續以相同名稱供擁有存取權的使用者使用。

請依照步驟這裡重設沙箱環境。

recommendation-more-help

9051d869-e959-46c8-8c52-f0759cee3763