Cette destination est disponible uniquement pour les clients d’Adobe Real-Time Customer Data Platform Ultimate.
La destination de l’API HTTP est une destination en flux continu Adobe Experience Platform qui vous aide à envoyer des données de profil à des points d’entrée HTTP tiers.
Pour envoyer des données de profil à des points d’entrée HTTP, vous devez d’abord vous connecter à la destination dans Adobe Experience Platform.
La destination de l’API HTTP vous permet d’exporter des données de profil XDM et des segments d’audience vers des points d’entrée HTTP génériques. Vous pouvez y lancer vos propres analyses ou effectuer toute autre opération dont vous pourriez avoir besoin sur les données de profil exportées hors d’Experience Platform.
Les points d’entrée HTTP peuvent être les systèmes des client(e)s ou des solutions tierces.
Reportez-vous au tableau ci-dessous pour plus d’informations sur le type et la fréquence d’exportation des destinations.
Élément | Type | Notes |
---|---|---|
Type d’exportation | Basé sur les profils | Vous exportez tous les membres d’un segment, ainsi que les champs de schéma souhaités (par exemple : adresse e-mail, numéro de téléphone, nom), tels qu’ils ont été choisis dans l’écran de mappage du workflow d’activation de la destination. |
Fréquence des exportations | Diffusion en continu | Les destinations de diffusion en continu sont des connexions basées sur l’API « toujours actives ». Dès qu’un profil est mis à jour dans Experience Platform en fonction de l’évaluation des segments, le connecteur envoie la mise à jour en aval vers la plateforme de destination. En savoir plus sur les destinations de diffusion en continu. |
Pour utiliser la destination d’API HTTP pour exporter des données en dehors d’Experience Platform, vous devez respecter les conditions préalables suivantes :
Vous pouvez également utiliser Adobe Experience Platform Destination SDK pour configurer une intégration et envoyer des données de profil Experience Platform à un point d’entrée HTTP.
Pour répondre aux exigences de sécurité et de conformité des clients, Experience Platform fournit une liste des adresses IP statiques que vous pouvez inscrire sur la liste autorisée pour la destination de l’API HTTP. Reportez-vous à la liste autorisée d’adresses IP pour les destinations en flux continu pour la liste complète des adresses IP à autoriser.
La destination API HTTP prend en charge plusieurs types d’authentification à votre point d’entrée HTTP :
curl --location --request POST '<YOUR_API_ENDPOINT>' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=<CLIENT_ID>' \
--data-urlencode 'client_secret=<CLIENT_SECRET>'
curl --location --request POST 'https://some-api.com/token' \
--header 'Authorization: Basic base64(clientId:clientSecret)' \
--header 'Content-type: application/x-www-form-urlencoded; charset=UTF-8' \
--data-urlencode 'grant_type=client_credentials'
Pour vous connecter à la destination, vous devez disposer de l’autorisation de contrôle d’accès Gérer les destinations. Lisez la présentation du contrôle d’accès ou contactez votre administrateur de produit pour obtenir les autorisations requises.
Pour vous connecter à cette destination, procédez comme décrit dans le tutoriel sur la configuration des destinations. Lors de la connexion à cette destination, vous devez fournir les informations suivantes :
Si vous sélectionnez le type d’authentification Jeton porteur pour vous connecter à votre point d’entrée HTTP, saisissez les champs ci-dessous et sélectionnez Se connecter à la destination :
Si vous sélectionnez le type d’authentification Aucune pour vous connecter à votre point d’entrée HTTP :
Lorsque vous sélectionnez cette ouverture d’authentification, il vous suffit de sélectionner Se connecter à la destination et la connexion à votre point d’entrée est établie.
Si vous sélectionnez le type d’authentification Mot de passe OAuth 2 pour vous connecter à votre point d’entrée HTTP, saisissez les champs ci-dessous et sélectionnez Se connecter à la destination :
Si vous sélectionnez le type d’authentification Informations d’identification du client OAuth 2 pour vous connecter à votre point d’entrée HTTP, saisissez les champs ci-dessous et sélectionnez Se connecter à la destination :
Authorization
après avoir été codés en base64 et envoyés à votre destination. Pour un exemple, consultez la section Types d’authentification pris en charge.Pour configurer les détails de la destination, renseignez les champs obligatoires et facultatifs ci-dessous. Un astérisque situé en regard d’un champ de l’interface utilisateur indique que le champ est obligatoire.
header1:value1,header2:value2,...headerN:valueN
.parameter1=value¶meter2=value
.Vous pouvez activer les alertes pour recevoir des notifications sur le statut de votre flux de données vers votre destination. Sélectionnez une alerte dans la liste et abonnez-vous à des notifications concernant le statut de votre flux de données. Pour plus d’informations sur les alertes, consultez le guide sur l’abonnement aux alertes des destinations dans l’interface utilisateur.
Lorsque vous avez terminé de renseigner les détails sur votre connexion de destination, sélectionnez Suivant.
Pour activer les données, vous avez besoin des autorisations de contrôle d’accès pour les fonctions Gérer les destinations, Activer les destinations, Afficher les profils, et Afficher les segments. Lisez la présentation du contrôle d’accès ou contactez votre administrateur de produit pour obtenir les autorisations requises.
Voir Activer des données d’audience vers des destinations d’exportation de profils en flux continu pour obtenir des instructions sur l’activation des segments d’audience vers cette destination.
Lors de l’étape Sélectionner des attributs, Adobe recommande de sélectionner un identifiant unique dans votre schéma d’union. Sélectionnez l’identifiant unique et tout autre champ XDM que vous souhaitez exporter vers la destination.
Experience Platform optimise le comportement d’exportation de profils vers votre destination d’API HTTP afin d’exporter les données vers votre point d’entrée API uniquement quand des mises à jour importantes d’un profil se sont produites à la suite d’une qualification de segment ou d’autres événements significatifs. Les profils sont exportés vers votre destination dans les situations suivantes :
Dans tous les cas décrits ci-dessus, seuls les profils pour lesquels des mises à jour pertinentes se sont produites sont exportés vers votre destination. Par exemple, si un segment mappé au flux de destination comporte cent membres et que cinq nouveaux profils sont qualifiés pour ce segment, l’exportation vers votre destination est incrémentielle et inclut uniquement les cinq nouveaux profils.
Remarque : tous les attributs mappés sont exportés pour un profil, quel que soit l’emplacement des modifications. Ainsi, dans l’exemple ci-dessus, tous les attributs mappés pour ces cinq nouveaux profils seront exportés même si les attributs eux-mêmes restent inchangés.
Concernant les données exportées pour un profil donné, il est important de comprendre les deux concepts différents entre ce qui détermine l’exportation de données vers votre destination d’API HTTP et les données incluses dans l’exportation.
Ce qui détermine une exportation de destination | Éléments inclus dans l’exportation de destination |
---|---|
|
|
Prenons l’exemple d’un flux de données vers une destination HTTP dans lequel trois segments sont sélectionnés et quatre attributs sont mappés à la destination.
Une exportation de profil vers la destination peut être déterminée par un profil éligible ou sortant de l’un des trois segments mappés. Toutefois, dans l’exportation des données, dans la variable segmentMembership
(voir Données exportées ci-dessous), d’autres segments non mappés peuvent apparaître si ce profil particulier en est membre et s’ils partagent la même stratégie de fusion que le segment qui a déclenché l’exportation. Si un profil est admissible pour la variable Client avec des voitures DeLorean , mais est également membre de la fonction "Retour vers l'avenir" film et Fans de science-fiction , ces deux autres segments seront également présents dans la variable segmentMembership
de l’exportation des données, même si elles ne sont pas mappées dans le flux de données, si elles partagent la même stratégie de fusion avec l’objet Client avec des voitures DeLorean segment.
Du point de vue des attributs de profil, toute modification apportée aux quatre attributs mappés ci-dessus déterminera une exportation de destination et chacun de ces quatre attributs mappés et présents sur le profil sera présent dans l’exportation des données.
Quand vous ajoutez un nouveau segment à une destination existante, ou si vous créez une nouvelle destination à laquelle vous mappez des segments, Experience Platform exporte les données historiques de qualification de segment vers la destination. Les profils qualifiés pour le segment avant que celui-ci soit ajouté à la destination sont exportés vers la destination sous une heure environ.
Les données Experience Platform exportées arrivent dans votre destination HTTP au format JSON. Par exemple, l’exportation ci-dessous contient un profil qualifié pour un certain segment, qui est membre de deux autres segments et qui a quitté un autre segment. L’exportation inclut également le prénom, le nom, la date de naissance et l’adresse e-mail personnelle de l’attribut de profil. Les identités de ce profil sont ECID et e-mail.
{
"person": {
"birthDate": "YYYY-MM-DD",
"name": {
"firstName": "John",
"lastName": "Doe"
}
},
"personalEmail": {
"address": "john.doe@acme.com"
},
"segmentMembership": {
"ups":{
"7841ba61-23c1-4bb3-a495-00d3g5fe1e93":{
"lastQualificationTime":"2022-01-11T21:24:39Z",
"status":"exited"
},
"59bd2fkd-3c48-4b18-bf56-4f5c5e6967ae":{
"lastQualificationTime":"2022-01-02T23:37:33Z",
"status":"realized"
},
"947c1c46-008d-40b0-92ec-3af86eaf41c1":{
"lastQualificationTime":"2021-08-25T23:37:33Z",
"status":"realized"
},
"5114d758-ce71-43ba-b53e-e2a91d67b67f":{
"lastQualificationTime":"2022-01-11T23:37:33Z",
"status":"realized"
}
}
},
"identityMap": {
"ecid": [
{
"id": "14575006536349286404619648085736425115"
},
{
"id": "66478888669296734530114754794777368480"
}
],
"email_lc_sha256": [
{
"id": "655332b5fa2aea4498bf7a290cff017cb4"
},
{
"id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
}
]
}
}
Vous trouverez ci-dessous d’autres exemples de données exportées, en fonction des paramètres de l’interface utilisateur que vous sélectionnez dans le flux de connexion à la destination pour les options Inclure les noms de segment et Inclure la date et l’heure de segment :
segmentMembership
"segmentMembership": {
"ups": {
"5b998cb9-9488-4ec3-8d95-fa8338ced490": {
"lastQualificationTime": "2019-04-15T02:41:50+0000",
"status": "realized",
"createdAt": 1648553325000,
"updatedAt": 1648553330000,
"mappingCreatedAt": 1649856570000,
"mappingUpdatedAt": 1649856570000,
"name": "First name equals John"
}
}
}
segmentMembership
"segmentMembership": {
"ups": {
"5b998cb9-9488-4ec3-8d95-fa8338ced490": {
"lastQualificationTime": "2019-04-15T02:41:50+0000",
"status": "realized",
"createdAt": 1648553325000,
"updatedAt": 1648553330000,
"mappingCreatedAt": 1649856570000,
"mappingUpdatedAt": 1649856570000,
}
}
}
Dans 95 % des cas, Experience Platform tente d’offrir une latence de débit inférieure à 10 minutes pour les messages envoyés avec succès, avec un taux de moins de 10 000 demandes par seconde pour chaque flux de données vers une destination HTTP.
En cas d’échec des requêtes vers la destination API HTTP, Experience Platform stocke les requêtes ayant échoué et tente à deux reprises d’envoyer les requêtes à votre point d’entrée.