[Beta]{class="badge informative"}
測試並提交您的來源
使用自助式來源(串流SDK)將新來源整合到Adobe Experience Platform的最後步驟,是測試並提交您的新來源。 當您完成連線規格並更新串流流程規格後,您就可以開始透過API或UI測試來源的功能。 成功後,您可以連絡您的Adobe代表以提交新的來源。
以下檔案提供如何使用Flow Service API測試及偵錯來源的步驟。
快速入門
- 如需如何成功呼叫Experience Platform API的詳細資訊,請參閱Experience Platform API快速入門指南。
- 如需如何產生Experience Platform API認證的詳細資訊,請參閱驗證及存取Experience Platform API教學課程。
- 如需如何為Experience Platform API設定Postman的詳細資訊,請參閱設定開發人員主控台和 Postman上的教學課程。
- 若要協助您的測試和偵錯程式,請在此下載自助來源驗證集合和環境,並遵循下列步驟。
使用API測試您的來源
若要使用API測試您的來源,您必須在Postman上執行自助來源驗證集合和環境,同時提供與您的來源相關的適當環境變數。
若要開始測試,您必須先在Postman上設定集合和環境。 接著,指定您要測試的連線規格ID。
flowSpecificationId
和targetConnectionSpecId
除外,它們是固定值。x-api-key
x-api-key
的詳細資訊,請參閱有關驗證及存取Experience Platform API的教學課程。c8d9a2f5c1e03789bd22e8efdd1bdc1b
x-gw-ims-org-id
x-gw-ims-org-id
資訊的說明,請參閱設定開發人員主控台和 Postman的教學課程。ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken
authorizationToken
的詳細資訊,請參閱有關驗證及存取Experience Platform API的教學課程。Bearer authorizationToken
schemaId
https://ns.adobe.com/{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
schemaVersion
application/vnd.adobe.xed-full-notext+json; version=1
schemaAltId
schemaId
一併傳回的meta:altId
。_{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
mappings
[{"destinationXdmPath":"person.name.firstName","sourceAttribute":"email.email_id","identity":false,"version":0},{"destinationXdmPath":"person.name.lastName","sourceAttribute":"email.activity.action","identity":false,"version":0}]
mappingId
bf5286a9c1ad4266baca76ba3adc9366
flowSpecificationId
GenericStreamingAEP
的流程規格識別碼。 這是固定值。e77fde5a-22a8-11ed-861d-0242ac120002
targetConnectionSpecId
c604ff05-7f1a-43c0-8e18-33bf874cb11c
verifyWatTimeInSecond
40
startTime
1597784298
提供所有環境變數後,您就可以使用Postman介面開始執行集合。 在Postman介面中,選取Sources SSSs Verification Collection旁的省略符號(…),然後選取 執行集合。
Runner介面會出現,可讓您設定資料流的執行順序。 選取 執行SSS驗證集合 以執行集合。
使用UI測試您的來源
若要在UI中測試您的來源,請前往Experience Platform UI中您組織沙箱的來源目錄。 從這裡,您應該會看到新來源出現在 串流 類別下。
由於您的沙箱中現在有您的新來源,您必須遵循來源工作流程以測試功能。 若要開始,請選取 設定。
新增資料步驟隨即顯示。 若要測試您的來源是否可以串流資料,請使用介面的左側來上傳範例JSON資料。 上傳資料後,介面的右側會更新為資料的檔案階層預覽。 選取 下一步 以繼續。
資料流詳細資料頁面可讓您選取要使用現有資料集還是新資料集。 在此程式中,您也可以設定要擷取至設定檔的資料,並啟用錯誤診斷和部分擷取之類的設定。
若要進行測試,請選取 新資料集,並提供輸出資料集名稱。 在此步驟中,您也可以提供選用的說明,將更多資訊新增至資料集。 接下來,使用進階搜尋選項,或捲動下拉式選單中的現有結構描述清單,選取要對應的結構描述。 選取結構描述後,請為資料流提供名稱和說明。
完成後,選取 下一步。
對應步驟出現,為您提供介面,用於將來源結構描述中的來源欄位對應到目標結構描述中適當的目標XDM欄位。
Experience Platform會根據您選取的目標結構或資料集,為自動對應的欄位提供智慧型建議。 您可以手動調整對應規則以符合您的使用案例。 您可以根據自己的需求,選擇直接對應欄位,或使用資料準備函式來轉換來源資料,以衍生計算或計算的值。 如需使用對應程式介面和計算欄位的完整步驟,請參閱資料準備UI指南
成功對應來源資料後,請選取 下一步。
檢閱 步驟隨即顯示,可讓您在建立新資料流之前先檢閱該資料流。 詳細資料會分組到以下類別中:
- 連線:顯示您的帳戶名稱、來源型別,以及您所使用串流雲端儲存空間來源的其他特定資訊。
- 指派資料集和對應欄位:顯示您用於資料流的目標資料集和結構描述。
檢閱您的資料流後,請選取 完成,並等待一些時間來建立資料流。
最後,您必須擷取資料流的串流端點。 此端點將用於訂閱您的webhook,讓您的串流來源能夠與Experience Platform通訊。 若要擷取您的串流端點,請移至您剛建立之資料流的資料流活動頁面,並從屬性面板底部複製端點。
提交您的來源
當您的來源能夠完成整個工作流程後,您可以繼續聯絡您的Adobe代表,並提交您的來源,以跨其他Experience Platform組織整合。