Récupération de profils

Un profil Target peut être récupéré de trois façons : en utilisant un Experience Cloud Visitor ID (ECID), un tntid ou un thirdPartyId.

Utilisation d’un Experience Cloud Visitor ID (ECID)

Vous pouvez récupérer un profil en fonction de ECID. La méthode HTTP doit être GET.

L’URL ressemble à l’exemple suivant :

https://<clientCode>.tt.omtrdc.net/rest/v1/profiles/marketingCloudVisitorId/<ECID>?client=<clientCode>

Remplacez <clientCode> par vos Target Client Code et <ECID> avec vos Experience Cloud Visitor ID (Marketing Cloud Visitor ID).

Utilisation d’un tntid

Target affecte automatiquement un tntid à chaque demande.

L’exemple suivant illustre le format de requête pour récupérer un profil à l’aide d’un tntid :

https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/your-tnt-id?client=<your-client-code>

Remplacez <your-client-code> et your-tnt-id et déclenchez une demande de GET. Voici un exemple d’appel de récupération de profil utilisant un tntid :

https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/111492025094307-353046?client=<your-client-code>

Utilisation d’un thirdPartyId

Les profils Adobe Target peuvent être augmentés avec votre propre identifiant (par exemple : identifiant CRM, uuid, numéro de membre, etc.).

Voir Mise à jour de profils pour savoir comment joindre un thirdPartyId à votre profil.

L’exemple suivant illustre le format de requête pour récupérer un profil à l’aide d’un thirdPartyId :

https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/thirdPartyId/your-thirdpartyid?client=<your-client-code>

Remplacez <your-client-code> et your-thirdpartyid et déclenchez une demande de GET. Voici un exemple d’appel de récupération de profil utilisant un thirdpartyid :

https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/thirdPartyId/a1-mbox3rdPartyId?client=<your-client-code>

Lorsque cet appel est effectué, Target tente de localiser le profil en premier dans la grappe indiquée dans la requête Edge, ou partout où le profil est situé et de renvoyer le contenu. Le contenu du profil est renvoyé au format JSON.

Authentification

Target Profile API peut être sécurisé en activant l’authentification à partir de l’interface utilisateur Target, comme décrit ici. Une fois l’authentification activée, le jeton d’authentification de profil doit être défini dans les en-têtes de requête pour toutes les requêtes d’API de profil. Le jeton lui-même peut être généré à l’aide de l’interface utilisateur Target ou en suivant les étapes décrites ci-dessus dans la section Jeton d’authentification de profil .

Mesures

Ces appels ne sont pas pris en compte dans vos appels de mbox.

Gestion des erreurs

Dans le cas d'un appel à /thirdPartyId avec un thirdPartyId non valide ou un expiré spécifié :

{"status" : 404, "message" : "No profile found for client <client_code> with third party id=<third_party_id>"}

Si le profil ne peut pas être localisé ou a expiré :

{"status" : 404, "message" : "No profile found for client <client_code> with mboxPC=<mbox_pc>"}