Recherche d’attributs de profil sur le serveur Edge en temps réel
Adobe Experience Platform utilise le profil client en temps réel comme source unique de vérité pour toutes les données de profil. Pour une récupération rapide des données en temps réel, il utilise des profils Edge, qui sont des profils légers répartis dans Edge Network. Cela permet d’obtenir des cas d’utilisation de personnalisation rapides et en temps réel.
Cas d’utilisation use-cases
Vous trouverez ci-dessous deux cas d’utilisation pour lesquels la recherche de profil Edge peut vous aider.
- Real-Time Personalization : récupérez rapidement les informations de profil du profil Edge pour personnaliser l’expérience d’un utilisateur sur votre site web.
- Service clientèle : récupérez les informations de profil en temps réel lorsqu’un client appelle un agent du centre d’assistance.
Cette page décrit les étapes à suivre pour rechercher des données de profil Edge en temps réel, pour offrir des expériences de personnalisation ou pour informer les règles de prise de décision par le biais d’applications en aval.
Terminologie et conditions préalables prerequisites
Lors de la configuration du cas d’utilisation décrit sur cette page, vous utiliserez les composants Experience Platform suivants :
- Flux de données : un flux de données reçoit des données d’événement entrantes de Web SDK et répond avec des données de profil Edge.
- Politiques de fusion : vous allez créer une politique de fusion Active-On-Edge pour vous assurer que les profils Edge utilisent les données de profil correctes.
- Connexion Personalization personnalisée : vous allez configurer une nouvelle connexion de personnalisation personnalisée qui enverra les attributs de profil à Edge Network.
- API Edge Network : vous utiliserez la fonctionnalité d’API Edge Network collecte de données interactive pour récupérer rapidement les attributs de profil des profils Edge.
Mécanismes de sécurisation des performances guardrails
Les cas d’utilisation de la recherche de profil Edge sont soumis aux mécanismes de sécurisation de performances spécifiques décrits dans le tableau ci-dessous. Pour plus d’informations sur les mécanismes de sécurisation de l’API Edge Network, consultez la page de documentation mécanismes de sécurisation.
Étape 1 : créer et configurer un flux de données create-datastream
Suivez les étapes de la documentation configuration du flux de données pour créer un flux de données avec les paramètres de Service suivants :
- Service : Adobe Experience Platform
- Personalization Destinations : activé
- Edge Segmentation : si vous avez besoin d’une segmentation Edge, activez cette option. Si vous souhaitez uniquement rechercher des attributs de profil sur le serveur Edge, mais que vous ne souhaitez pas effectuer de segmentation en fonction des profils Edge, laissez cette option désactivée.
Étape 2 : configurer vos audiences pour l’évaluation Edge audience-edge-evaluation
La recherche d’attributs de profil sur Edge nécessite que vos audiences soient configurées pour l’évaluation Edge.
Assurez-vous que la Politique de fusion Active-on-Edge est définie par défaut pour les audiences que vous prévoyez d’activer. La politique de fusion Active-On-Edge garantit que les audiences sont constamment évaluées à la périphérie et sont disponibles pour les cas d’utilisation de la personnalisation en temps réel.
Suivez les instructions de la section création d’une politique de fusion et assurez-vous d’activer le bouton Active-On-Edge Merge Policy.
Étape 3 : envoi de données d’attribut de profil à Edge Network configure-custom-personalization-connection
Pour rechercher des profils Edge, y compris les attributs et les données d’appartenance à une audience, en temps réel, les données doivent être disponibles sur Edge Network. À cet effet, vous devez créer une connexion à une destination Custom Personalization With Attributes et activer les audiences, y compris les attributs que vous souhaitez rechercher sur les profils Edge.
Suivez le tutoriel sur la création de connexion de destination pour obtenir des instructions détaillées sur la création d’une connexion de destination.
Pendant la configuration de la nouvelle destination, sélectionnez le flux de données que vous avez créé à l’étape 1 dans le champ Datastream ID . Par Integration alias, vous pouvez utiliser n’importe quelle valeur qui vous aidera à identifier cette connexion de destination à l’avenir, comme le nom de la destination.
Après avoir créé une connexion Custom Personalization With Attributes, vous êtes prêt à envoyer des données de profil à Edge Network.
| note important |
|---|
| IMPORTANT |
|
| Lisez la présentation du contrôle d’accès ou contactez votre administrateur ou administratrice du produit pour obtenir les autorisations requises. |
-
Accédez à Connections > Destinations, puis sélectionnez l’onglet Catalog .
-
Recherchez la carte de destination Custom Personalization With Attributes, puis sélectionnez Activate audiences, comme illustré dans l’image ci-dessous.
-
Sélectionnez la connexion de destination que vous avez précédemment configurée, puis sélectionnez Next.
-
Sélectionnez vos audiences. Utilisez les cases à cocher situées à gauche des noms d’audience pour sélectionner les audiences à activer vers la destination, puis sélectionnez Next.
Vous pouvez effectuer un choix parmi plusieurs types d’audiences, selon leur origine :
-
Segmentation Service : audiences générées dans Experience Platform par Segmentation Service. Voir la documentation sur la segmentation pour plus d’informations.
-
Custom upload : audiences générées en dehors d’Experience Platform et chargées dans Experience Platform au format CSV. Pour en savoir plus sur les audiences externes, consultez la documentation sur importation d’une audience.
-
Autres types d’audiences, provenant d’autres solutions Adobe, telles que Audience Manager.
-
-
Sélectionnez les attributs de profil que vous souhaitez rendre disponibles pour les profils Edge.
-
Sélectionnez les attributs sources. Pour ajouter des attributs sources, sélectionnez la commande Add new field sur la colonne Source field et recherchez ou accédez au champ d’attribut XDM de votre choix, comme illustré ci-dessous.
-
Sélectionner les attributs de la cible. Pour ajouter des attributs cibles, sélectionnez le contrôle Add new field sur la colonne Target field et saisissez le nom de l’attribut personnalisé auquel vous souhaitez mapper l’attribut source.
-
Lorsque vous avez terminé de mapper les attributs de profil, sélectionnez Next.
Sur la page Review, vous pouvez voir un résumé de votre sélection. Sélectionnez Cancel pour interrompre le flux, Back pour modifier vos paramètres ou Finish pour confirmer votre sélection et commencer à envoyer des données de profil à Edge Network.
Si votre organisation a acheté Adobe Healthcare Shield ou Adobe Privacy & Security Shield, sélectionnez View applicable consent policies pour identifier les politiques de consentement appliquées et le nombre de profils inclus dans l’activation qui en résulte. Pour plus d’informations, consultez Évaluation des politiques de consentement .
Vérifications des politiques d’utilisation des données
À l’étape Review, Experience Platform vérifie également les violations de la politique d’utilisation des données. Vous trouverez ci-dessous un exemple de violation de la politique. Vous ne pouvez pas terminer le workflow d’activation de l’audience tant que vous n’avez pas résolu la violation. Pour plus d’informations sur la résolution des violations de politique, consultez la section sur les violations de politique d’utilisation des données data usage policy violations dans la documentation sur la gouvernance des données .
Dans l’étape Review , vous pouvez utiliser les filtres disponibles sur la page pour afficher uniquement les audiences dont le planning ou le mappage a été mis à jour dans le cadre de ce workflow. Vous pouvez également activer/désactiver les colonnes du tableau à afficher.
Si vous êtes satisfait(e) de votre sélection et qu’aucune violation de politique n’a été détectée, sélectionnez Finish pour confirmer votre sélection.
Étape 4 : Rechercher les attributs de profil sur le serveur Edge configure-edge-profile-lookup
À l’heure actuelle, vous devriez avoir terminé configuration de votre flux de données, vous avez créé une nouvelle connexion de destination Personalization personnalisée avec attributs et vous avez utilisé cette connexion pour envoyer les attributs de profil que vous pourrez rechercher dans Edge Network.
L’étape suivante consiste à configurer votre solution de personnalisation pour récupérer les attributs de profil des profils Edge.
Le flux de données que vous avez configuré à l’étape 1 est maintenant prêt à accepter les données d’événement entrantes et à répondre avec des informations de profil Edge.
Configurez votre intégration pour récupérer les informations de profil Edge comme illustré dans les exemples ci-dessous.
Requête request
Pour récupérer les données de profil Edge, envoyez un appel de POST vide au point d’entrée /interact, avec l’identité principale pour laquelle vous recherchez des attributs de profil inclus dans l’événement, comme illustré ci-dessous.
curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
"event":
{
"xdm": {
"identityMap": {
"Email": [
{
"id":"test123@adobetest.com",
"primary":true
}
]
}
}
}
}'
Réponse response
Une réponse réussie renvoie des 200 OK de statut HTTP, avec un objet Handle qui inclut des informations similaires aux exemples dans les onglets ci-dessous, selon que le profil se trouve sur le serveur Edge ou non.
handle peut inclure plusieurs objets payload de différents types. Les informations relatives à la recherche de profil Edge sont regroupées sous l'objet payload avec "type": "activation:pull",Si le profil existe sur le serveur Edge, en fonction des attributs de profil et des audiences activés sur le serveur Edge, vous pouvez vous attendre à une réponse avec des attributs et des appartenances à l’audience similaires à celui ci-dessous.
| code language-json |
|---|
|
L’objet handle fournit les informations décrites dans le tableau ci-dessous.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 | |
|---|---|
| Paramètre | Description |
payload |
Objet payload contenant les informations de recherche Edge. La réponse peut contenir plusieurs objets payload supplémentaires, sans rapport avec la recherche Edge. |
type |
Les payloads sont regroupées dans la réponse par type. Le type de payload pour la recherche de profil Edge est toujours défini sur profileLookup. |
destinationId |
Identifiant de l’instance de connexion Custom Personalization que vous avez créée à l’étape 3. |
alias |
Alias de la connexion de destination, configuré par l’utilisateur lors de la création de la connexion de destination Custom Personalization. |
attributes |
Ce tableau inclut les attributs de profil Edge des audiences que vous avez activées à étape 3. |
segments |
Ce tableau inclut les audiences que vous avez activées à étape 3. |
type |
handle objets sont regroupés par type. Pour les cas d’utilisation de la recherche de profil Edge, le type de l’objet handle est toujours activation:pull. |
eventIndex |
L’Edge Network reçoit les événements du client sous la forme de tableaux. L’ordre des événements dans le tableau est conservé pendant leur traitement et reflété par cet index. L’indexation des événements commence par 0. |
Si le profil n’existe pas sur le serveur Edge, vous pouvez vous attendre à une réponse similaire à celle ci-dessous.
| code language-json |
|---|
|
L’objet handle fournit les informations décrites dans le tableau ci-dessous.
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Paramètre | Description |
payload |
Lorsque le profil n’est pas présent sur le bord, l’objet payload est vide. |
type |
payload objets sont regroupés par type. Pour les cas d’utilisation de la recherche de profil Edge, le type de l’objet payload est toujours activation:pull. |
eventIndex |
L’Edge Network reçoit les événements du client sous la forme de tableaux. L’ordre des événements dans le tableau est conservé pendant leur traitement et reflété par cet index. L’indexation des événements commence par 0. |
Conclusion conclusion
En suivant les étapes ci-dessus, vous pouvez rechercher efficacement des attributs de profil Edge en temps réel, ce qui vous permet d’obtenir des expériences personnalisées et une prise de décision éclairée via les applications en aval.