Ophaalprofielen
- Onderwerpen:
- APIs/SDKs
Gemaakt voor:
- Ontwikkelaar
A Target profiel kan op drie manieren worden opgehaald: met een Experience Cloud Visitor ID (ECID), tntid of thirdPartyId.
Een Experience Cloud Visitor ID (ECID)
U kunt een profiel ophalen op basis van de ECID. De HTTP-methode moet GET zijn.
De URL ziet er als volgt uit:
https://<clientCode>.tt.omtrdc.net/rest/v1/profiles/marketingCloudVisitorId/<ECID>?client=<clientCode>
Vervangen <clientCode> met uw Target Client Code en <ECID> met uw Experience Cloud Visitor ID (Marketing Cloud Visitor ID).
Een titer gebruiken
Target wijst automatisch een tntid voor elk verzoek.
In het volgende voorbeeld wordt de aanvraagindeling getoond om een profiel op te halen met een tntid:
https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/your-tnt-id?client=<your-client-code>
Vervangen <your-client-code> en your-tnt-id en een verzoek om GET in werking te stellen. Hier is een vraag van de het halen van het voorbeeldprofiel gebruikend een tntid:
https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/111492025094307-353046?client=<your-client-code>
Een derdePartyId gebruiken
Adobe Target profielen kunnen worden aangevuld met uw eigen id (bijvoorbeeld: CRM-id, uuid, lidmaatschapsnummer enzovoort).
Zie Profielen bijwerken om te leren hoe u een thirdPartyId naar uw profiel.
In het volgende voorbeeld wordt de aanvraagindeling getoond om een profiel op te halen met een thirdPartyId:
https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/thirdPartyId/your-thirdpartyid?client=<your-client-code>
Vervangen <your-client-code> en your-thirdpartyid en een verzoek om GET in werking te stellen. Hier is een vraag van de het halen van het voorbeeldprofiel gebruikend een thirdpartyid:
https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/thirdPartyId/a1-mbox3rdPartyId?client=<your-client-code>
Wanneer deze vraag wordt gemaakt, Target pogingen om het profiel eerst te vinden in de cluster die in de randaanvraag is vermeld, of waar het profiel zich bevindt en de inhoud te retourneren. De inhoud van het profiel wordt geretourneerd in de JSON-indeling.
Verificatie
De Target Profile API kan worden beveiligd door verificatie in te schakelen vanaf de Target UI zoals hier beschreven. Nadat de verificatie is ingeschakeld, moeten voor alle API-profielaanvragen het token voor profielverificatie is ingesteld in de aanvraagheaders. Het token zelf kan worden gegenereerd met het Target UI of het gebruiken van de stappen hierboven in Token voor profielverificatie sectie.
Metering
Deze vraag telt niet op uw mbox vraag.
Foutafhandeling
In geval van een oproep tot /thirdPartyId met een ongeldige of een verlopen thirdPartyId gespecificeerd:
{"status" : 404, "message" : "No profile found for client <client_code> with third party id=<third_party_id>"}
Als het profiel niet kan worden gevonden of is verlopen:
{"status" : 404, "message" : "No profile found for client <client_code> with mboxPC=<mbox_pc>"}