建立驗證的串流連線

「已驗證的資料收集」可讓Adobe Experience Platform服務( Real-time Customer Profile 例如 Identity和)區隔來自受信任來源和不受信任來源的記錄。 想要傳送個人識別資訊(PII)的客戶可以透過傳送存取Token作為POST要求的一部分來傳送。

快速入門

必須註冊串流連線，才能開始將資料串流至Adobe Experience Platform。 在註冊串流連線時，您需要提供一些關鍵詳細資訊，例如串流資料來源。

在註冊串流連線後，身為資料產生者的您將擁有可用來串流資料的唯一URL Platform。

本教學課程也需要具備各種Adobe Experience Platform服務的相關知識。 在開始本教學課程之前，請先閱讀下列服務的檔案：

以下章節提供您需要知道的其他資訊，以便成功呼叫串流擷取API。

讀取範例API呼叫

本指南提供範例API呼叫，以示範如何格式化您的請求。 這些包括路徑、必要標題和正確格式化的請求負載。 也提供API回應中傳回的範例JSON。 如需範例API呼叫檔案中所用慣例的詳細資訊，請參閱疑難排解指 南中有關如何讀取範例API呼叫的 Experience Platform 章節。

收集必要標題的值

若要呼叫API，您必 Platform 須先完成驗證教 學課程。 完成驗證教學課程後，將提供所有 Experience Platform API呼叫中每個必要標題的值，如下所示：

  • 授權：生產者 {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}

中的所有資 Experience Platform 源都與特定虛擬沙盒隔離。 對API的所 Platform 有請求都需要一個標題，該標題會指定要在中執行的操作的沙盒名稱：

  • x-sandbox-name: {SANDBOX_NAME}
注意

如需中沙盒的詳細資訊 Platform，請參閱沙 盒概述檔案。

所有包含裝載(POST、PUT、PATCH)的請求都需要額外的標題：

  • 內容類型：application/json

建立連線

連線會指定來源，並包含讓流與串流擷取API相容所需的資訊。

API格式

POST /flowservice/connections

請求

注意

必須使用列 providerId 出和的 connectionSpec 值 ​​，如示例中所示，因為它們是您為串流擷取建立串流連線的API所指定的值。

curl -X POST https://platform.adobe.io/data/foundation/flowservice/connections \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
     "name": "Sample name",
     "providerId": "521eee4d-8cbe-4906-bb48-fb6bd4450033",
     "description": "Sample description",
     "connectionSpec": {
         "id": "bc7b00d6-623a-4dfc-9fdb-f1240aeadaeb",
         "version": "1.0"
     },
     "auth": {
         "specName": "Streaming Connection",
         "params": {
             "sourceId": "Sample connection",
             "dataType": "xdm",
             "name": "Sample connection",
             "authenticationRequired": true
         }
     }
 }

回應

成功的回應會傳回HTTP狀態201，並包含新建連線的詳細資訊。

{
    "id": "77a05521-91d6-451c-a055-2191d6851c34",
    "etag": "\"a500e689-0000-0200-0000-5e31df730000\""
}
屬性 說明
id 新建 id 的連線的名稱。 這在這裡稱為 {CONNECTION_ID}。
etag 指派給連接的標識符，指定連接的修訂版本。

取得資料收集URL

建立連線後，您現在可以擷取資料收集URL。

API格式

GET /flowservice/connections/{CONNECTION_ID}
參數 說明
{CONNECTION_ID} 您 id 先前建立的連接的值。

請求

curl -X GET https://platform.adobe.io/data/foundation/flowservice/connections/{CONNECTION_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

成功的響應返回HTTP狀態200，其中包含所請求連接的詳細資訊。 資料收集URL會自動與連線建立，並可使用值來擷 inletUrl 取。

{
    "items": [
        {
            "createdAt": 1583971856947,
            "updatedAt": 1583971856947,
            "createdBy": "{API_KEY}",
            "updatedBy": "{API_KEY}",
            "createdClient": "{USER_ID}",
            "updatedClient": "{USER_ID}",
            "id": "77a05521-91d6-451c-a055-2191d6851c34",
            "name": "Another new sample connection (Experience Event)",
            "description": "Sample description",
            "connectionSpec": {
                "id": "bc7b00d6-623a-4dfc-9fdb-f1240aeadaeb",
                "version": "1.0"
            },
            "state": "enabled",
            "auth": {
                "specName": "Streaming Connection",
                "params": {
                    "sourceId": "Sample connection (ExperienceEvent)",
                    "inletUrl": "https://dcs.adobedc.net/collection/a868e1ce678a911ef1482b083329af3cafa4bafdc781285f25911eaae9e00eb2",
                    "inletId": "a868e1ce678a911ef1482b083329af3cafa4bafdc781285f25911eaae9e00eb2",
                    "dataType": "xdm",
                    "name": "Sample connection (ExperienceEvent)"
                }
            },
            "version": "\"56008aee-0000-0200-0000-5e697e150000\"",
            "etag": "\"56008aee-0000-0200-0000-5e697e150000\""
        }
    ]
}

後續步驟

現在您已建立驗證的串流連線，您可以串流化時間序列或記錄資料，讓您在其中內嵌資料 Platform。 若要瞭解如何將時間系列資料串流 Platform至，請前往串 流時間系列資料教學課程。 若要瞭解如何將記錄資料串流 Platform至，請至串流 記錄資料教學課程。

附錄

本節提供有關已驗證串流連線的補充資訊。

傳送訊息至已驗證的串流連線

如果串流連線已啟用驗證，則用戶端必須將標題新 Authorization 增至其請求。

如果 Authorization 標頭不存在，或傳送無效／過期的存取Token，則會傳回HTTP 401未授權回應，回應類似如下：

回應

{
    "type": "https://ns.adobe.com/adobecloud/problem/data-collection-service-authorization",
    "status": "401",
    "title": "Authorization",
    "report": {
        "message": "[id] Ims service token is empty"
    }
}

本頁內容