[Beta]{class="badge informative"}

建立來源連線和資料流，以使用Flow Service API串流 YOURSOURCE 資料

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

開發人員

當您瀏覽此範本時，請取代或刪除所有斜體字的段落（從此段落開始）。

從更新頁面頂端的中繼資料（標題和說明）開始。請忽略此頁面上的所有DNL執行個體。此標籤可協助我們的機器翻譯流程將頁面正確翻譯為我們支援的多種語言。我們會在您提交檔案後新增標籤。

概觀

提供您公司的簡短概觀，包括它提供給客戶的價值。加入產品檔案首頁的連結，以便進一步閱讀。

IMPORTANT

此來源聯結器和檔案頁面是由 YOURSOURCE 團隊建立並維護的。若有任何查詢或更新要求，請直接透過 插入連結或電子郵件地址 連絡您以取得更新。

先決條件

在本節中新增客戶在Adobe Experience Platform使用者介面中開始設定來源之前需要注意的任何相關資訊。這可能約：

需要新增至允許清單
電子郵件雜湊需求
您這邊的任何帳戶細節
如何取得API金鑰以連線至您的平台

收集必要的認證

若要將 YOURSOURCE 連線至Experience Platform，您必須提供下列連線屬性的值：

認證

說明

範例

認證一

請在此加入來源驗證認證的簡短說明

請在此加入來源驗證認證的範例

認證二

請在此加入來源驗證認證的簡短說明

請在此加入來源驗證認證的範例

認證三

請在此加入來源驗證認證的簡短說明

請在此加入來源驗證認證的範例

如需這些認證的詳細資訊，請參閱 YOURSOURCE 驗證檔案。 請在此加入您平台驗證檔案的連結。

將 YOURSOURCE 與您的webhook整合

串流SDK需要您的來源能夠支援webhook，才能與Experience Platform通訊。在本節中，您必須提供使用者必須遵循的步驟，才能將YOURSOURCE與webhook整合。

使用Flow Service API將 YOURSOURCE 連線至Experience Platform

下列教學課程將逐步引導您建立 YOURSOURCE 來源連線與建立資料流，以使用Flow Service API將 YOURSOURCE 資料帶入Experience Platform。

建立來源連線 source-connection

向Flow Service API發出POST要求，同時提供您來源的連線規格ID、詳細資訊（例如名稱和說明）以及資料的格式，藉此建立來源連線。

API格式

POST /sourceConnections

要求

下列要求會建立 YOURSOURCE 的來源連線：

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/sourceConnections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Streaming Source Connection for a Streaming SDK source",
      "providerId": "521eee4d-8cbe-4906-bb48-fb6bd4450033",
      "description": "Streaming Source Connection for a Streaming SDK source",
      "connectionSpec": {
          "id": "e77fd9d2-22a8-11ed-861d-0242ac120002",
          "version": "1.0"
      },
      "data": {
          "format": "json"
      }
    }'

屬性

說明

name

來源連線的名稱。確保來源連線的名稱是描述性的，因為您可以使用此名稱來查詢來源連線的資訊。

description

您可以納入的選用值，可提供來源連線的詳細資訊。

connectionSpec.id

與您的來源對應的連線規格ID。

data.format

您要擷取的 YOURSOURCE 資料格式。目前唯一支援的資料格式為json。

回應

成功的回應會傳回新建立的來源連線的唯一識別碼(id)。在後續步驟中需要此ID才能建立資料流。

{
     "id": "246d052c-da4a-494a-937f-a0d17b1c6cf5",
     "etag": "\"712a8c08-fda7-41c2-984b-187f823293d8\""
}

建立目標XDM結構描述 target-schema

為了在Experience Platform中使用來源資料，必須建立目標結構描述，以根據您的需求建構來源資料。然後使用目標結構描述來建立包含來源資料的Experience Platform資料集。

可透過對結構描述登入API執行POST要求來建立目標XDM結構描述。

