Panoramica dell’API di test della destinazione di streaming
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:
Strumento di test della destinazione: scopo e prerequisiti destination-testing-tool
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:
- Configura la destinazione seguendo i passaggi descritti in flusso di lavoro di configurazione della destinazione e
- Stabilire una connessione alla destinazione, come descritto in Ottenere l’ID dell’istanza di destinazione.
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 how-to-use
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:
- La richiesta generata da Adobe per la destinazione.
- La risposta ricevuta dalla destinazione.
- L’elenco dei profili inviati nella richiesta, specificando se i profili erano aggiunto da te nella richiesta, o generato da Adobe se il corpo della richiesta di test di destinazione era vuoto.
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.