將範例資料匯入Adobe Experience Platform

最後更新： 2025年7月11日
  • 主題：
  • API

建立對象：

  • 經驗豐富
  • 開發人員

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

範例資料使用案例

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

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

注意
此教學課程的最終結果是一個沙箱，其中包含與資料架構師和資料工程師的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應用程式。 我們開始吧！

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

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

  2. 從下載資料夾中，將platform-utils-main.zip檔案移至您電腦的所需位置，然後加以解壓縮。

  3. 在luma-data資料夾中，在文字編輯器中開啟所有json檔案，並將_yourTenantId的所有執行個體取代為您自己的租使用者ID，前面加上底線。

  4. 在文字編輯器中開啟luma-offline-purchases.json、luma-inventory-events.json和luma-web-events.json，並更新所有時間戳記，以便事件發生在上個月（例如，搜尋"timestamp":"2022-11並取代年份和月份）

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

    注意
    若要取得Mac上的檔案路徑，請瀏覽至platform-utils-main資料夾，以滑鼠右鍵按一下該資料夾，然後選取​ 取得資訊 ​選項。
    MAC檔案路徑
    注意
    若要在視窗中取得檔案路徑，請按一下開啟所需資料夾的位置，然後在位址列中的路徑右邊按一下滑鼠右鍵。 複製位址以取得檔案路徑。
    Windows檔案路徑

  6. 開啟Postman並從​ 工作區 ​下拉式功能表建立工作區：
    建立工作區

  7. 為您的工作區輸入​ 名稱 ​和選用的​ 摘要，然後按一下​ 建立Workspace。 當您建立新工作區時，Postman將會切換至該工作區。
    儲存工作區

  8. 現在調整一些設定，以在此工作區中執行Postman集合。 在Postman的標題中，按一下齒輪圖示並選取​ 設定 ​以開啟設定強制回應視窗。 您也可以使用鍵盤快速鍵(CMD/CTRL + ，)來開啟強制回應視窗。

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

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

  10. 關閉​ 設定 ​面板。

  11. 選取​ 環境，然後選取​ 匯入：
    環境匯入

  12. 匯入下載的json環境檔案，DataInExperiencePlatform.postman_environment

  13. 在Postman的右上角下拉式清單中選取您的環境，然後按一下眼睛圖示以檢視環境變數：
    環境選擇

  14. 請確定已填入下列環境變數。 若要瞭解如何取得環境變數的值，請檢視向Experience Platform API進行驗證教學課程，以取得逐步指示。

    • 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

  15. 儲存 ​更新的環境

匯入Postman集合

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

  1. 選取​ 集合，然後選擇匯入選項：

    集合

  2. 匯入下列集合：

    • 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不會儲存此私密金鑰，但生產金鑰絕對不應與任何人共用。

  1. 開啟0-Authentication集合、選取OAuth: Request Access Token要求，然後按一下SEND以驗證及取得存取權杖。

    集合匯入

  2. 檢閱環境變數，並注意ACCESS_TOKEN現已填入。

匯入資料

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

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

    集合匯入

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

    集合匯入

    注意
    1-Luma-Loyalty-Data ​會建立客戶忠誠度資料的結構描述。 此結構描述是以XDM個別設定檔類別、標準欄位群組以及自訂欄位群組和資料型別為基礎。 集合會使用結構描述建立資料集，並將範例客戶忠誠度資料上傳至Adobe Experience Platform。
    注意
    如果在Postman收集執行程式期間，有任何收集要求失敗，請停止執行並逐一執行收集要求。

  3. 如果一切順利，Luma-Loyalty-Data集合中的所有要求應該都會通過。

    忠誠度結果

  4. 現在，讓我們登入Adobe Experience Platform介面並導覽至資料集。

  5. 開啟Luma Loyalty Dataset資料集，在資料集活動視窗下，您可以檢視擷取1000筆記錄的成功批次執行。 您也可以按一下「預覽資料集」選項，驗證擷取的記錄。 您可能需要等候數分鐘，以確認已建立1000個新設定檔片段。
    忠誠度資料集

  6. 重複步驟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資料填入資料集。