Recuperare i profili
- Argomenti:
- APIs/SDKs
Creato per:
- Sviluppatore
Un profilo Target può essere recuperato in tre modi: utilizzando un Experience Cloud Visitor ID (ECID), tntid o thirdPartyId.
Utilizzo di un Experience Cloud Visitor ID (ECID)
È possibile recuperare un profilo basato su ECID. Il metodo HTTP deve essere GET.
L’URL si presenta come nell’esempio seguente:
https://<clientCode>.tt.omtrdc.net/rest/v1/profiles/marketingCloudVisitorId/<ECID>?client=<clientCode>
Sostituisci <clientCode> con Target Client Code e <ECID> con Experience Cloud Visitor ID (Marketing Cloud Visitor ID).
Utilizzo di un tntid
Target assegna automaticamente un tntid per ogni richiesta.
L'esempio seguente mostra il formato della richiesta per recuperare un profilo utilizzando un tntid:
https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/your-tnt-id?client=<your-client-code>
Sostituisci <your-client-code> e your-tnt-id e attiva una richiesta GET. Di seguito è riportato un esempio di chiamata di recupero del profilo che utilizza tntid:
https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/111492025094307-353046?client=<your-client-code>
Utilizzo di un thirdPartyId
È possibile aumentare i profili Adobe Target con il proprio identificatore (ad esempio: ID CRM, uuid, numero di iscrizione e così via).
Consulta Aggiornare i profili per scoprire come allegare un thirdPartyId al tuo profilo.
L'esempio seguente mostra il formato della richiesta per recuperare un profilo utilizzando un thirdPartyId:
https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/thirdPartyId/your-thirdpartyid?client=<your-client-code>
Sostituisci <your-client-code> e your-thirdpartyid e attiva una richiesta GET. Di seguito è riportato un esempio di chiamata di recupero del profilo che utilizza thirdpartyid:
https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/thirdPartyId/a1-mbox3rdPartyId?client=<your-client-code>
Quando viene effettuata questa chiamata, Target tenta di individuare prima il profilo nel cluster indicato nella richiesta Edge o dove si trova il profilo e restituisce il contenuto. I contenuti del profilo vengono restituiti in formato JSON.
Autenticazione
È possibile proteggere Target Profile API attivando l'autenticazione dall'interfaccia utente Target come descritto qui. Una volta attivata l’autenticazione, tutte le richieste API di profilo devono avere il token di autenticazione profilo impostato nelle intestazioni della richiesta. Il token può essere generato utilizzando l'interfaccia utente Target o i passaggi descritti in precedenza nella sezione Token di autenticazione profilo.
Misurazione
Queste chiamate non vengono conteggiate per le chiamate mbox.
Gestione degli errori
Nel caso di una chiamata a /thirdPartyId con thirdPartyId specificato non valido o scaduto:
{"status" : 404, "message" : "No profile found for client <client_code> with third party id=<third_party_id>"}
Se il profilo non può essere individuato o è scaduto:
{"status" : 404, "message" : "No profile found for client <client_code> with mboxPC=<mbox_pc>"}