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

Dernière mise à jour : 4 avril 2025
  • Rubriques :

Créé pour :

  • Développeur

À l’aide des points d’entrée de l’API Real-Time Customer Profile, vous pouvez effectuer des opérations CRUD de base sur les données Profile, comme configurer des attributs calculés, accéder à des entités, exporter des données Profile et supprimer des jeux de données ou des lots inutiles.

L’utilisation du guide du développeur nécessite une compréhension pratique des différents services Adobe Experience Platform impliqués dans l’utilisation des données Profile. 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 en temps réel unifié basé sur des données agrégées issues de plusieurs sources.
  • Adobe Experience Platform Identity Service : obtenez une meilleure compréhension de vos clients et de leurs comportements en rapprochant des identités entre appareils et systèmes.
  • Adobe Experience Platform Segmentation Service : permet de créer des audiences à partir des données du profil client en temps réel.
  • Experience Data Model (XDM) : framework normalisé selon lequel Experience Platform organise les données de l’expérience client.
  • Sandboxes : Experience Platform fournit des sandbox virtuels qui divisent une instance Experience Platform unique en environnements virtuels distincts pour favoriser le développement et l’évolution d’applications d’expérience digitale.

Les sections suivantes apportent des informations supplémentaires dont vous aurez besoin afin de passer avec succès des appels vers des points d’entrée d’API Profile.

Lecture d’exemples d’appels API

La documentation de l’API Real-Time Customer Profile fournit des exemples d’appels d’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 d’entrée Experience 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 sandbox virtuels spécifiques. Les requêtes Experience Platform API nécessitent un en-tête spécifiant le nom du sandbox dans lequel l’opération aura lieu :

  • x-sandbox-name: {SANDBOX_NAME}

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

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.