如需有關如何建立目標XDM結構描述的詳細步驟，請參閱有關使用API 建立結構描述的教學課程。

建立目標資料集 target-dataset

可透過對目錄服務API執行POST要求，在承載中提供目標結構描述的ID，來建立目標資料集。

如需有關如何建立目標資料集的詳細步驟，請參閱有關使用API建立資料集的教學課程。

建立目標連線 target-connection

目標連線代表與要儲存所擷取資料的目的地之間的連線。若要建立目標連線，您必須提供對應至資料湖的固定連線規格ID。此ID為： c604ff05-7f1a-43c0-8e18-33bf874cb11c。

您現在具有目標結構描述、目標資料集和到資料湖的連線規格ID的唯一識別碼。使用這些識別碼，您可以使用Flow Service API建立目標連線，以指定將包含傳入來源資料的資料集。

API格式

POST /targetConnections

要求

下列要求會建立 YOURSOURCE 的目標連線：

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/targetConnections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Streaming Target Connection for a Streaming SDK source",
      "description": "Streaming Target Connection for a Streaming SDK source",
      "connectionSpec": {
          "id": "c604ff05-7f1a-43c0-8e18-33bf874cb11c",
          "version": "1.0"
      },
      "data": {
          "format": "json",
          "schema": {
              "id": "{TARGET_XDM_SCHEMA}",
              "version": "application/vnd.adobe.xed-full+json;version=1"
          }
      },
      "params": {
          "dataSetId": "{TARGET_DATASET}"
      }
  }'

屬性

說明

name

目標連線的名稱。請確定目標連線的名稱是描述性的，因為您可以使用此名稱來查詢目標連線的資訊。

description

您可以納入的選用值，可提供目標連線的詳細資訊。

connectionSpec.id

對應至資料湖的連線規格ID。此固定ID為： c604ff05-7f1a-43c0-8e18-33bf874cb11c。

data.format

您要帶至Experience Platform的 YOURSOURCE 資料格式。

params.dataSetId

在上一步中擷取的目標資料集ID。

回應

成功的回應會傳回新目標連線的唯一識別碼(id)。此ID在後續步驟中是必要的。

{
     "id": "7c96c827-3ffd-460c-a573-e9558f72f263",
     "etag": "\"a196f685-f5e8-4c4c-bfbd-136141bb0c6d\""
}

建立對應 mapping

為了將來源資料擷取到目標資料集中，必須首先將其對應到目標資料集所堅持的目標結構描述。這是透過使用在要求裝載中定義的資料對應對Data Prep API執行POST要求來達成。

API格式

POST /conversion/mappingSets

要求

curl -X POST \
  'https://platform.adobe.io/data/foundation/mappingSets' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "version": 0,
      "xdmSchema": "{TARGET_XDM_SCHEMA}",
      "xdmVersion": "1.0",
      "mappings": [
          {
              "destinationXdmPath": "person.name.firstName",
              "sourceAttribute": "firstName",
              "identity": false,
              "version": 0
          },
          {
              "destinationXdmPath": "person.name.lastName",
              "sourceAttribute": "lastName",
              "identity": false,
              "version": 0
          }
      ]
  }'

屬性

說明

xdmSchema

在先前步驟中產生的目標XDM結構描述識別碼。

mappings.destinationXdmPath

來源屬性對應到的目的地XDM路徑。

mappings.sourceAttribute

需要對映至目的地XDM路徑的來源屬性。

mappings.identity

布林值，指定是否將對應集標示為Identity Service。

回應

成功的回應會傳回新建立的對應詳細資料，包括其唯一識別碼(id)。在後續步驟中需要此值，才能建立資料流。

{
    "id": "bf5286a9c1ad4266baca76ba3adc9366",
    "version": 0,
    "createdDate": 1597784069368,
    "modifiedDate": 1597784069368,
    "createdBy": "{CREATED_BY}",
    "modifiedBy": "{MODIFIED_BY}"
}

建立流程 flow

