Esta página explica cómo utilizar el /testing/destinationInstance
Punto final de API para ver los detalles completos de los resultados de las pruebas de destino basadas en archivos.
Si ya ha probó su destino y recibió una respuesta de API válida, su destino funciona correctamente.
Si desea ver información más detallada acerca del flujo de activación, puede utilizar el results
de la propiedad prueba de destino respuesta de la variable, como se describe más adelante.
Este extremo de API devuelve el mismo resultado que obtendría al usar el API de Flow Service para monitorizar flujos de datos.
Antes de continuar, consulte la guía de introducción para obtener información importante que necesita conocer para realizar llamadas correctamente a la API, incluido cómo obtener el permiso de creación de destino requerido y los encabezados necesarios.
Antes de usar el /testing/destinationInstance
extremo, asegúrese de cumplir las siguientes condiciones:
Tiene un destino basado en archivos existente creado mediante el Destination SDK y puede verlo en su catálogo de destinos.
Ha creado al menos un flujo de activación para su destino en la interfaz de usuario de Experience Platform.
Para realizar correctamente la solicitud de API, necesita el ID de instancia de destino correspondiente a la instancia de destino que va a probar. Obtenga el ID de instancia de destino que debe utilizar en la llamada a la API, desde la dirección URL, al examinar una conexión con su destino en la interfaz de usuario de Platform.
Ya ha utilizado anteriormente probó la configuración de destinoy recibió una respuesta de API válida, que incluye una results
propiedad. Utilizará esto. results
para probar aún más el destino.
Una vez que haya validó la configuración de destino, puede ver los resultados detallados de la activación realizando una solicitud de GET al authoring/testing/destinationInstance/
y proporciona el ID de instancia de destino del destino que está probando y los ID de ejecución de flujo de los segmentos activados.
Puede encontrar la dirección URL de API completa que necesita utilizar en la results
propiedad devuelta en el respuesta de la llamada de prueba de destino.
Formato de API
GET /authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}/results?flowRunIds=id1,id2
Parámetros de ruta | Descripción |
---|---|
{DESTINATION_INSTANCE_ID} |
El ID de la instancia de destino para la que está generando perfiles de muestra. Consulte la requisitos previos para obtener más información sobre cómo obtener este ID. |
Parámetros de cadena de consulta | Descripción |
---|---|
flowRunIds |
Los ID de ejecución de flujo correspondientes a los segmentos activados. Puede encontrar los ID de ejecución de flujo en la results propiedad devuelta en el respuesta de la llamada de prueba de destino. |
Solicitud
curl -X GET 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/fd3449fb-b929-45c8-9f3d-06b9d6aac328/results?flowRunIds=30d34875-e7ba-4520-ab6e-5705e01dfb16,86c00ad7-443c-459a-855d-0e8cbee43c4f,12305c58-42a9-4230-8fad-1661ee49cb70' \
-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}' \
Respuesta
La respuesta contiene los detalles completos del flujo de activación. Puede obtener la misma respuesta llamando a la función API de Flow Service para monitorizar flujos de datos.
{
"items":[
{
"id":"18efd5d2-40ae-4f5c-afd1-37a39a45183a",
"flowId":"a02071ad-f3a4-496c-a2b1-468812301d5d",
"flowSpec":{
"id":"25473b67-0801-418a-ab49-ed74ebf88137",
"version":"1.0"
},
"metrics":{
"durationSummary":{
"startedAtUTC":1646652235124,
"completedAtUTC":1646652270439
},
"latencySummary":null,
"sizeSummary":{
"inputBytes":122,
"outputBytes":122
},
"recordSummary":{
"inputRecordCount":1,
"outputRecordCount":1,
"createdRecordCount":1,
"skippedRecordCount":0,
"sourceSummaries":[
{
"id":"76e4b969-9700-4557-8330-0a8390afbdde",
"entitySummaries":[
{
"inputRecordCount":1,
"skippedRecordCount":0,
"id":"segment:4326c566-f81c-4ab0-8a80-9e741a5d0b1f"
}
]
}
],
"targetSummaries":[
{
"id":"b43607b6-0dca-43b3-a0bc-ecdea4fa6aa9",
"entitySummaries":[
{
"outputRecordCount":1,
"createdRecordCount":1,
"id":"segment:4326c566-f81c-4ab0-8a80-9e741a5d0b1f"
}
]
}
]
},
"fileSummary":{
"inputFileCount":1,
"outputFileCount":1
},
"statusSummary":{
"status":"success"
}
},
"activities":[
{
"id":"c4f238e3-7334-4933-8b56-64d7ea43ea54",
"name":"Activation Batch XdmProcessor Activity",
"updatedAtUTC":0,
"durationSummary":{
"startedAtUTC":1646652235124,
"completedAtUTC":1646652255157
},
"latencySummary":{
},
"sizeSummary":{
"inputBytes":122,
"outputBytes":122
},
"recordSummary":{
"inputRecordCount":1,
"outputRecordCount":1,
"createdRecordCount":1,
"skippedRecordCount":0
},
"fileSummary":{
"inputFileCount":1,
"outputFileCount":1
},
"statusSummary":{
"status":"success",
"extensions":{
"incremental.batchId":"",
"snapshot.batchId":"",
"snapshot.datasetId":"",
"incremental.datasetId":""
}
},
"sourceInfo":null,
"targetInfo":null
},
{
"id":"51d82b36-6b8f-11eb-9439-0242ac130002",
"name":"Activation Batch Publisher Activity",
"updatedAtUTC":0,
"durationSummary":{
"startedAtUTC":1646652270326,
"completedAtUTC":1646652270439
},
"latencySummary":{
},
"sizeSummary":{
"outputBytes":122
},
"recordSummary":{
"inputRecordCount":1,
"outputRecordCount":1,
"createdRecordCount":1,
"skippedRecordCount":0
},
"fileSummary":{
"outputFileCount":1
},
"statusSummary":{
"status":"success",
"extensions":{
}
},
"sourceInfo":null,
"targetInfo":null
}
],
"predecessors":null
}
],
"_links":{
}
}
Los extremos de la API de Destination SDK siguen los principios generales del mensaje de error de la API de Experience Platform. Consulte Códigos de estado de API y errores de encabezado de solicitud en la guía de solución de problemas de Platform.
Después de leer este documento, ahora sabe cómo probar la configuración de destino basada en archivos y ver los detalles completos de los resultados de activación.
Si está creando un destino público, ahora puede envíe su configuración de destino al Adobe para su revisión.