Testar a configuração de destino

Visão geral

Como parte do Destination SDK, o Adobe fornece ferramentas de desenvolvedor para ajudá-lo a configurar e testar seu destino. Esta página descreve como testar a configuração de destino. Para obter informações sobre como criar um modelo de transformação de mensagem, leia Criar e testar um modelo de transformação de mensagem.

Para teste se o destino está configurado corretamente e para verificar a integridade dos fluxos de dados para o destino configurado, use o Ferramenta de teste de destino. Com essa ferramenta, você pode testar a configuração de destino enviando mensagens para o terminal REST API.

A ilustração abaixo mostra como o teste do seu destino se encaixa na variável fluxo de trabalho de configuração de destino no Destination SDK:

Ferramenta de teste de destino - Finalidade e pré-requisitos

Use a ferramenta de teste de destino para testar a configuração de destino, enviando mensagens para o terminal do parceiro fornecido na configuração do servidor.

Antes de usar a ferramenta, verifique se:

• Configure seu destino seguindo as etapas descritas na fluxo de trabalho de configuração de destino e
• Estabeleça uma conexão com seu destino, conforme detalhado em Como obter a ID da instância de destino.

Com essa ferramenta, depois de ter configurado seu destino, você pode:

• Teste se o destino está configurado corretamente;
• Verifique a integridade dos fluxos de dados para o destino configurado.

Como usar

Você pode fazer chamadas para o endpoint da API de teste de destino com ou sem adicionar perfis na solicitação.

Se você não adicionar perfis na solicitação, o Adobe gerará esses perfis internamente para você e os adicionará à solicitação. Se desejar gerar perfis para usar nessa solicitação, consulte Referência da API de geração de perfil de amostra. Você precisa gerar perfis com base no esquema XDM de origem, conforme mostrado no Referência da API. Observe que o schema de origem é o schema de união da sandbox que você está usando.

A resposta contém o resultado do processamento da solicitação de destino. A solicitação inclui três seções principais:

• A solicitação gerada pelo Adobe para o destino.
• A resposta recebida do seu destino.
• A lista de perfis enviados na solicitação, se os perfis foram adicionado por você na solicitaçãoou gerada por Adobe if o corpo da solicitação de teste de destino estava vazio.

Solicitação de exemplo com parâmetro de perfis no corpo

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: {IMS_ORG}' \
--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"
            }
         }
      }
   ]
}'

Solicitação de exemplo sem parâmetro de perfis no corpo

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: {IMS_ORG}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--data-raw ''

Resposta de exemplo

Observe que o conteúdo da variável results.httpCalls é específico para sua 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"
            }
         }
      }
   ]
}

Para obter descrições dos parâmetros de solicitação e resposta, consulte Operações da API de teste de destino.

Próximas etapas

Depois de testar seu destino e confirmar que ele está configurado corretamente, use a API de publicação de destino para enviar sua configuração ao Adobe para revisão.