從 YOURSOURCE 將資料引進Experience Platform的最後一個步驟是建立資料流。到現在為止，您已準備下列必要值：

Source連線ID
目標連線ID
對應 ID

資料流負責從來源排程及收集資料。您可以執行POST要求，同時在裝載中提供先前提及的值來建立資料流。

API格式

POST /flows

要求

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/flows' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Streaming Dataflow for a Streaming SDK source",
      "description": "Streaming Dataflow for a Streaming SDK source",
      "flowSpec": {
          "id": "e77fde5a-22a8-11ed-861d-0242ac120002",
          "version": "1.0"
      },
      "sourceConnectionIds": [
          "246d052c-da4a-494a-937f-a0d17b1c6cf5"
      ],
      "targetConnectionIds": [
          "7c96c827-3ffd-460c-a573-e9558f72f263"
      ],
      "transformations": [
      {
        "name": "Mapping",
        "params": {
          "mappingId": "bf5286a9c1ad4266baca76ba3adc9366",
          "mappingVersion": 0
        }
      }
    ]
  }'

屬性

說明

name

資料流的名稱。確保資料流的名稱是描述性的，因為您可以使用此名稱來查閱資料流上的資訊。

description

您可以納入的選用值，可提供資料流的詳細資訊。

flowSpec.id

建立資料流所需的流量規格ID。此固定ID為： e77fde5a-22a8-11ed-861d-0242ac120002。

flowSpec.version

流程規格ID的對應版本。此值預設為1.0。

sourceConnectionIds

在先前步驟中產生的來源連線識別碼。

targetConnectionIds

在先前步驟中產生的目標連線識別碼。

transformations

此屬性包含套用至資料所需的各種轉換。將非XDM相容的資料引進Experience Platform時，需要此屬性。

transformations.name

指定給轉換的名稱。

transformations.params.mappingId

在先前步驟中產生的對應ID。

transformations.params.mappingVersion

對應ID的對應版本。此值預設為0。

回應

成功的回應會傳回新建立的資料流識別碼(id)。您可以使用此ID來監視、更新或刪除資料流。

{
     "id": "993f908f-3342-4d9c-9f3c-5aa9a189ca1a",
     "etag": "\"510bb1d4-8453-4034-b991-ab942e11dd8a\""
}

取得您的串流端點URL

建立資料流後，您現在可以擷取串流端點URL。您將使用此端點URL來訂閱您的來源至webhook，讓您的來源可與Experience Platform通訊。

若要擷取您的串流端點URL，請對/flows端點提出GET要求，並提供資料流的ID。

API格式

GET /flows/{FLOW_ID}

要求

curl -X GET \
  'https://platform.adobe.io/data/foundation/flowservice/flows/993f908f-3342-4d9c-9f3c-5aa9a189ca1a' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

成功的回應會傳回資料流上的資訊，包括標示為inletUrl的端點URL。

