Resumen de API de prueba de destino de streaming
Como parte de Destination SDK, Adobe proporciona herramientas para desarrolladores que le ayudarán a configurar y probar su destino. Esta página describe cómo probar la configuración de destino. Para obtener información sobre cómo crear una plantilla de transformación de mensajes, lea Crear y probar una plantilla de transformación de mensajes.
Para comprobar si el destino está configurado correctamente y comprobar la integridad de los flujos de datos al destino configurado, use la herramienta de prueba de destino. Con esta herramienta, puede probar la configuración de destino enviando mensajes al punto final de la API de REST.
A continuación se ilustra cómo encaja la prueba de destino en el flujo de trabajo de configuración de destino en Destination SDK:
Herramienta de prueba de destino: propósito y requisitos previos destination-testing-tool
Utilice la herramienta de prueba de destino para probar la configuración de destino enviando mensajes al extremo del socio que ha proporcionado en la configuración del servidor.
Antes de usar la herramienta, asegúrese de lo siguiente:
- Configure su destino siguiendo los pasos descritos en flujo de trabajo de configuración de destino y
- Establezca una conexión con su destino, tal como se detalla en Cómo obtener el identificador de instancia de destino.
Con esta herramienta, después de haber configurado el destino, puede:
- Comprobar si el destino está configurado correctamente;
- Compruebe la integridad de los flujos de datos al destino configurado.
Cómo usar how-to-use
Puede realizar llamadas al extremo de la API de prueba de destino con o sin agregar perfiles en la solicitud.
Si no agrega ningún perfil a la solicitud, Adobe los generará internamente para usted y los agregará a la solicitud. Si desea generar perfiles para usarlos en esta solicitud, consulte la Referencia de API de generación de perfiles de muestra. Debe generar perfiles basados en el esquema XDM de origen, como se muestra en la referencia de API. Tenga en cuenta que el esquema de origen es el esquema de unión de la zona protegida que está utilizando.
La respuesta contiene el resultado del procesamiento de la solicitud de destino. La solicitud incluye tres secciones principales:
- La solicitud generada por el Adobe para el destino.
- La respuesta recibida desde su destino.
- La lista de perfiles enviados en la solicitud, ya sean agregados por usted en la solicitud o generados por el Adobe si el cuerpo de la solicitud de prueba de destino estaba vacío.
maxUsersPerRequest de 7, habrá una solicitud con 7 perfiles y otra solicitud con 3 perfiles.Solicitud de muestra con parámetro de perfiles en el cuerpo
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"
}
}
}
]
}'
Solicitud de muestra sin parámetro de perfiles en el cuerpo
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 ''
Respuesta de muestra
Tenga en cuenta que el contenido del parámetro results.httpCalls es específico de la API de REST.
{
"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"
}
}
}
]
}
Para obtener descripciones de los parámetros de solicitud y respuesta, consulte Operaciones de API de prueba de destino.
Pasos siguientes
Después de probar el destino y confirmar que está configurado correctamente, use la API de publicación de destino para enviar la configuración al Adobe y revisarla.