將示例資料導入Adobe Experience Platform

瞭解如何設定包含示例資料的Experience Platform沙盒環境。 使用Postman集合,可以建立欄位組、架構、資料集,然後將示例資料導入Experience Platform。

示例資料使用案例

Experience Platform業務用戶通常必須完成一系列步驟,包括確定欄位組、建立架構、準備資料、建立資料集,然後接收資料,然後才能瞭解Experience Platform提供的市場營銷功能。 本教程自動化了一些步驟,以便您可以盡快將資料放入平台沙箱中。

本教程重點介紹一個名為Luma的虛構零售品牌。 他們投資Adobe Experience Platform,將忠誠度、CRM、產品目錄和離線購買資料結合到即時客戶檔案中,並激活這些檔案,將他們的營銷提升到新的水準。 我們已為Luma生成了示例資料,在本教程的其餘部分,您將將此資料導入到您的Experience Platform沙箱環境中。

注意

本教程的最終結果是一個沙盒,其中包含與 面向資料架構師和資料工程師的Adobe Experience Platform入門教程

先決條件

  • 您有權訪問Experience PlatformAPI並知道如何進行身份驗證。 否則,請查看此 教程
  • 您可以訪問Experience Platform開發沙箱。
  • 你知道你的Experience Platform租戶身份。 通過驗證 API請求
    或者在登錄到平台帳戶時從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 文本編輯器中的檔案,並替換 _techmarketingdemos 以您自己的租戶ID為前面的下划線。

  4. 在稍後設定時,請根據需要記下解壓縮資料夾的位置 FILE_PATH Postman環境變數:

    注意

    要獲取Mac上的檔案路徑,請導航至 platform-utils-main 資料夾,按一下右鍵資料夾並選擇 獲取資訊 的雙曲餘切值。

    Mac檔案路徑

    注意

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

    Windows檔案路徑

  5. 開啟Postman並從 工作區 下拉菜單:
    建立工作區

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

  7. 現在調整一些設定以在此工作區中運行Postman集合。 在Postman的標題中,按一下齒輪表徵圖並選擇 設定 的子菜單。 也可以使用鍵盤快捷鍵(CMD/CTRL +,)來開啟模式。

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

    注意

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

  9. 關閉 設定 的子菜單。

  10. 選擇 環境 ,然後選擇 導入:
    環境導入

  11. 導入下載的json環境檔案, DataInExperiencePlatform.postman_environment

  12. 在Postman,在右上角的下拉菜單中選擇您的環境,然後按一下眼睛表徵圖以查看環境變數:
    環境選擇

  13. 確保填充了以下環境變數。 要瞭解如何獲取環境變數的值,請查看 驗證到Experience PlatformAPI 逐步說明教程。

    • CLIENT_SECRET
    • API_KEYClient ID 在Adobe Developer控制台
    • TECHNICAL_ACCOUNT_ID
    • META_SCOPE
    • IMS
    • IMS_ORGOrganization ID 在Adobe Developer控制台
    • PRIVATE_KEY
    • SANDBOX_NAME
    • CONTAINER_ID
    • TENANT_ID — 確保以下划線引導,例如 _techmarketingdemos
    • platform_end_point
    • FILE_PATH — 使用已解壓的本地資料夾路徑 platform-utils-main.zip 的子菜單。 確保它包括資料夾名稱,例如 /Users/dwright/Desktop/platform-utils-main
  14. 保存 更新的環境

導入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

    集合導入

驗證

接下來您需要驗證並生成用戶令牌。 請注意,本教程中使用的令牌生成方法僅適用於非生產用途。 本地簽名從第三方主機載入JavaScript庫,遠程簽名將私鑰發送到由Adobe擁有並運行的Web服務。 雖然Adobe不儲存此私鑰,但生產密鑰不應與任何人共用。

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

    集合導入

  2. 查看環境變數,並注意 JWT_TOKENACCESS_TOKEN 已填充。

匯入資料

現在,您可以準備資料並將其導入到平台沙箱中。 你進口的Postman系列,將會完成所有的重擔!

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

    集合導入

  2. 在收集運行窗口中,確保從下拉清單中選擇環境,更新 延遲4000ms,則選中 保存響應 ,並確保運行順序正確。 按一下 運行Luma會員資料 按鈕

    集合導入

    注意

    1-Luma-Loyalty-Data 為客戶忠誠度資料建立方案。 該架構基於XDM Individual Profile類、標準欄位組以及自定義欄位組和資料庫。 集合使用模式建立資料集,並將示例客戶忠誠度資料上載到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 Details欄位組。

驗證

樣例資料設計為,當集合運行後,將構建即時客戶概要檔案,將來自多個系統的資料組合在一起。 一個很好的例子是會員、 CRM和離線購買資料集的首次記錄。 查找該配置檔案以確認資料已攝取。 在 Adobe Experience Platform介面:

  1. 轉到 配置檔案 > 瀏覽
  2. 選擇 Luma Loyalty Id標識命名空間
  3. 搜索 5625458標識值
  4. 開啟 Danny Wright 輪廓

開啟配置檔案

通過瀏覽 屬性事件 頁籤,您應看到配置檔案包含各種資料檔案中的資料:
離線採購事件檔案中的事件資料

後續步驟

如果您想瞭解合併策略、資料治理、查詢服務和段生成器,請跳轉到 資料架構師和資料工程師入門教程中的第11課。 本教程的前幾課讓您手動構建剛剛由這些Postman系列填充的所有內容 — 享受先機!

如果要構建一個示例Web SDK實現以連結到此沙箱,請通過
使用Web SDK教程實施Adobe Experience Cloud。 在設定Web SDK教程的「初始配置」、「標籤配置」和「設定Experience Platform」課程後,使用Luma網站中的前十個電子郵件地址登錄 luma-crm.json 使用密碼的檔案 test 查看配置檔案片段與本教程中上載的資料合併。

如果要構建一個示例Mobile SDK實現以連結到此沙箱,請通過
在移動應用教程中實施Adobe Experience Cloud。 在設定Web SDK教程的「初始配置」、「應用程式實現」和「Experience Platform」課程後,使用中的第一個電子郵件地址登錄Luma網站 luma-crm.json 檔案,查看與本教程中上載的資料的配置檔案片段合併。

重置沙盒環境

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

按步驟操作 這裡 重置沙盒環境。

本頁內容