Connexion Personalization personnalisée custom-personalization-connection
Journal des modifications de destination changelog
Utilisez ce journal des modifications pour suivre les mises à jour de la destination Custom Personalization.
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 s’exécutant sur les sites web des clients de récupérer les informations d’audience à partir de Adobe Experience Platform.
Conditions préalables prerequisites
Cette destination nécessite l’une des méthodes de collecte de données suivantes, selon votre implémentation :
- Utilisez Adobe Experience Platform Web SDK pour collecter des données sur votre site Web.
- Utilisez Adobe Experience Platform Mobile SDK pour collecter des données à partir de votre application mobile.
- Utilisez l’API 🔗 si vous n’utilisez pas Web SDK ou Mobile SDK, ou si vous souhaitez personnaliser l’expérience utilisateur en fonction des attributs de profil.
Audiences prises en charge supported-audiences
Le tableau suivant répertorie les types d’audiences que vous pouvez exporter vers cette destination.
Cette catégorie inclut toutes les origines d’audience en dehors des audiences générées par le Segmentation Service. Découvrez les différentes origines d’audience. Voici quelques exemples :
- audiences de chargement personnalisées importées dans Experience Platform à partir de fichiers CSV,
- les audiences semblables,
- les audiences fédérées,
- les audiences générées dans d’autres applications Experience Platform, telles que Adobe Journey Optimizer,
- et plus encore.
Audiences prises en charge par type de données d’audience :
Type et fréquence d’exportation export-type-frequency
Le tableau suivant décrit le type et la fréquence d’exportation pour cette destination.
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 :
- Name : renseignez le nom de votre choix pour cette destination.
- Description : saisissez une description de la destination. Vous pouvez, par exemple, mentionner la campagne pour laquelle vous utilisez cette destination. Ce champ est facultatif.
- Integration alias : chaîne obligatoire qui identifie cette destination dans la réponse de personnalisation. La valeur d’alias est renvoyée à votre site web ou application avec les audiences (et, si elles sont configurées, les attributs) associées à cette destination. Utilisez l’alias dans votre code côté client ou côté serveur pour localiser et traiter l’objet de personnalisation correct lorsque plusieurs destinations de personnalisation sont actives sur le même flux de données. L’alias doit être unique dans un sandbox pour toutes les destinations Custom Personalization.
- Datastream : 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
Activez les alertes pour recevoir des notifications sur le statut de votre flux de données vers cette 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 Next.
Activer des audiences vers cette destination activate
Lisez Activer des profils et des audiences vers des destinations de personnalisation Edge pour obtenir des instructions sur l’activation des audiences vers cette destination.
Données exportées exported-data
Si vous utilisez la fonctionnalité Balises dans Adobe Experience Platform pour déployer le SDK Web Experience Platform, utilisez la fonctionnalité envoi de l’événement terminé. Votre action Custom Code comporte une variable event.destinations que vous pouvez 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 Experience Platform Web SDK, utilisez réponses des commandes pour afficher les données exportées.
Analysez la réponse JSON de Adobe Experience Platform pour trouver l’alias d’intégration de l’application que vous intégrez à Adobe Experience Platform. Transmettez les identifiants d’audience dans le code de l’application en tant que paramètres de ciblage. Vous trouverez ci-dessous un exemple de ce à quoi cela ressemble en termes spécifiques à 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 un Personalization personnalisé avec des attributs example-response-attributes
Lors de l’utilisation de Custom Personalization With Attributes, la réponse de l’API ressemblera à l’exemple ci-dessous.
La différence entre Custom Personalization With Attributes et Custom Personalization est 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.