Prise en main de l’API Real-time Customer Profile

À l’aide des points de terminaison de l’API Real-time Customer Profile, vous pouvez effectuer des opérations CRUD de base sur les données de profil, telles que la configuration des attributs calculés, l’accès aux entités, l’exportation des données de profil et la suppression des jeux de données ou des lots inutiles.

L’utilisation du guide de développement nécessite une compréhension pratique des différents services Adobe Experience Platform impliqués dans l’utilisation de Profile data. Avant de commencer à utiliser l’API Real-time Customer Profile, consultez la documentation relative aux services suivants :

  • Real-time Customer Profile: Fournit un profil client unifié en temps réel basé sur des données agrégées provenant de plusieurs sources.
  • Adobe Experience Platform Identity Service: Obtenez une meilleure vue de vos clients et de leur comportement en rapprochant des identités entre les appareils et les systèmes.
  • Adobe Experience Platform Segmentation Service : permet de créer des segments d’audience à partir de données Real-time Customer Profile.
  • Experience Data Model (XDM) : framework normalisé selon lequel Platform organise les données de l’expérience client.
  • Sandboxes : Experience Platform fournit des sandbox virtuelles qui divisent une instance Platform unique en environnements virtuels distincts pour favoriser le développement et l’évolution d’applications d’expérience numérique.

Les sections suivantes apportent des informations supplémentaires dont vous aurez besoin pour passer avec succès des appels à Profile Points d’entrée API.

Lecture d’exemples d’appels API

Le Real-time Customer Profile La documentation des API fournit des exemples d’appels API pour démontrer comment formater correctement les requêtes. Il s’agit notamment de chemins d’accès, d’en-têtes requis et de payloads de requêtes correctement formatés. L’exemple JSON renvoyé dans les réponses de l’API est également fourni. Pour plus d’informations sur les conventions utilisées dans la documentation pour les exemples d’appels d’API, voir la section concernant la lecture d’exemples d’appels d’API dans le guide de dépannageExperience Platform.

En-têtes requis

La documentation de l’API exige aussi que vous ayez suivi le tutoriel sur l’authentification pour lancer des appels vers des points de terminaison Platform Le tutoriel sur l’authentification indique les valeurs de chacun des en-têtes requis dans les appels d’API Experience Platform, comme illustré ci-dessous :

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

Dans Experience Platform, toutes les ressources sont isolées dans des environnements de test virtuels spécifiques. Demandes à Platform Les API requièrent un en-tête qui spécifie le nom de l’environnement de test dans lequel l’opération aura lieu :

  • x-sandbox-name: {SANDBOX_NAME}

Pour plus d’informations sur les environnements de test dans Platform, consultez la documentation de présentation des environnements de test.

Toutes les requêtes ayant un payload dans le corps de la requête (notamment les appels POST, PUT et PATCH) doivent comporter un en-tête Content-Type. Les valeurs acceptées propres à chaque appel sont fournies dans les paramètres d’appel.

Étapes suivantes

Pour commencer à effectuer des appels à l’aide de l’API Real-time Customer Profile, sélectionnez l’un des guides de point d’entrée disponibles.

Sur cette page