將示例資料導入Adobe Experience Platform

瞭解如何使用一些示例資料設定Experience Platform沙箱環境。 使用郵遞員集合,您可以建立欄位組、方案、資料集,然後將示例資料導入Experience Platform。

示例資料使用案例

Experience Platform業務用戶通常必須完成一系列步驟,包括確定欄位組、建立模式、準備資料、建立資料集,然後在探索Experience Platform提供的某些功能之前接收資料。 在本教程中,您可以找到一種簡單的方法來自動執行部分步驟,並盡快在平台中獲取資料。

本教程重點介紹一個名為Luma的虛構零售品牌。 Luma在多個國家經營實體店,並通過網站和移動應用線上。 他們投資Adobe Experience Platform,將忠誠度、 CRM、Web和離線購買資料整合到即時客戶配置檔案中,並激活這些配置檔案,將其營銷推向新的水準。 我們為Luma生成了示例資料,在下一節中,您可以瞭解如何將資料導入Experience Platform。

要完成本教程,您可以使用 郵遞員應用程式的UI 或使用命令行 郵遞員的收藏管理員(Newman)

先決條件

  • 您已經過身份驗證,並有權訪問Experience PlatformAPI。 否則,您可以按照以下步驟快速設定 教程
  • 您可以訪問Experience Platform沙盒環境。
  • Know your Experience Platform tenant id. 登錄到平台帳戶時,租戶ID應顯示在URL中。 在以下URL中,租戶為"techmarketingdemos" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home。 您也可以通過進行身份驗證來獲取 API請求

Using Postman

導入郵件員收集並設定環境變數

在執行步驟之前,請確保已下載 郵遞員 訪問Experience PlatformAPI。 在本教程中,我們將使用沙盒環境。 It provides an isolated environment where you can try out functionality without mixing resources and data with your Production environment. 開始吧。

注意

包含在 platform-utils-main-zip 檔案是虛構的,僅用於演示。

  1. Download the platform-utils-main.zip file, which contains all files required for this tutorial.

  2. From your downloads folder, move the platform-utils-main.zip file to the desired location on your computer, and unzip it.

  3. 請記下解壓縮檔案的位置,因為稍後在設定 FILE_PATH 後人環境變數

    注意

    To obtain file path on your Mac, navigate to the platform-utils-main folder, right click on the folder and select Get Info option.

    Mac檔案路徑

    注意

    要獲取窗口上的檔案路徑,請按一下以開啟所需資料夾的位置,然後按一下右鍵地址欄中路徑的右側。 Copy address to obtain the file path.

    Windows檔案路徑

  4. 啟動郵件員並建立新工作區。 複製 where 元資料值

  5. To create a new workspace, use the Workspaces dropdown menu at the left of Postman. You can select an existing workspace or create a new workspace for your project.
    建立工作區

  6. 輸入 名稱 可選 摘要 按一下 建立工作區。 在您建立新工作區時,郵遞員將切換到該工作區。
    保存工作區

  7. 現在,讓我們執行一些其他設定,以在此工作區中運行郵遞員收藏。 在郵遞員的標題中,按一下扳手錶徵圖並選擇 設定 的子菜單。 也可以使用鍵盤快捷鍵(CMD/CTRL +,)來開啟模式。

  8. General 頁籤,讓我們將請求超時(以毫秒為單位)更新為 5000 ms 啟用 allow reading file outside this directory

    設定

    注意

    如果從工作目錄中載入檔案,則如果相同檔案儲存在其他設備上,則檔案將跨設備平穩運行。 但是,如果希望從外部工作目錄運行檔案,則必須開啟一個設定以說明相同的目的。 如果 FILE_PATH 與郵遞員的工作目錄路徑不同,則應啟用此選項。

  9. 關閉設定面板。

  10. 選擇環境選項並按一下導入選項。
    Environment Import

  11. Let's import the downloaded json environment file, DataInExperiencePlatform.postman_environment, and click Import

  12. In Postman, select your environment in the top-right dropdown and click the eye icon to view the environment variables.
    環境選擇

  13. Make sure that the following environment variables are populated. 要瞭解如何獲取環境變數的值,請查看 驗證到Experience PlatformAPI 逐步說明教程。

    • CLIENT_SECRET
    • API_KEY
    • TECHNICAL_ACCOUNT_ID
    • META_SCOPE
    • IMS
    • IMS_ORG
    • PRIVATE_KEY
    • SANDBOX_NAME
    • CONTAINER_ID
    • TENANT_ID
    • platform_end_point
    • FILE_PATH
    • PRIVATE_KEY
  14. 更新 FILE_PATH 變數到已解壓的本地資料夾路徑 platform-utils-main.zip 的子菜單。 可以通過從左側的「環境」中開啟環境,或者通過開啟郵遞員右上角的環境快速查看(眼睛按鈕)並按一下「編輯」來編輯變數。
    檔案路徑

  15. 現在,我們需要填充以下環境變數的值。 為此,我們需要將收集檔案上載到我們的工作區。

    • JWT_TOKEN
    • ACCESS_TOKEN
  16. 選擇收集,然後選擇導入選項

    集合

  17. 將以下集合檔案導入郵遞員

    • Authentication.postman_collection.json
    • Luma-Loyalty-Data.postman_collection.json
    • Luma-CRM-Data.postman_collection.json
    • Luma-Product-Catalog.postman_collection.json
    • Luma-Offline-Purchase-Events.postman_collection.json

    集合導入

  18. 開啟 Authentication ,選擇 IMS: JWT Generate + Auth via User Token POST請求,然後按一下 SEND 驗證並獲取訪問令牌。

    集合導入

  19. 查看環境變數,您可以注意到 JWT_TOKENACCESS_TOKEN 已填充。

  20. luma-data 資料夾,開啟所有 json 文本編輯器中的檔案,並替換 _techmarketingdemos 以您自己的租戶ID為前面的下划線。

  21. 開啟 Luma-Loyalty-Data 按一下 運行 的子菜單。

    集合導入

  22. 在收集運行窗口中,確保從下拉清單中選擇環境,提供4000ms的延遲,檢查保存響應選項,並確保運行順序正確。 按一下 運行Luma會員資料 按鈕

    集合導入

    注意

    Luma-Loyalty-Data 收集運行將建立包含客戶忠誠度資料的架構。 該架構基於XDM Individual Profile類,該類包括自定義欄位組和資料庫。 集合還使用架構建立資料集,並將示例客戶忠誠度資料上載到Adobe Experience Platform。

    注意

    如果在郵遞員收集運行期間任何收集請求失敗,請停止執行並逐個運行收集請求。

  23. 如果一切順利, Luma-Loyalty-Data 集合應通過。

    會員結果

  24. 現在,讓我們登錄 Adobe Experience PlatformUI 導航到資料集。

  25. 開啟 Luma Loyalty Dataset 資料集,在資料集活動窗口下,可以查看成功的批處理運行,該運行記錄了1000條記錄。 也可以按一下預覽資料集選項來驗證所攝取的記錄。
    Loyalty Dataset

  26. 重複步驟21 - 23以運行以下集合:

    • Luma-CRM-Data.postman_collection.json : collection run would create a schema to contain CRM data of customers. The schema is based on XDM Individual Profile class that comprises Demographic Details, Personal Contact Details and Luma Identity Profile field groups. 集合還使用架構建立資料集並將示例客戶CRM資料上載到Adobe Experience Platform。
    • Luma-Product-Catalog.postman_collection.json : collection run would create a schema to contain product catalog information. The schema is based on a custom class comprising product catalog mixin, Commerce details, and Consumer Experience Event mixin. Collection also creates a dataset using the schema and uploads product data to Adobe Experience Platform.
    • Luma-Offline-Purchase-Events.postman_collection.json:收集運行將建立一個架構以包含客戶的離線採購事件資料。 The schema is based on XDM ExperienceEvent class and comprises field groups to capture customer loyalty information and their offline purchase events. Collection also creates a dataset using the schema and uploads offline purchase events data to Adobe Experience Platform.

