Aan de slag met de Real-Time Customer Profile API

Laatst bijgewerkt: 16 juli 2024
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

Gebruikend Echte - de eindpunten van het Profiel van de Klant van tijdProfiel, kunt u basisbewerkingen van CRUD tegen de gegevens van het Profiel uitvoeren, zoals het vormen van gegevens verwerkte attributen, de toegang tot entiteiten, het uitvoeren van de gegevens van het Profiel, en het schrappen van onnodige datasets of partijen.

Voor het gebruik van de handleiding voor ontwikkelaars is een goed begrip vereist van de verschillende Adobe Experience Platform-services die betrokken zijn bij het werken met Profile -gegevens. Voordat u begint te werken met de Real-Time Customer Profile API, raadpleegt u de documentatie voor de volgende services:

  • Real-Time Customer Profile: biedt een uniform, klantprofiel in real-time op basis van geaggregeerde gegevens van meerdere bronnen.
  • Adobe Experience Platform Identity Service: verbeter een beter beeld van uw klant en zijn gedrag door identiteiten over apparaten en systemen te overbruggen.
  • Adobe Experience Platform Segmentation Service: Hiermee kunt u een publiek maken op basis van realtime gegevens in het klantprofiel.
  • Experience Data Model (XDM): Het gestandaardiseerde framework waarmee Platform gegevens voor klantervaring organiseert.
  • Sandboxes: Experience Platform biedt virtuele sandboxen die één Platform -instantie in afzonderlijke virtuele omgevingen verdelen om toepassingen voor digitale ervaringen te ontwikkelen en te ontwikkelen.

De volgende secties bevatten aanvullende informatie die u moet weten om aanroepen van Profile API-eindpunten te kunnen uitvoeren.

API-voorbeeldaanroepen lezen

De API-documentatie van Real-Time Customer Profile biedt voorbeeld-API-aanroepen om aan te tonen hoe aanvragen op de juiste manier kunnen worden opgemaakt. Dit zijn paden, vereiste kopteksten en correct opgemaakte ladingen voor aanvragen. Voorbeeld-JSON die wordt geretourneerd in API-reacties, wordt ook verschaft. Voor informatie over de overeenkomsten die in documentatie voor steekproef API vraag worden gebruikt, zie de sectie op hoe te om voorbeeld API vraagin de Experience Platform het oplossen van problemengids te lezen.

Vereiste koppen

De API documentatie vereist u ook om het authentificatieleerprogrammate voltooien om vraag aan Platform eindpunten met succes te maken. Als u de zelfstudie over verificatie voltooit, krijgt u de waarden voor elk van de vereiste headers in API-aanroepen van Experience Platform , zoals hieronder wordt getoond:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

Alle bronnen in Experience Platform zijn geïsoleerd naar specifieke virtuele sandboxen. Voor aanvragen van Platform API's is een header vereist die de naam aangeeft van de sandbox waarin de bewerking plaatsvindt:

  • x-sandbox-name: {SANDBOX_NAME}

Voor meer informatie over zandbakken in Platform, zie de documentatie van het zandbakoverzicht.

Alle verzoeken met een lading in het verzoeklichaam (zoals POST, PUT, en de vraag van PATCH) moeten een Content-Type kopbal omvatten. De toegelaten waarden specifiek voor elke vraag worden verstrekt in de vraagparameters.