{
  "items": [
    {
      "id": "993f908f-3342-4d9c-9f3c-5aa9a189ca1a",
      "createdAt": 1669238699119,
      "updatedAt": 1669238699119,
      "createdBy": "acme@AdobeID",
      "updatedBy": "acme@AdobeID",
      "createdClient": "{CREATED_CLIENT}",
      "updatedClient": "{UPDATED_CLIENT}",
      "sandboxId": "{SANDBOX_ID}",
      "sandboxName": "{SANDBOX_NAME}",
      "imsOrgId": "{ORG_ID}",
      "name": "Streaming Dataflow for a Streaming SDK source",
      "description": "Streaming Dataflow for a Streaming SDK source",
      "flowSpec": {
        "id": "e77fde5a-22a8-11ed-861d-0242ac120002",
        "version": "1.0"
      },
      "state": "enabled",
      "version": "\"a1011225-0000-0200-0000-63c78ae60000\"",
      "etag": "\"a1011225-0000-0200-0000-63c78ae60000\"",
      "sourceConnectionIds": [
        "246d052c-da4a-494a-937f-a0d17b1c6cf5"
      ],
      "targetConnectionIds": [
        "7c96c827-3ffd-460c-a573-e9558f72f263"
      ],
      "inheritedAttributes": {
        "properties": {
          "isSourceFlow": true
        },
        "sourceConnections": [
          {
            "id": "246d052c-da4a-494a-937f-a0d17b1c6cf5",
            "connectionSpec": {
              "id": "bdb5b792-451b-42de-acf8-15f3195821de",
              "version": "1.0"
            }
          }
        ],
        "targetConnections": [
          {
            "id": "7c96c827-3ffd-460c-a573-e9558f72f263",
            "connectionSpec": {
              "id": "c604ff05-7f1a-43c0-8e18-33bf874cb11c",
              "version": "1.0"
            }
          }
        ]
      },
      "options": {
        "errorDiagnosticsEnabled": true,
        "inletUrl": "https://dcs-int.adobedc.net/collection/ab65636c31778fb0455c439ffb48a5433a34d443f4c83c4b5beda9c5688797c5"
      },
      "transformations": [
        {
          "name": "Mapping",
          "params": {
            "mappingVersion": 0,
            "mappingId": "bf5286a9c1ad4266baca76ba3adc9366"
          }
        }
      ],
      "runs": "/runs?property=flowId==e1514b79-f031-43b4-aab5-381a42f86ad4",
      "providerRefId": "c9809ab5-71e0-4c7f-887b-61c95e4e20b5",
      "lastOperation": {
        "started": 0,
        "updated": 0,
        "operation": "enable"
      }
    }
  ]
}

附錄

下節提供監視、更新和刪除資料流的步驟相關資訊。

監視資料流

建立資料流後，您可以監視透過該資料流擷取的資料，以檢視有關資料流執行、完成狀態和錯誤的資訊。如需完整的API範例，請閱讀使用API監視您的來源資料流的指南。

更新您的資料流

提供資料流的ID時，透過向Flow Service API的/flows端點發出PATCH要求，更新資料流的詳細資訊，例如其名稱和說明，以及其執行排程和相關聯的對應集。發出PATCH請求時，您必須在If-Match標頭中提供資料流的唯一etag。如需完整的API範例，請閱讀使用API更新來源資料流的指南

更新您的帳戶

在提供您的基本連線ID作為查詢引數的同時，透過對Flow Service API執行PATCH請求來更新來源帳戶的名稱、說明和認證。發出PATCH請求時，您必須在If-Match標頭中提供來源帳戶的唯一etag。如需完整的API範例，請閱讀使用API更新來源帳戶的指南。

刪除您的資料流

提供您要刪除之資料流的ID做為查詢引數的一部分，同時對Flow Service API執行DELETE要求，以刪除您的資料流。如需完整的API範例，請閱讀使用API刪除資料流的指南。

刪除您的帳戶

在提供您要刪除之帳戶的基本連線ID時，對Flow Service API執行DELETE要求，以刪除您的帳戶。如需完整的API範例，請閱讀使用API刪除來源帳戶的指南。

recommendation-more-help

337b99bb-92fb-42ae-b6b7-c7042161d089

建立來源連線和資料流，以使用Flow Service API串流​ YOURSOURCE ​資料

概觀

先決條件

收集必要的認證

將​ YOURSOURCE ​與您的webhook整合

使用Flow Service API將​ YOURSOURCE ​連線至Experience Platform

建立來源連線 source-connection

建立目標XDM結構描述 target-schema

建立目標資料集 target-dataset

建立目標連線 target-connection

建立對應 mapping

建立流程 flow

取得您的串流端點URL

附錄

監視資料流

更新您的資料流

更新您的帳戶

刪除您的資料流

刪除您的帳戶

建立來源連線和資料流，以使用Flow Service API串流 YOURSOURCE 資料

將 YOURSOURCE 與您的webhook整合

使用Flow Service API將 YOURSOURCE 連線至Experience Platform