使用紐曼

在執行這些步驟之前,請確保您有權訪問Experience PlatformAPI。 在本教程中,我們將使用沙盒環境,因為它提供了一個孤立的環境,您可以在此環境中試用功能,而無需將資源和資料與生產環境混合。

Install NodeJs and Newman

  1. To run Newman, ensure that you have Node.js >= v10. 通過包管理器安裝Node.js

  2. 運行命令 node -v 確保已安裝該節點。

  3. 安裝Newman的最簡單方法是使用NPM。 如果安裝了Node.js,則很可能也安裝了NPM。

  4. 按步驟操作 這裡 為系統安裝newman

  5. 運行命令 newman -v 確保紐曼安裝好。

  6. 下載 platform-utils-main-zip 檔案,包含本教程所需的所有檔案。

  7. From your downloads folder, move the platform-utils-main.zip file to the desired location on your computer, and unzip it.

  8. Please make a note of the location of the unzipped file, as we might need it later when setting up the FILE_PATH postman environment variable

  9. Open the platform-utils-main folder in a terminal window.

  10. 運行 Luma-Loyalty-Data.postman_collection.json 構建欄位組、模式、資料集,並向Adobe Experience Platform接收樣例忠誠度資料

    • newman run Luma-Loyalty-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json —insecure --delay-request 4000
  11. If everything goes well, all requests in the Luma-Loyalty-Data collection should pass.

  12. 現在,讓我們登錄 Adobe Experience PlatformUI 導航到資料集。

  13. 開啟 Luma Loyalty Dataset 資料集,在資料集活動窗口下,可以查看成功的批處理運行,該運行記錄了1000條記錄。 也可以按一下預覽資料集選項來驗證所攝取的記錄。

    Loyalty Dataset

  14. Repeat steps 10 - 13 to run below collections:

    • 運行 Luma-CRM-Data.postman_collection.json 生成欄位組、模式、資料集,並將示例CRM資料接收到Adobe Experience Platform
      • newman run Luma-CRM-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
    • 運行 Luma-Product-Catalog.postman_collection.json 生成欄位組、模式、資料集,並將示例產品資料接收到Adobe Experience Platform
      • newman run Luma-Product-Catalog.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
    • 運行 Luma-Offline-Purchase-Events.postman_collection.json 生成欄位組、模式、資料集,並將示例產品資料接收到Adobe Experience Platform
      • newman run Luma-Offline-Purchase-Events.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000

Reset Sandbox environment

重置非生產沙盒將刪除與該沙盒(架構、資料集等)關聯的所有資源,同時維護沙盒的名稱和關聯權限。 此「乾淨」沙盒將繼續以同一名稱供有權訪問它的用戶使用。

Follow the steps here to reset a sandbox environment.

本頁內容