Profile abrufen

Ein Target kann auf drei Arten abgerufen werden: mithilfe eines Experience Cloud Visitor ID (ECID), tntid oder thirdPartyId.

Verwenden einer Experience Cloud Visitor ID (ECID)

Basierend auf dem ECID können Sie ein Profil abrufen. Die HTTP-Methode muss GET lauten.

Die URL sieht wie im folgenden Beispiel aus:

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

Ersetzen Sie <clientCode> durch Ihre Target Client Code und <ECID> durch Ihre Experience Cloud Visitor ID (Marketing Cloud Visitor ID).

Verwenden einer tntid

Target weist jeder Anfrage automatisch einen tntid zu.

Das folgende Beispiel zeigt das Anfrageformat zum Abrufen eines Profils mithilfe eines tntid:

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

Ersetzen Sie <your-client-code> und your-tnt-id und lösen Sie eine GET-Anfrage aus. Im Folgenden finden Sie ein Beispiel für einen Aufruf zum Abrufen von Profilen mit einem tntid:

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

Verwenden einer ThirdPartyId

Adobe Target können mit Ihrer eigenen Kennung erweitert werden (z. B. CRM-ID, uuid, Mitgliedschaftsnummer usw.).

Unter Aktualisieren von Profilen erfahren Sie, wie Sie ein thirdPartyId an Ihr Profil anhängen können.

Das folgende Beispiel zeigt das Anfrageformat zum Abrufen eines Profils mithilfe eines thirdPartyId:

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

Ersetzen Sie <your-client-code> und your-thirdpartyid und lösen Sie eine GET-Anfrage aus. Im Folgenden finden Sie ein Beispiel für einen Aufruf zum Abrufen von Profilen mit einem thirdpartyid:

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

Wenn dieser Aufruf erfolgt, versucht Target, das Profil zuerst in dem Cluster zu finden, der in der Edge-Anfrage angegeben ist, oder dort, wo sich das Profil befindet, und den Inhalt zurückzugeben. Die Profilinhalte werden im JSON-Format zurückgegeben.

Authentifizierung

Das Target Profile API kann gesichert werden, indem die Authentifizierung über die Target-Benutzeroberfläche aktiviert wird, wie hier beschrieben. Sobald die Authentifizierung aktiviert ist, muss bei allen Profil-API-Anfragen das Profil-Authentifizierungstoken in den Anfragekopfzeilen festgelegt sein. Das Token selbst kann über die Target-Benutzeroberfläche oder mithilfe der oben im Abschnitt "-Authentifizierungstoken“Schritte generiert werden.

Messung

Diese Aufrufe werden nicht für Ihre Mbox-Aufrufe gezählt.

Fehlerbehandlung

Bei einem Aufruf von /thirdPartyId mit einer ungültigen oder abgelaufenen thirdPartyId:

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

Wenn das Profil nicht gefunden werden kann oder abgelaufen ist:

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