Recuperación de perfiles
- Temas:
- APIs/SDKs
Creado para:
- Desarrollador
Un perfil Target se puede obtener de tres maneras: usando un Experience Cloud Visitor ID (ECID), tntid o thirdPartyId.
Usando un Experience Cloud Visitor ID (ECID)
Puede obtener un perfil basado en ECID. El método HTTP debe ser GET.
La dirección URL es similar al siguiente ejemplo:
https://<clientCode>.tt.omtrdc.net/rest/v1/profiles/marketingCloudVisitorId/<ECID>?client=<clientCode>
Reemplazar <clientCode> por Target Client Code y <ECID> por Experience Cloud Visitor ID (Marketing Cloud Visitor ID).
Uso de un tntid
Target asigna automáticamente un(a) tntid para cada solicitud.
El ejemplo siguiente muestra el formato de solicitud para recuperar un perfil mediante un tntid:
https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/your-tnt-id?client=<your-client-code>
Reemplace <your-client-code> y your-tnt-id y active una solicitud de GET. Esta es una llamada de captura de perfil de ejemplo que usa un tntid:
https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/111492025094307-353046?client=<your-client-code>
Uso de thirdPartyId
Adobe Target perfiles se pueden aumentar con su propio identificador (por ejemplo: ID de CRM, uuid, número de pertenencia, etc.).
Consulta Actualizar perfiles para saber cómo adjuntar un(a) thirdPartyId a tu perfil.
El ejemplo siguiente muestra el formato de solicitud para recuperar un perfil mediante un thirdPartyId:
https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/thirdPartyId/your-thirdpartyid?client=<your-client-code>
Reemplace <your-client-code> y your-thirdpartyid y active una solicitud de GET. Esta es una llamada de captura de perfil de ejemplo que usa un thirdpartyid:
https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/thirdPartyId/a1-mbox3rdPartyId?client=<your-client-code>
Cuando se realiza esta llamada, Target intenta ubicar el perfil primero en el clúster indicado en la solicitud de Edge, o en cualquier lugar donde se encuentre el perfil y devuelve el contenido. El contenido del perfil se devuelve en formato JSON.
Autenticación
Target Profile API se puede proteger activando la autenticación desde la interfaz de usuario de Target como se describe aquí. Una vez activada la autenticación, todas las solicitudes de API de perfil deben tener el token de autenticación de perfil establecido en los encabezados de solicitud. El token en sí se puede generar usando la interfaz de usuario Target o los pasos explicados anteriormente en la sección Token de autenticación de perfil.
Medición
Estas llamadas no se contabilizan en sus llamadas de mbox.
Control de errores
En el caso de una llamada a /thirdPartyId con un thirdPartyId no válido o caducado especificado:
{"status" : 404, "message" : "No profile found for client <client_code> with third party id=<third_party_id>"}
Si el perfil no se encuentra o ha caducado:
{"status" : 404, "message" : "No profile found for client <client_code> with mboxPC=<mbox_pc>"}