使用範例設定檔測試您的串流目的地 template-api-operations

IMPORTANT
API端點https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/

此頁面列出並描述您可以使用/authoring/testing/destinationInstance/ API端點執行的所有API作業,以測試您的目的地是否正確設定,以及驗證資料流至您設定之目的地的完整性。 如需此端點支援功能的說明,請閱讀測試您的目的地組態

您向測試端點提出請求,無論是否將設定檔新增至呼叫。 如果您未在請求上傳送任何設定檔,Adobe會在內部為您產生這些設定檔,並將其新增至請求中。

您可以使用範例設定檔產生API來建立設定檔,以用於目的地測試API的要求。

如何取得目的地執行個體ID get-destination-instance-id

IMPORTANT

開始使用目的地測試API操作 get-started

繼續之前,請檢閱快速入門手冊以取得重要資訊,您必須瞭解這些資訊才能成功呼叫API,包括如何取得必要的目的地撰寫許可權和必要的標頭。

測試您的目的地設定,而不將設定檔新增至呼叫 test-without-adding-profiles

您可以透過向authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}端點發出POST請求並提供您正在測試的目的地的目的地執行個體識別碼,來測試您的目的地設定。

API格式

POST authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}
查詢引數
說明
{DESTINATION_INSTANCE_ID}
您正在測試之目的地的目的地執行個體ID。

要求

以下請求會呼叫您目的地的REST API端點。 要求是由{DESTINATION_INSTANCE_ID}查詢引數所設定。

curl --location --request POST 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/49966037-32cd-4457-a105-2cbf9c01826a' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'x-api-key: {API_KEY}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \

回應

成功的回應會傳回HTTP狀態200以及您目的地REST API端點的API回應。

{
   "results":[
      {
         "aggregationKey":{
            "destinationInstanceId":"string",
            "segmentId":"string",
            "segmentStatus":"realized",
            "identityNamespaces":[
               [
                  "email",
                  "phone"
               ]
            ]
         },
         "httpCalls":[
            {
               "traceId":"a06fec2d-a886-4219-8975-4e4b7ed26539",
               "request":{
                  "body":"{ \"attributes\": [  { \"external_id\": \"external_id-h29Fq\"  , \"AdobeExperiencePlatformSegments\": { \"add\": [  \"Nirvana fans\" ,  \"RHCP fans\"   ], \"remove\": [  ] }  ,  \"key\":  \"string\"    }  ] }",
                  "headers":[
                     {
                        "Content-Type":"application/json"
                     }
                  ],
                  "method":"POST",
                  "uri":"https://api.moviestar.com/users/track"
               },
               "response":{
                  "body":"{\"status\": \"success\"}",
                  "code":"200",
                  "headers":[
                     {
                        "Connection":"keep-alive"
                     },
                     {
                        "Content-Type":"application/json"
                     },
                     {
                        "Server":"nginx"
                     },
                     {
                        "Vary":"Origin,Accept-Encoding"
                     },
                     {
                        "transfer-encoding":"chunked"
                     }
                  ]
               }
            }
         ]
      }
   ],
   "inputProfiles":[
      {
         "segmentMembership":{
            "ups":{
               "03fb9938-8537-4b4c-87f9-9c4d413a0ee5":{
                  "lastQualificationTime":"2021-06-17T12:25:12.872039Z",
                  "status":"realized"
               },
               "27e05542-d6a3-46c7-9c8e-d59d50229530":{
                  "lastQualificationTime":"2021-06-17T12:25:12.872042Z",
                  "status":"realized"
               }
            }
         },
         "personalEmail":{
            "address":"john.smith@abc.com"
         },
         "identityMap":{
            "ECID":[
               {
                  "id":"ECID-vlnt6"
               }
            ]
         },
         "person":{
            "name":{
               "firstName":"string"
            }
         }
      }
   ]
}
屬性
說明
aggregationKey
包含針對目的地設定的彙總原則相關資訊。 如需詳細資訊,請閱讀彙總原則檔案。
traceId
作業的唯一識別碼。 發生錯誤時,您可以與Adobe團隊共用此ID,以進行疑難排解。
results.httpCalls.request
包含Adobe傳送至您的目的地的要求。
results.httpCalls.response
包含Adobe從目的地收到的回應。
inputProfiles
包含在呼叫目的地時匯出的設定檔。 設定檔符合您的來源結構描述。

