串流擷取驗證

串流擷取可讓您使用即時串流端點，將資料上傳至Adobe Experience Platform。串流擷取API支援同步和非同步兩種驗證模式。

快速入門

本指南需要有效瞭解Adobe Experience Platform的下列元件：

Experience Data Model (XDM) System:組織客戶體驗資料 Experience Platform 的標準化架構。
Streaming Ingestion:其中一種方法可傳送資料 Experience Platform。

讀取範例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源（包括屬於的資源）都 Schema Registry被隔離到特定的虛擬沙盒中。對API的所 Platform 有請求都需要一個標題，該標題會指定要在中執行的操作的沙盒名稱：

x-sandbox-name: {SANDBOX_NAME}

注意

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

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

內容類型： application/json

驗證涵蓋範圍

Streaming Validation Service 涵蓋下列方面的驗證：

範圍
Presence
Enum
圖樣
類型
格式

同步驗證

同步驗證是一種驗證方法，可立即提供有關擷取失敗原因的意見回應。但是，失敗時，驗證失敗的記錄會被丟棄，並且無法下游發送。因此，同步驗證只應在開發程式期間使用。在執行同步驗證時，呼叫者會得知XDM驗證的結果，以及失敗的原因。

依預設，同步驗證不會開啟。若要啟用它，您必須在進行API呼叫時傳 synchronousValidation=true 入選用查詢參數。此外，同步驗證目前僅在您的串流端點位於VA7資料中心時才可用。

如果消息在同步驗證期間失敗，則不會將該消息寫入輸出隊列，從而為用戶提供立即反饋。

API格式

POST /collection/{CONNECTION_ID}?synchronousValidation=true

參數	說明
`{CONNECTION_ID}`	先前 `id` 建立的串流連線值。

請求

提交下列要求，透過同步驗證將資料收錄至您的資料匯入：

curl -X POST https://dcs.adobedc.net/collection/{CONNECTION_ID}?synchronousValidation=true \
  -H "Content-Type: application/json" \
  -d '{JSON_PAYLOAD}'

參數	說明
`{JSON_PAYLOAD}`	您要收錄之資料的JSON內文。

回應

啟用同步驗證後，成功的回應會在其裝載中包含任何遇到的驗證錯誤：

{
    "type": "http://ns.adobe.com/adobecloud/problem/data-collection-service/inlet",
    "status": 400,
    "title": "Invalid XDM Message Format",
    "report": {
        "message": "inletId: [6aca7aa2d87ebd6b2780ca5724d94324a14475f140a2b69373dd5c714430dfd4] imsOrgId: [7BF122A65C5B3FE40A494026@AdobeOrg] Message is invalid",
        "cause": {
            "_streamingValidation": [
                {
                    "schemaLocation": "#",
                    "pointerToViolation": "#",
                    "causingExceptions": [
                        {
                            "schemaLocation": "#",
                            "pointerToViolation": "#",
                            "causingExceptions": [],
                            "keyword": "additionalProperties",
                            "message": "extraneous key [workEmail] is not permitted"
                        },
                        {
                            "schemaLocation": "#",
                            "pointerToViolation": "#",
                            "causingExceptions": [],
                            "keyword": "additionalProperties",
                            "message": "extraneous key [person] is not permitted"
                        },
                        {
                            "schemaLocation": "#/properties/_id",
                            "pointerToViolation": "#/_id",
                            "causingExceptions": [],
                            "keyword": "type",
                            "message": "expected type: String, found: Long"
                        }
                    ],
                    "message": "3 schema violations found"
                }
            ]
        }
    }
}

上述回應會列出發現多少個架構違規，以及哪些違規。例如，此響應表示在模式中 workEmail 未定 person 義鍵和鍵，因此不允許。它也會將值標示為不 _id 正確，因為模式需要 string，但 long 是已插入。請注意，一旦遇到5個錯誤，驗證服務就會停止處理該訊息。但是，其他消息將繼續被解析。

非同步驗證

非同步驗證是驗證方法，不會立即提供意見回應。而是將資料傳送至失敗的批次，以防 Data Lake 止資料遺失。此失敗的資料稍後可以擷取以供進一步分析和重播。這種方法應用於生產中。除非另有要求，否則串流擷取會在非同步驗證模式中運作。

API格式

POST /collection/{CONNECTION_ID}

參數	說明
`{CONNECTION_ID}`	先前 `id` 建立的串流連線值。

請求

提交下列要求，透過非同步驗證將資料收錄至您的資料匯入：

curl -X POST https://dcs.adobedc.net/collection/{CONNECTION_ID} \
  -H "Content-Type: application/json" \
  -d '{JSON_PAYLOAD}'

參數	說明
`{JSON_PAYLOAD}`	您要收錄之資料的JSON內文。

注意

不需要額外的查詢參數，因為非同步驗證預設會啟用。

回應

啟用非同步驗證後，成功的回應會傳回下列內容：

{
    "inletId": "f6ca9706d61de3b78be69e2673ad68ab9fb2cece0c1e1afc071718a0033e6877",
    "xactionId": "1555445493896:8600:8",
    "receivedTimeMs": 1555445493932,
    "synchronousValidation": {
        "skipped": true
    }
}

請注意響應如何表示已跳過同步驗證，因為尚未明確請求同步驗證。

附錄

本節包含各種狀態代碼對於接收資料的響應有何意義的資訊。

狀態代碼

狀態代碼	這意味著什麼
200	成功. 對於同步驗證，這表示它已通過驗證檢查。對於非同步驗證，這表示它只成功接收了訊息。使用者可透過觀察資料集來找出最終的訊息狀態。
400	錯誤. 您的要求有問題。從串流驗證服務接收含有詳細資訊的錯誤訊息。
401	錯誤. 您的要求未經授權——您需要使用不記名代號來要求。如需如何要求存取的詳細資訊，請參閱本教學課程或此部落格文章。
500	錯誤. 出現內部系統錯誤。
501	錯誤. 這表示此位置不支援同步驗證。
503	錯誤. 服務目前無法使用。客戶端至少應使用指數式回退策略重試三次。

adobe.com 上的資源

Journey Management Customer Acquisition Auto Form Fill Personalized Experiences Email Deliverability People Based Marketing