瞭解如何設定包含範例資料的 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。
techmarketingdemos
" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home
.在依照這些步驟操作之前,請確定您已下載 Postman 應用程式。 我們開始吧!
下載 platform-utils-main.zip 檔案,其中包含本教學課程所需的所有檔案。
包含在 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 環境變數:
若要取得Mac上的檔案路徑,請導覽至 platform-utils-main
資料夾,以滑鼠右鍵按一下資料夾並選取 取得資訊 選項。
若要在視窗中取得檔案路徑,請按一下開啟所需資料夾的位置,然後在位址列中的路徑右邊按一下滑鼠右鍵。 複製位址以取得檔案路徑。
開啟 Postman 並從建立工作區 工作區 下拉式功能表:
輸入 名稱 和選填 摘要 ,然後按一下 建立工作區. Postman 會在您建立新工作區時切換至該工作區。
現在調整一些設定以執行 Postman 此工作區中的集合。 在標題中 Postman,按一下齒輪圖示並選取 設定 以開啟設定強制回應視窗。 您也可以使用鍵盤快速鍵(CMD/CTRL + ,)來開啟強制回應視窗。
在 General
標籤,將請求逾時(以毫秒為單位)更新為 5000 ms
並啟用 allow reading file outside this directory
如果檔案是從工作目錄內載入,則當相同的檔案儲存在其他裝置上時,該檔案將會順利地在裝置間執行。 不過,如果您想要從工作目錄外部執行檔案,則必須開啟設定以表示相同的目的。 若您的 FILE_PATH
與 Postman的工作目錄路徑,則應啟用此選項。
關閉 設定 面板。
選取 環境 然後選取 匯入:
匯入下載的json環境檔案, DataInExperiencePlatform.postman_environment
在Postman的右上角下拉式清單中選取您的環境,然後按一下眼睛圖示以檢視環境變數:
請確定已填入下列環境變數。 若要瞭解如何取得環境變數的值,請檢視 驗證Experience Platform API 逐步指示的教學課程。
CLIENT_SECRET
API_KEY
—Client ID
在Adobe Developer Console中SCOPES
TECHNICAL_ACCOUNT_ID
IMS
IMS_ORG
—Organization ID
在Adobe Developer Console中SANDBOX_NAME
TENANT_ID
— 請務必以底線開頭,例如 _techmarketingdemos
CONTAINER_ID
platform_end_point
FILE_PATH
— 使用您解壓縮的本機資料夾路徑 platform-utils-main.zip
檔案。 請確定其中包含資料夾名稱,例如 /Users/dwright/Desktop/platform-utils-main
儲存 更新的環境
接下來,您需要將集合匯入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
以驗證及取得存取Token。
檢閱環境變數,並注意 ACCESS_TOKEN
現已填入。
現在您可以準備資料並將其匯入您的Platform沙箱。 您匯入的Postman系列將完成所有繁重的工作!
開啟 1-Luma-Loyalty-Data
集合併按一下 執行 在「概述」標籤上啟動「集合執行器」。
在集合執行器視窗中,確定從下拉式清單中選取環境,更新 延遲 至 4000ms
,檢查 儲存回應 選項,並確認執行順序正確。 按一下 執行Luma忠誠度資料 按鈕
1-Luma-Loyalty-Data 建立客戶忠誠度資料的結構描述。 此結構描述是以XDM個別設定檔類別、標準欄位群組以及自訂欄位群組和資料型別為基礎。 集合會使用結構描述建立資料集,並將範例客戶忠誠度資料上傳至Adobe Experience Platform。
如果在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類別為基礎,並包含自訂身分和商務詳細資訊欄位群組。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
設定檔如果您沒有看到設定檔,請檢查 資料集 確認所有資料集已成功建立和擷取資料的頁面。 如果情況良好,請等候15分鐘,然後檢視檢視器中是否有設定檔可用。 如果資料擷取發生問題,請檢查錯誤訊息,以嘗試找出問題。 您也可以嘗試在 資料集 並拖放json資料檔案以重新內嵌資料。
瀏覽中的資料 屬性 和 活動 標籤中,您應該會看到設定檔包含來自各種資料檔案的資料:
如果您想要瞭解Adobe Journey Optimizer,此沙箱包含您需要採取的 Journey Optimizer挑戰
如果您想瞭解合併原則、資料控管、查詢服務和區段產生器,請跳至 資料架構師和資料工程師快速入門教學課程中的第11課. 本其他教學課程的先前課程會讓您手動建立這些Postman集合剛才填入的所有內容 — 開心地開始吧!
如果您想要建置範例Web SDK實作以連結至此沙箱,請前往
使用Web SDK教學課程實作Adobe Experience Cloud. 設定Web SDK教學課程的「初始設定」、「標籤設定」和「設定Experience Platform」課程後,使用中的前十個電子郵件地址登入Luma網站 luma-crm.json
使用密碼的檔案 test
檢視設定檔片段與本教學課程上傳的資料合併的情況。
如果您想要建立範例行動SDK實作以連結至此沙箱,請前往
在行動應用程式教學課程中實作Adobe Experience Cloud. 設定Web SDK教學課程的「初始設定」、「應用程式實作」和「Experience Platform」課程後,使用中的第一個電子郵件地址登入Luma網站 luma-crm.json
檔案以瞭解設定檔片段合併至本教學課程中上傳的資料。
重設非生產沙箱會刪除與該沙箱關聯的所有資源(結構描述、資料集等),同時維護沙箱的名稱和關聯的許可權。 此「乾淨」沙箱可繼續以相同名稱供擁有存取權的使用者使用。
請依照步驟操作 此處 以重設沙箱環境。