串流目的地測試API概覽
作為Destination SDK的一部分，Adobe提供開發人員工具，協助您設定和測試目的地。 此頁面說明如何測試目的地組態。 如需有關如何建立訊息轉換範本的資訊，請閱讀建立並測試訊息轉換範本。
若要 測試您的目的地是否已正確設定，以及驗證資料流至您設定的目的地 的完整性，請使用 目的地測試工具。 使用此工具，您可以傳送訊息至REST API端點，以測試目的地設定。
以下說明測試您的目的地如何符合Destination SDK中的目的地設定工作流程：
目的地測試工具 — 用途和先決條件 destination-testing-tool
使用目的地測試工具，將訊息傳送至您在伺服器設定中提供的夥伴端點，以測試您的目的地設定。
在使用工具之前，請確定：
- 依照目的地設定工作流程中概述的步驟設定您的目的地，並且
- 建立與您的目的地的連線，如如何取得目的地執行個體識別碼所詳述。
使用此工具，在設定目的地後，您可以：
- 測試您的目的地是否已正確設定；
- 驗證資料流至您設定之目的地的完整性。
使用方式 how-to-use
NOTE
如需完整的API參考檔案，請閱讀目的地測試API作業。
您可以呼叫目的地測試API端點，並在請求中新增設定檔或不新增設定檔。
如果您未在請求中新增任何設定檔，Adobe會在內部為您產生這些設定檔，並將其新增至請求中。 如果您想要產生設定檔以在此要求中使用，請參閱範例設定檔產生API參考。 您必須根據來源XDM結構描述產生設定檔，如API參考所示。 請注意，來源結構描述是您使用之沙箱的聯合結構描述。
回應包含目的地請求處理的結果。 此請求包含三個主要區段：
- 由Adobe為目的地產生的請求。
- 從您的目的地收到的回應。
- 在要求中傳送的設定檔清單，無論設定檔是由您在要求🔗中新增的，或是Adobe在目的地測試要求的主體是空的時產生的。
NOTE
Adobe可產生多個請求和回應配對。 例如，如果您將10個設定檔傳送到具有
maxUsersPerRequest值7的目的地，則會有一個包含7個設定檔的請求，以及另一個包含3個設定檔的請求。內文中有設定檔引數的範例要求
curl --location --request POST 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/3e0ac39c-ef14-4101-9fd9-cf0909814510' \
--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":{
"Email":[
{
"id":"Email-iIyJc"
}
],
"IDFA":[
{
"id":"IDFA-viPAW"
}
],
"GAID":[
{
"id":"GAID-Bc6LE"
}
],
"Email_LC_SHA256":[
{
"id":"Email_LC_SHA256-gEOdj"
}
]
},
"attributes":{
"key":{
"value":"string"
}
}
}
]
}'
內文中沒有設定檔引數的範例要求
curl --location --request POST 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/3e0ac39c-ef14-4101-9fd9-cf0909814510' \
--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 ''
範例回應
請注意，results.httpCalls引數的內容是您的REST 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":{
"Email":[
{
"id":"Email-iIyJc"
}
],
"IDFA":[
{
"id":"IDFA-viPAW"
}
],
"GAID":[
{
"id":"GAID-Bc6LE"
}
],
"Email_LC_SHA256":[
{
"id":"Email_LC_SHA256-gEOdj"
}
]
},
"person":{
"name":{
"firstName":"string"
}
}
}
]
}
如需要求與回應引數的說明，請參閱目的地測試API作業。
7f4d1967-bf93-4dba-9789-bb6b505339d6