使用新增至呼叫的設定檔測試您的目的地設定 test-with-added-profiles

您可以透過向authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}端點發出POST請求並提供您正在測試的目的地的目的地執行個體識別碼,來測試您的目的地設定。

API格式

POST authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}
查詢引數
說明
{DESTINATION_INSTANCE_ID}
您正在測試之目的地的目的地執行個體ID。

要求

以下請求會呼叫您目的地的REST API端點。 要求是由承載中提供的引數和{DESTINATION_INSTANCE_ID}查詢引數所設定。

curl --location --request POST 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/49966037-32cd-4457-a105-2cbf9c01826a' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'x-api-key: {API_KEY}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--data-raw '{
   "profiles":[
      {
         "segmentMembership":{
            "ups":{
               "374a9a6c-c719-4cdb-a660-155a2838e6d6":{
                  "lastQualificationTime":"2021-05-13T12:16:27.248585Z",
                  "status":"realized"
               },
               "896f8776-9498-47b4-b994-51cb3f61c2c5":{
                  "lastQualificationTime":"2021-05-13T12:16:27.248605Z",
                  "status":"realized"
               }
            }
         },
         "identityMap":{
            "ECID":[
               {
                  "id":"ECID-Z3i2t"
               }
            ],
            "external_id":[
               {
                  "id":"external_id-h29Fq"
               }
            ]
         },
         "attributes":{
            "firstName":{
               "value":"John"
            }
         }
      }
   ]
}'

回應

成功的回應會傳回HTTP狀態200以及您目的地REST API端點的API回應。

{
   "results":[
      {
         "aggregationKey":{
            "destinationInstanceId":"string",
            "segmentId":"string",
            "segmentStatus":"realized",
            "identityNamespaces":[
               [
                  "email",
                  "phone"
               ]
            ]
         },
         "httpCalls":[
            {
               "traceId":"a06fec2d-a886-4219-8975-4e4b7ed26539",
               "request":{
                  "body":"{ \"attributes\": [  { \"external_id\": \"external_id-h29Fq\"  , \"AdobeExperiencePlatformSegments\": { \"add\": [  \"Nirvana fans\" ,  \"RHCP fans\"   ], \"remove\": [  ] }  ,  \"key\":  \"string\"    }  ] }",
                  "headers":[
                     {
                        "Content-Type":"application/json"
                     }
                  ],
                  "method":"POST",
                  "uri":"https://api.moviestar.com/users/track"
               },
               "response":{
                  "body":"{\"status\": \"success\"}",
                  "code":"200",
                  "headers":[
                     {
                        "Connection":"keep-alive"
                     },
                     {
                        "Content-Type":"application/json"
                     },
                     {
                        "Server":"nginx"
                     },
                     {
                        "Vary":"Origin,Accept-Encoding"
                     },
                     {
                        "transfer-encoding":"chunked"
                     }
                  ]
               }
            }
         ]
      }
   ],
   "inputProfiles":[
      {
         "segmentMembership":{
            "ups":{
               "374a9a6c-c719-4cdb-a660-155a2838e6d6":{
                  "lastQualificationTime":"2021-05-13T12:16:27.248585Z",
                  "status":"realized"
               },
               "896f8776-9498-47b4-b994-51cb3f61c2c5":{
                  "lastQualificationTime":"2021-05-13T12:16:27.248605Z",
                  "status":"realized"
               }
            }
         },
         "identityMap":{
            "ECID":[
               {
                  "id":"ECID-Z3i2t"
               }
            ],
            "external_id":[
               {
                  "id":"external_id-h29Fq"
               }
            ]
         },
         "attributes":{
            "firstName":{
               "value":"John"
            }
         }
      }
   ]
}

API錯誤處理 api-error-handling

Destination SDK API端點遵循一般Experience Platform API錯誤訊息原則。 請參閱Platform疑難排解指南中的API狀態碼請求標頭錯誤

後續步驟

閱讀本檔案後,您現在知道如何測試您的目的地。 您現在可以使用Adobe自助式檔案程式,為您的目的地建立檔案頁面。

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6