將範例資料匯入Adobe Experience Platform

在本教學課程中,我們將說明如何透過一些範例資料來設定您的Experience Platform沙箱環境,供您探索。 您可以使用Postman集合,建立欄位群組、結構、資料集,然後將範例資料匯入Experience Platform。

資料使用案例範例

Experience Platform業務使用者通常必須執行一系列步驟,包括識別欄位群組、建立結構、準備資料、建立資料集,然後擷取資料,才能探索Experience Platform提供的部分功能。 在本教學課程中,您可以找到簡單的方式,盡快將部分步驟自動化,並在Platform中取得資料。

本教學課程主要探討虛構的零售品牌Luma。 Luma在多個國家經營實體店,並擁有網站和移動應用的線上業務。 他們投資於Adobe Experience Platform,將忠誠度、CRM、網路和離線購買資料結合為即時客戶設定檔,並啟用這些設定檔,將其行銷提升至全新境界。 我們為Luma產生了範例資料,您可以在下一節中探索如何匯入資料至Experience Platform。

要完成本教程,您可以使用Postman應用程式的UI,或使用命令行Collection Runner for Postman(Newman)

先決條件

  • 您已驗證,且可存取Experience PlatformAPI。 否則,您可以依照此tutorial快速設定。
  • 您可以存取Experience Platform沙箱環境。

使用Postman

匯入Postman集合併設定環境變數

執行步驟之前,請確定您已下載Postman應用程式並擁有Experience PlatformAPI的存取權。 在本教學課程中,我們將使用沙箱環境。 它提供獨立環境,讓您無需將資源和資料與生產環境混合即可試用功能。 我們開始吧。

注意

