Probar la configuración de destino

Información general

As part of Destination SDK, Adobe provides developer tools to assist you in configuring and testing your destination. Esta página describe cómo probar la configuración de destino. For information on how to create a message transformation template, read Create and test a message transformation template.

Hasta compruebe si el destino está configurado correctamente y para verificar la integridad de los flujos de datos en el destino configurado, use el Herramienta de prueba de destino. Con esta herramienta, puede probar la configuración de destino enviando mensajes al extremo de la API de REST.

A continuación se ilustra cómo la prueba de destino se ajusta al flujo de trabajo de configuración de destino en Destination SDK:

Graphic of where the destination testing step fits into the destination configuration workflow

Destination testing tool - Purpose and prerequisites

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 variable configuración del servidor.

Antes de utilizar la herramienta, asegúrese de:

Con esta herramienta, después de haber configurado el destino, puede:

  • Pruebe si el destino está configurado correctamente;
  • Compruebe la integridad de los flujos de datos al destino configurado.

Utilización

NOTA

For complete API reference documentation, read Destination testing API operations.

Puede realizar llamadas al extremo de la API de prueba de destino con o sin añadir perfiles en la solicitud.

If you don't add any profiles on the request, Adobe will generate those internally for you and add them to the request. Si desea generar perfiles para utilizarlos 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. Note that the source schema is the union schema of the sandbox that you are using.

La respuesta contiene el resultado del procesamiento de la solicitud de destino. La solicitud incluye tres secciones principales:

NOTA

Adobe puede generar varios pares de solicitud y respuesta. Por ejemplo, si envía 10 perfiles a un destino que tiene un maxUsersPerRequest de 7, habrá una solicitud con 7 perfiles y otra solicitud con 3 perfiles.

Solicitud de ejemplo 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 ejemplo 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 ejemplo

Tenga en cuenta que el contenido de la variable results.httpCalls es específico de su 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 variable API de publicación de destino para enviar la configuración a Adobe para su revisión.

En esta página