測試歷程 testing_the_journey
在能夠測試您的歷程之前,您必須解決所有錯誤(如果有的話)。 請參閱本節。
您可以使用測試設定檔,在發佈歷程之前測試歷程。 這可讓您分析個人在歷程中的流動方式並在發佈前進行疑難排解。
只有測試設定檔才能進入歷程測試模式。 您可以建立新的測試設定檔,或將現有的設定檔轉換為測試設定檔。 請參閱本章節。
若要使用測試模式,請遵循下列步驟:
-
測試您的歷程之前,請先確認歷程有效且沒有錯誤。 您將無法啟動含有錯誤的歷程測試。 請參閱此節。 發生錯誤時,會顯示警告符號。
-
若要啟動測試模式,請按一下右上角的 Test 切換按鈕。
-
使用左下角的 Wait time 引數來定義每個等待活動和事件逾時在測試模式中的持續時間。 等待和事件逾時的預設時間為10秒。 這將確保您能快速獲得測試結果。 此引數只會在您已在歷程中捨棄一或多個等待活動時顯示。
note note NOTE 當歷程中使用具有逾時的回應事件時,等待時間的預設值及最小值為40秒。 請參閱本節。 -
按一下 Trigger an event 設定事件並傳送至歷程。
-
設定所需的不同欄位。 在 設定檔識別碼 欄位中,輸入用來識別測試設定檔的欄位值。 例如,可以是電子郵件地址。 請務必傳送與測試設定檔相關的事件。 請參閱引發您的事件。
-
收到事件後,按一下 Show log 按鈕以檢視測試結果並加以驗證。 請參閱檢視記錄檔。
-
如果發生任何錯誤,請停用測試模式、修改您的歷程並再次測試。當測試得出結果時,您可以發佈您的歷程。 請參閱此頁面。
重要備註 important_notes
- 提供介面以觸發事件至測試的歷程,但事件也可以由第三方系統(例如Postman)傳送。
- 只有即時客戶設定檔服務中標示為「測試設定檔」的個人才能進入測試歷程。 請參閱本章節。
- 測試模式僅適用於使用名稱空間的草稿歷程。 測試模式需要檢查進入歷程的人員是否為測試設定檔,因此必須能夠存取Adobe Experience Platform。
- 在測試工作階段中可以進入歷程的測試設定檔最大數量為100。
- 停用測試模式時,它會從過去進入該模式或目前進入該模式的所有人員中清空歷程。 這樣也會清除報表。
- 您可以視需要多次啟用/停用測試模式。
- 測試模式啟用時,您無法修改歷程。 在測試模式中,您可以直接發佈歷程,之前不需要停用測試模式。
- 達到分割時,一律選擇頂端分支。 如果您希望測試選擇不同的路徑,可以重新組織分割分支的位置。
- 為了最佳化效能及避免過時資源的使用,所有處於測試模式且一週內未觸發的歷程將切換回草稿狀態。
將設定檔轉換為測試設定檔 turning-profile-into-test
您可以將現有的設定檔轉換為測試設定檔。 在Adobe Experience Platform中,您可以透過API呼叫更新設定檔屬性,但無法透過介面執行。
最簡單的方法是使用 更新設定檔 動作活動,並將測試設定檔布林欄位從false變更為true。 請參閱本節。
建立測試設定檔 create-test-profile
如果您想要建立新的測試設定檔,程式與在Adobe Experience Platform中建立設定檔時相同。 這會透過API呼叫執行。 檢視此頁面
您必須使用包含「設定檔測試詳細資料」mixin的設定檔結構描述。 testProfile旗標是此mixin的一部分。
建立設定檔時,請務必傳遞值: testProfile = true。
請注意,您也可以更新現有的設定檔,將其testProfile標幟變更為「true」。
以下為建立測試設定檔的API呼叫範例:
curl -X POST \
'https://dcs.adobedc.net/collection/xxxxxxxxxxxxxx' \
-H 'Cache-Control: no-cache' \
-H 'Content-Type: application/json' \
-H 'Postman-Token: xxxxx' \
-H 'cache-control: no-cache' \
-H 'x-api-key: xxxxx' \
-H 'x-gw-ims-org-id: xxxxx' \
-d '{
"header": {
"msgType": "xdmEntityCreate",
"msgId": "xxxxx",
"msgVersion": "xxxxx",
"xactionid":"xxxxx",
"datasetId": "xxxxx",
"imsOrgId": "xxxxx",
"source": {
"name": "Postman"
},
"schemaRef": {
"id": "https://example.adobe.com/mobile/schemas/xxxxx",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "xxxxx",
"_mobile":{
"ECID": "xxxxx"
},
"testProfile":true
}
}
}'
引發您的事件 firing_events
Trigger an event 按鈕可讓您設定讓人員進入歷程的事件。
您必須先瞭解哪些設定檔在Adobe Experience Platform中標示為測試設定檔。 事實上,測試模式僅允許在歷程中這些設定檔,而且事件必須包含ID。 預期的ID取決於事件設定。 例如,可以是ECID或電子郵件地址。 需要將此金鑰的值新增到 設定檔識別碼 欄位中。
如果您的歷程包含多個事件,請使用下拉選單選取一個事件。然後,針對每個事件,設定所傳遞的欄位以及傳送事件的執行。 介面可協助您在事件裝載中傳遞正確的資訊,並確保資訊型別正確無誤。 測試模式會儲存最後用於測試工作階段的引數以供稍後使用。
介面可讓您傳遞簡單事件引數。 如果您想要在事件中傳遞集合或其他進階物件,可以按一下 Code View 以檢視裝載的完整程式碼並加以修改。 例如,您可以複製並貼上技術使用者準備的事件資訊。
技術使用者也可以使用此介面來撰寫事件裝載和觸發事件,而不必使用協力廠商工具。
按一下 Send 按鈕時,測試開始。 歷程中個人的進度以視覺流程表示。 當個人在歷程中移動時,路徑會逐步變成綠色。 如果發生錯誤,會在對應的步驟上顯示警告符號。 您可以將游標放在錯誤上以顯示有關錯誤的更多資訊,並存取完整的詳細資訊(如果有的話)。
當您在事件設定畫面中選取不同的測試設定檔,然後再次執行測試時,視覺流程會清除並顯示新個人的路徑。
在測試中開啟歷程時,顯示的路徑對應於上次執行的測試。
無論事件是透過介面或從外部觸發(例如使用Postman),視覺流程都會運作。
規則型歷程的測試模式 test-rule-based
測試模式也可用於使用規則型事件的歷程。 如需規則型事件的詳細資訊,請參閱此頁面。
觸發事件時,事件組態 畫面可讓您定義要在測試中傳遞的事件引數。 您可以按一下右上角的工具提示圖示來檢視事件ID條件。 規則評估的每個欄位旁也提供工具提示。
有關如何使用測試模式的詳細資訊,請參閱此頁面。
檢視記錄 viewing_logs
Show log 按鈕可讓您檢視測試結果。 此頁面以JSON格式顯示歷程的目前資訊。 按鈕可讓您複製整個節點。 您需要手動重新整理頁面以更新歷程的測試結果。
目前顯示在歷程中的個人(技術上稱為執行個體)數量。 以下是為個別使用者顯示的實用資訊:
- Id:歷程中的個人內部ID。 這可用於偵錯。
- currentstep:個人在歷程中的步驟。 建議您為活動新增標籤,以便更輕鬆識別。
- currentstep >階段:個人歷程的狀態(執行中、已完成、錯誤或逾時)。 如需詳細資訊,請參閱下文。
- currentstep > extraInfo:錯誤描述與其他內容資訊。
- currentstep > fetchErrors:此步驟中發生擷取資料錯誤的資訊。
- externalKeys:事件中定義的索引鍵公式值。
- extrendedData:歷程使用資料來源時,歷程已擷取的資料。
- transitionHistory:個人遵循的步驟清單。 對於事件,會顯示裝載。
- actionExecutionErrors :發生錯誤的相關資訊。
以下是個人歷程的不同狀態:
- 執行中:個人目前正在歷程中。
- 已完成:個人位於歷程的結尾。
- 錯誤:個人已在歷程中因錯誤而停止。
- 已逾時:個人已在歷程中停止,因為步驟耗費太多時間。
使用測試模式觸發事件時,會自動以來源名稱產生資料集。
使用測試模式觸發事件時,會自動以來源名稱產生資料集。
測試模式會自動建立體驗事件並將其傳送至Adobe Experience Platform。 此體驗事件的來源名稱是「Journey Orchestration測試事件」。