platform-utils-main.zip檔案中包含的使用者資料是虛構的,僅供展示之用。

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

  2. 從下載資料夾中,將platform-utils-main.zip檔案移至電腦上需要的位置,然後將其解壓縮。

  3. 請記下解壓縮檔案的位置,因為稍後設定FILE_PATH postman環境變數時,可能需要它

    注意

    要在Mac上獲取檔案路徑,請導航到platform-utils-main資料夾,按一下右鍵該資料夾,然後選擇​獲取資訊​選項。

    MAC檔案路徑

    注意

    要在窗口上獲取檔案路徑,請按一下以開啟所需資料夾的位置,然後按一下右鍵地址欄中路徑右側的。 複製地址以獲取檔案路徑。

    Windows檔案路徑

  4. 啟動Postman並建立新工作區。 從where

  5. 若要建立新工作區,請使用Postman左側的​Workspaces​下拉式功能表。 您可以選取現有工作區或為專案建立新工作區。
    建立工作區

  6. 輸入工作區的​名稱​和可選​摘要 ,然後按一下​建立工作區。 當您建立新工作區時,Postman會切換至該工作區。
    儲存工作區

  7. 現在,我們再執行一些其他設定,以在此工作區中執行我們的Postman集合。 在Postman的標題中,按一下扳手圖示,然後選取​Settings​以開啟設定強制回應視窗。 您也可以使用鍵盤快速鍵(CMD/CTRL + 、)開啟強制回應視窗。

  8. General標籤下,將請求逾時(以毫秒為單位)更新為5000 ms並啟用allow reading file outside this directory

    設定

    注意

    如果從工作目錄中載入檔案,如果將相同檔案儲存在其他裝置上,則跨裝置順利執行。 但是,如果要從外部工作目錄運行檔案,則必須開啟一個設定,以指定相同的目的。 如果您的FILE_PATH與Postman的工作目錄路徑不同,則應啟用此選項。

  9. 關閉設定面板。

  10. 選取環境選項,然後按一下匯入選項。
    環境匯入

  11. 現在來匯入下載的json環境檔案DataInExperiencePlatform.postman_environment,然後按一下​Import

  12. 在Postman中,在右上方的下拉式清單中選取您的環境,然後按一下眼睛圖示以檢視環境變數。
    環境選擇

  13. 請確定已填入下列環境變數。 若要了解如何取得環境變數的值,請參閱驗證以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檔案的本機資料夾路徑。 您可以編輯變數,方法是從左側的「環境」開啟環境,或開啟Postman右上方的環境快速查看(眼睛按鈕),然後按一下「編輯」。
    檔案路徑

  15. 現在,我們需要填入下列環境變數的值。 為此,我們必須將集合檔案上傳至工作區。

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

    集合

  17. 將下列集合檔案匯入postman

    • 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 TokenPOST請求,然後按一下SEND驗證並獲取訪問令牌。

    集合匯入

  19. 檢閱環境變數,您可以注意到JWT_TOKENACCESS_TOKEN現已填入。

  20. 開啟Luma-Loyalty-Data集合,然後按一下概述標籤上的​執行​以啟動集合執行者。

    集合匯入

  21. 在收集執行器視窗中,請務必從下拉式清單中選取環境、提供4000毫秒的延遲、核取儲存回應選項,並確認執行順序正確。 按一下​執行Luma忠誠度資料​按鈕

    集合匯入

    注意

    Luma-Loyalty-Datacollection執 行會建立結構以包含客戶忠誠度資料。此結構是以包含自訂欄位群組和資料套裝的XDM個別設定檔類別為基礎。 集合也會使用結構建立資料集,並上傳客戶忠誠度資料範例至Adobe Experience Platform。

    注意

    如果在postman收集執行階段期間有任何收集請求失敗,請停止執行並逐一執行收集請求。

  22. 如果一切順利,Luma-Loyalty-Data集合中的所有要求都應傳遞。

    忠誠度結果

  23. 現在來登入Adobe Experience Platform UI並導覽至資料集。

  24. 開啟Luma Loyalty Dataset資料集,在資料集活動視窗下,您可以檢視內嵌1000筆記錄的成功批次執行。 您也可以按一下預覽資料集選項,以確認已擷取的記錄。
    忠誠度資料集

  25. 重複步驟21 - 23以執行下列集合:

    • Luma-CRM-Data.postman_collection.json :集合執行會建立結構以包含客戶的CRM資料。此結構以XDM個別設定檔類別為基礎,該類別包含人口統計詳細資料、個人連絡資料和Luma身分設定檔欄位群組。 集合也會使用結構建立資料集,並上傳範例客戶CRM資料至Adobe Experience Platform。
    • Luma-Product-Catalog.postman_collection.json :收集執行會建立結構以包含產品目錄資訊。該結構基於包含產品目錄Mixin、商務詳細資訊和消費者體驗事件Mixin的自訂類。 集合也會使用結構建立資料集,並將產品資料上傳至Adobe Experience Platform。
    • Luma-Offline-Purchase-Events.postman_collection.json:集合執行會建立結構以包含客戶的離線購買事件資料。此結構是以XDM ExperienceEvent類別為基礎,並包含欄位群組,以擷取客戶忠誠度資訊及其離線購買事件。 集合也會使用結構建立資料集,並將離線購買事件資料上傳至Adobe Experience Platform。

使用紐曼

請務必先存取Experience PlatformAPI,再依照步驟操作。 在本教學課程中,我們將使用沙箱環境,因為它提供獨立環境,您可在其中試用功能,而不需將資源和資料與您的生產環境混合。

安裝NodeJs和Newman

  1. 若要執行Newman,請確定您有Node.js >= v10。 透過套件管理器安裝Node.js

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

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

  4. 按照此處的步驟為系統安裝newman

  5. 運行命令newman -v以確保已安裝newman。

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

  7. 從下載資料夾中,將platform-utils-main.zip檔案移至電腦上需要的位置,然後將其解壓縮。

  8. 請記下解壓縮檔案的位置,因為稍後設定FILE_PATH postman環境變數時,可能需要它

  9. 在終端窗口中開啟platform-utils-main資料夾。

  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. 如果一切順利,Luma-Loyalty-Data集合中的所有要求都應傳遞。

  12. 現在來登入Adobe Experience Platform UI並導覽至資料集。

  13. 開啟Luma Loyalty Dataset資料集,在資料集活動視窗下,您可以檢視內嵌1000筆記錄的成功批次執行。 您也可以按一下預覽資料集選項,以確認已擷取的記錄。

    忠誠度資料集

  14. 重複步驟10 - 13以在集合下執行:

    • 執行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

重設沙箱環境

重設非生產沙箱會刪除與該沙箱(結構、資料集等)相關的所有資源,同時維護沙箱的名稱和相關權限。 對於具有存取權的使用者,這個「乾淨」的沙箱會繼續以相同名稱提供。

請依照此處步驟重設沙箱環境。

本頁內容