Verifica la configurazione di destinazione

Panoramica

Come parte di Destination SDK, Adobe fornisce strumenti per sviluppatori per aiutarti a configurare e testare la destinazione. Questa pagina descrive come verificare la configurazione di destinazione. Per informazioni su come creare un modello di trasformazione dei messaggi, leggi Creare e testare un modello di trasformazione dei messaggi.

A verifica se la destinazione è configurata correttamente e per verificare l’integrità dei flussi di dati verso la destinazione configurata, utilizza Strumento di test della destinazione. Con questo strumento, puoi verificare la configurazione di destinazione inviando messaggi all’endpoint API REST.

Di seguito è illustrato come il test della destinazione si inserisce nel flusso di lavoro di configurazione della destinazione nella Destination SDK:

Immagine della posizione del passaggio di test di destinazione nel flusso di lavoro di configurazione di destinazione

Strumento di test della destinazione: scopo e prerequisiti

Utilizza lo strumento di test di destinazione per verificare la configurazione di destinazione inviando messaggi all’endpoint partner fornito in configurazione del server.

Prima di utilizzare lo strumento, accertati di:

Con questo strumento, dopo aver configurato la destinazione, puoi:

  • Verifica se la destinazione è configurata correttamente;
  • Verifica l’integrità dei flussi di dati verso la destinazione configurata.

Come usare

NOTA

Per la documentazione di riferimento completa sulle API, leggi Operazioni API di test della destinazione.

Puoi effettuare chiamate all’endpoint API di test di destinazione con o senza l’aggiunta di profili nella richiesta.

Se non aggiungi profili alla richiesta, Adobe li genera internamente e li aggiunge alla richiesta. Se desideri generare profili da utilizzare in questa richiesta, consulta Riferimento API per la generazione di profili di esempio. È necessario generare profili basati sullo schema XDM di origine, come mostrato nella Riferimento API. Lo schema di origine è schema di unione della sandbox in uso.

La risposta contiene il risultato dell’elaborazione della richiesta di destinazione. La richiesta include tre sezioni principali:

NOTA

L’Adobe può generare più coppie di richieste e risposte. Ad esempio, se invii 10 profili a una destinazione con maxUsersPerRequest valore 7, ci saranno una richiesta con 7 profili e un’altra richiesta con 3 profili.

Richiesta di esempio con parametro profiles nel 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"
            }
         }
      }
   ]
}'

Richiesta di esempio senza il parametro dei profili nel 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 ''

Risposta di esempio

Tieni presente che il contenuto di results.httpCalls Il parametro è specifico per l’API 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"
            }
         }
      }
   ]
}

Per le descrizioni dei parametri di richiesta e risposta, consulta Operazioni API di test della destinazione.

Passaggi successivi

Dopo aver testato la destinazione e verificato che sia configurata correttamente, utilizza API di pubblicazione della destinazione per inviare la configurazione all'Adobe per la revisione.

In questa pagina