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:

Gráfico de onde a etapa de teste de destino se encaixa no fluxo de trabalho de configuração de destino

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:

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

OBSERVAÇÃO

Para obter a documentação completa de referência da API, leia Operações da API de teste de destino.

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:

OBSERVAÇÃO

O Adobe pode gerar vários pares de solicitação e resposta. Por exemplo, se você enviar 10 perfis para um destino que tenha um maxUsersPerRequest valor de 7, haverá uma solicitação com 7 perfis e outra solicitação com 3 perfis.

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

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: {ORG_ID}' \
--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.

Nesta página