Connexion de personnalisation personnalisée custom-personalization-connection
Journal des modifications de destination changelog
Vue d’ensemble overview
Configurez cette destination pour permettre aux plateformes de personnalisation externes, aux systèmes de gestion de contenu, aux serveurs de publicités et aux autres applications qui s’exécutent sur les sites web des clients de récupérer les informations d’audience de Adobe Experience Platform.
Conditions préalables prerequisites
Cette destination nécessite l’utilisation de l’une des méthodes de collecte de données suivantes, selon votre mise en oeuvre :
- Utilisez le SDK Web Adobe Experience Platform si vous souhaitez collecter des données à partir de votre site Web.
- Utilisez le SDK Mobile Adobe Experience Platform si vous souhaitez collecter des données à partir de votre application mobile.
- Utilisez l’ API serveur Edge Network si vous n’utilisez pas le SDK web ou le SDK mobile, ou si vous souhaitez personnaliser l’expérience utilisateur en fonction des attributs de profil.
Audiences prises en charge supported-audiences
Cette section décrit les types d’audiences que vous pouvez exporter vers cette destination.
Type et fréquence d’exportation export-type-frequency
Se connecter à la destination connect
Pour vous connecter à cette destination, procédez comme décrit dans le tutoriel sur la configuration des destinations.
Paramètres de connexion parameters
Pendant la configuration de cette destination, vous devez fournir les informations suivantes :
- Nom : renseignez le nom de votre choix pour cette destination.
- Description : saisissez une description pour votre destination. Vous pouvez, par exemple, mentionner la campagne pour laquelle vous utilisez cette destination. Ce champ est facultatif.
- Alias d’intégration : cette valeur est envoyée au SDK web Experience Platform sous forme de nom d’objet JSON.
- Identifiant du flux de données : détermine dans quel flux de données de collecte de données les audiences seront incluses dans la réponse à la page. Le menu déroulant affiche uniquement les flux de données pour lesquels la configuration de destination est activée. Voir Configurer un flux de données pour plus d’informations.
Activer les alertes enable-alerts
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.
Activer des audiences vers cette destination activate
Lisez la section Activation des profils et des audiences vers des destinations de personnalisation de périphérie pour obtenir des instructions sur l’activation des audiences vers cette destination.
Données exportées exported-data
Si vous utilisez des balises dans Adobe Experience Platform pour déployer le SDK web Experience Platform, utilisez la fonctionnalité Envoi de l’événement terminé et votre action de code personnalisé contiendra une variable event.destinations
que vous pourrez utiliser pour afficher les données exportées.
Voici un exemple de valeur pour la variable event.destinations
:
[
{
"type":"profileLookup",
"destinationId":"7bb4cb8d-8c2e-4450-871d-b7824f547111",
"alias":"personalizationAlias",
"segments":[
{
"id":"399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
},
{
"id":"499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
}
]
}
]
Si vous n’utilisez pas Balises pour déployer le SDK Web Experience Platform, utilisez réponses de commande pour afficher les données exportées.
Vous pouvez analyser la réponse JSON d’Adobe Experience Platform pour trouver l’alias d’intégration correspondant à l’application que vous intégrez dans Adobe Experience Platform. Les identifiants d’audience peuvent être transmis dans le code de l’application en tant que paramètres de ciblage. Vous trouverez ci-dessous un exemple de ce à quoi cela ressemblerait dans le cas spécifique de la réponse de destination.
alloy("sendEvent", {
"renderDecisions": true,
"xdm": {
"commerce": {
"order": {
"purchaseID": "a8g784hjq1mnp3",
"purchaseOrderNumber": "VAU3123",
"currencyCode": "USD",
"priceTotal": 999.98
}
}
}
}).then(function(result) {
if(result.destinations) { // Looking to see if the destination results are there
// Get the destination with a particular alias
var personalizationDestinations = result.destinations.filter(x => x.alias == "personalizationAlias")
if(personalizationDestinations.length > 0) {
// Code to pass the audience IDs into the system that corresponds to personalizationAlias
}
var adServerDestinations = result.destinations.filter(x => x.alias == "adServerAlias")
if(adServerDestinations.length > 0) {
// Code to pass the audience IDs into the system that corresponds to adServerAlias
}
}
})
.catch(function(error) {
// Tracking the event failed.
});
Exemple de réponse pour Personalization personnalisé avec attributs
Lors de l’utilisation de Personalization personnalisé avec des attributs, la réponse de l’API ressemblera à l’exemple ci-dessous.
La différence entre Personalization personnalisée avec attributs et Personalization personnalisé réside dans l’inclusion de la section attributes
dans la réponse de l’API.
[
{
"type": "profileLookup",
"destinationId": "7bb4cb8d-8c2e-4450-871d-b7824f547130",
"alias": "personalizationAlias",
"attributes": {
"countryCode": {
"value" : "DE"
},
"membershipStatus": {
"value" : "PREMIUM"
}
},
"segments": [
{
"id": "399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
},
{
"id": "499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
}
]
}
]
Utilisation et gouvernance des données data-usage-governance
Lors de la gestion de vos données, toutes les destinations Adobe Experience Platform se conforment aux politiques d’utilisation des données. Pour obtenir des informations détaillées sur la manière dont Adobe Experience Platform applique la gouvernance des données, consultez la Présentation de la gouvernance des données.