[Beta]{class="badge informative"}

測試並提交您的來源

NOTE
自助來源串流SDK為測試版。 如需使用Beta版標籤來源的相關資訊,請參閱來源概觀

使用自助式來源(串流SDK)將新來源整合到Adobe Experience Platform的最後步驟,是測試並提交您的新來源。 當您完成連線規格並更新串流流程規格後,您就可以開始透過API或UI測試來源的功能。 成功後,您可以連絡您的Adobe代表以提交新的來源。

以下檔案提供如何使用Flow Service API測試及偵錯來源的步驟。

快速入門

使用API測試您的來源

若要使用API測試您的來源,您必須在Postman上執行自助來源驗證集合和環境,同時提供與您的來源相關的適當環境變數。

若要開始測試,您必須先在Postman上設定集合和環境。 接著,指定您要測試的連線規格ID。

NOTE
以下所有範例變數都是您必須更新的預留位置值,flowSpecificationIdtargetConnectionSpecId除外,它們是固定值。
參數
說明
範例
x-api-key
用於驗證Experience Platform API呼叫的唯一識別碼。 如需如何擷取x-api-key的詳細資訊,請參閱有關驗證及存取Experience Platform API的教學課程。
c8d9a2f5c1e03789bd22e8efdd1bdc1b
x-gw-ims-org-id
企業實體,可以擁有或授權產品及服務並允許存取其成員。 如需如何擷取x-gw-ims-org-id資訊的說明,請參閱設定開發人員主控台和 Postman的教學課程。
ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken
完成對Experience Platform API的呼叫所需的授權權杖。 如需如何擷取authorizationToken的詳細資訊,請參閱有關驗證及存取Experience Platform API的教學課程。
Bearer authorizationToken
schemaId
為了在Experience Platform中使用來源資料,必須建立目標結構描述,以根據您的需求建構來源資料。 如需有關如何建立目標XDM結構描述的詳細步驟,請參閱有關使用API 建立結構描述的教學課程
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
dataSetId
如需有關如何建立目標資料集的詳細步驟,請參閱有關使用API建立資料集的教學課程。
5f3c3cedb2805c194ff0b69a
mappings
對應集可用來定義來源結構描述中的資料如何對應到目的地結構描述的資料。 如需有關如何建立對應的詳細步驟,請參閱有關使用API建立對應集的教學課程
[{"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
與對應集對應的唯一ID。
bf5286a9c1ad4266baca76ba3adc9366
connectionSpecId
與您的來源對應的連線規格ID。 這是您在建立新連線規格後產生的ID。
2e8580db-6489-4726-96de-e33f5f60295f
flowSpecificationId
GenericStreamingAEP的流程規格識別碼。 這是固定值
e77fde5a-22a8-11ed-861d-0242ac120002
targetConnectionSpecId
擷取的資料著陸所在資料湖的目標連線ID。 這是固定值
c604ff05-7f1a-43c0-8e18-33bf874cb11c
verifyWatTimeInSecond
檢查流程執行的完成時要遵循的指定時間間隔。
40
startTime
為資料流指定的開始時間。 開始時間的格式必須是unix時間。
1597784298

提供所有環境變數後,您就可以使用Postman介面開始執行集合。 在Postman介面中,選取Sources SSSs Verification Collection旁的省略符號(),然後選取​ 執行集合

執行者

Runner介面會出現,可讓您設定資料流的執行順序。 選取​ 執行SSS驗證集合 ​以執行集合。

NOTE
如果您偏好使用Experience Platform UI中的來源監視儀表板,可以停用執行訂單檢查清單中的​ 刪除流程。 不過,一旦完成測試,您必須確保已刪除測試流程。

run-collection

使用UI測試您的來源

若要在UI中測試您的來源,請前往Experience Platform UI中您組織沙箱的來源目錄。 從這裡,您應該會看到新來源出現在​ 串流 ​類別下。

由於您的沙箱中現在有您的新來源,您必須遵循來源工作流程以測試功能。 若要開始,請選取​ 設定

顯示新串流來源的來源目錄。

新增資料步驟隨即顯示。 若要測試您的來源是否可以串流資料,請使用介面的左側來上傳範例JSON資料。 上傳資料後,介面的右側會更新為資料的檔案階層預覽。 選取​ 下一步 ​以繼續。

來源工作流程中的新增資料步驟,您可以在其中上傳資料並在擷取之前預覽。

資料流詳細資料頁面可讓您選取要使用現有資料集還是新資料集。 在此程式中,您也可以設定要擷取至設定檔的資料,並啟用錯誤診斷和部分擷取之類的設定。

若要進行測試,請選取​ 新資料集,並提供輸出資料集名稱。 在此步驟中,您也可以提供選用的說明,將更多資訊新增至資料集。 接下來,使用進階搜尋選項,或捲動下拉式選單中的現有結構描述清單,選取要對應的結構描述。 選取結構描述後,請為資料流提供名稱和說明。

完成後,選取​ 下一步

來源工作流程中的資料流詳細資料步驟。

對應步驟出現,為您提供介面,用於將來源結構描述中的來源欄位對應到目標結構描述中適當的目標XDM欄位。

Experience Platform會根據您選取的目標結構或資料集,為自動對應的欄位提供智慧型建議。 您可以手動調整對應規則以符合您的使用案例。 您可以根據自己的需求,選擇直接對應欄位,或使用資料準備函式來轉換來源資料,以衍生計算或計算的值。 如需使用對應程式介面和計算欄位的完整步驟,請參閱資料準備UI指南

成功對應來源資料後,請選取​ 下一步

來源工作流程的對應步驟。

檢閱 ​步驟隨即顯示,可讓您在建立新資料流之前先檢閱該資料流。 詳細資料會分組到以下類別中:

  • 連線:顯示您的帳戶名稱、來源型別,以及您所使用串流雲端儲存空間來源的其他特定資訊。
  • 指派資料集和對應欄位:顯示您用於資料流的目標資料集和結構描述。

檢閱您的資料流後,請選取​ 完成,並等待一些時間來建立資料流。

來源工作流程的稽核步驟。

最後,您必須擷取資料流的串流端點。 此端點將用於訂閱您的webhook,讓您的串流來源能夠與Experience Platform通訊。 若要擷取您的串流端點,請移至您剛建立之資料流的資料流活動頁面,並從屬性面板底部複製端點。

資料流活動中的串流端點。

提交您的來源

當您的來源能夠完成整個工作流程後,您可以繼續聯絡您的Adobe代表,並提交您的來源,以跨其他Experience Platform組織整合。

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089