Pour activer les données, vous avez besoin de l’événement Gestion des destinations, Activation des destinations, Afficher les profils, et Affichage de segments autorisations de contrôle d’accès. Lisez le présentation du contrôle d’accès ou contactez votre administrateur de produit pour obtenir les autorisations requises.
Cet article explique le processus requis pour activer des données d’audience dans des destinations de profils par lots d’Adobe Experience Platform, telles que l’espace de stockage dans le cloud et les destinations de marketing par e-mail.
Pour activer des données vers des destinations, vous devez avoir réussi à vous connecter à une destination. Si vous ne l’avez pas déjà fait, accédez au catalogue de destinations, parcourez les destinations prises en charge et configurez la destination que vous souhaitez utiliser.
Accédez à Connexions et destinations, puis sélectionnez l’onglet Catalogue.
Sélectionnez Activer des segments sur la vignette correspondant à la destination vers laquelle vous souhaitez activer des segments, tel qu’indiqué sur l’image ci-dessous.
Sélectionnez la connexion de destination à utiliser pour activer des segments, puis sélectionner Suivant.
Accédez à la section suivante pour sélectionner des segments.
Utilisez les cases à cocher situées à gauche des noms de segment pour sélectionner les segments que vous souhaitez activer vers la destination, puis sélectionnez Suivant.
Adobe Experience Platform exporte des données pour les destinations de marketing par e-mail et d’espace de stockage dans le cloud sous forme de fichiers CSV. Sur la page Planification, vous pouvez configurer le planning et les noms des fichiers pour chaque segment que vous exportez. La configuration du planning est obligatoire, mais la configuration du nom de fichier est facultative.
Adobe Experience Platform divise automatiquement les fichiers d’exportation à 5 millions d’enregistrements (lignes) par fichier. Chaque ligne représente un profil.
Les noms des fichiers fractionnés sont ajoutés avec un nombre indiquant que le fichier fait partie d’une exportation plus importante, comme : filename.csv
, filename_2.csv
, filename_3.csv
.
Sélectionnez le bouton Créer un planning correspondant au segment que vous souhaitez envoyer à votre destination.
Sélectionnez Exporter des fichiers complets pour exporter un fichier contenant un cliché instantané complet de toutes les qualifications de profil pour le segment sélectionné.
Utilisez le sélecteur Fréquence pour sélectionner la fréquence d’exportation :
Utilisez la variable Heure bascule pour sélectionner si l’exportation doit avoir lieu immédiatement après l’évaluation du segment ou sur une base planifiée, à une heure donnée. Lorsque vous sélectionnez la variable Planifié , vous pouvez utiliser le sélecteur pour choisir l’heure, dans UTC format, date à laquelle l’exportation doit avoir lieu.
Le Après l’évaluation du segment L’option décrite ci-dessous est actuellement disponible uniquement pour sélectionner les clients bêta.
Utilisez la variable Après l’évaluation du segment pour que la tâche d’activation s’exécute immédiatement après la fin de la tâche de segmentation par lots quotidienne de Platform. Ainsi, lorsque la tâche d’activation s’exécute, les profils les plus récents sont exportés vers votre destination.
Utilisez la variable Planifié pour que la tâche d’activation s’exécute à un moment donné. Cela garantit que les données de profil Experience Platform sont exportées simultanément chaque jour, mais les profils que vous exportez peuvent ne pas être les plus à jour, selon que la tâche de segmentation par lots est terminée ou non avant le lancement de la tâche d’activation.
De par la configuration des processus Experience Platform internes, la première exportation de fichier incrémentiel ou complet peut ne pas contenir toutes les données de renvoi.
Pour garantir une exportation complète et à jour des données de renvoi pour les fichiers complets et incrémentiels, Adobe recommande de définir l’heure d’exportation du premier fichier après 12h GMT du jour suivant. Cette limitation sera corrigée dans les prochaines versions.
Utilisez le sélecteur Date pour choisir le jour ou l’intervalle d’exportation. Pour les exportations quotidiennes, il est recommandé de définir les dates de début et de fin de sorte qu’elles correspondent à la durée de vos campagnes sur vos plateformes en aval.
Lors de la sélection d’un intervalle d’exportation, le dernier jour de l’intervalle n’est pas inclus dans les exportations. Par exemple, si vous sélectionnez un intervalle entre le 4 et le 11 janvier, la dernière exportation de fichier aura lieu le 10 janvier.
Sélectionnez Créer pour enregistrer le planning.
Sélectionnez Exporter des fichiers incrémentiels pour une exportation où le premier fichier est un cliché instantané complet de toutes les qualifications de profil pour le segment sélectionné, et les fichiers suivants sont des qualifications de profil incrémentielles depuis l’exportation précédente.
Le premier fichier incrémentiel exporté comprend tous les profils qui remplissent les critères d’un segment, agissant comme un renvoi.
Utilisez le sélecteur Fréquence pour sélectionner la fréquence d’exportation :
Utilisez le sélecteur Heure pour choisir l’heure de la journée, au format UTC, à laquelle l’exportation doit avoir lieu.
De par la configuration des processus Experience Platform internes, la première exportation de fichier incrémentiel ou complet peut ne pas contenir toutes les données de renvoi.
Pour garantir une exportation complète et à jour des données de renvoi pour les fichiers complets et incrémentiels, Adobe recommande de définir l’heure d’exportation du premier fichier après 12h GMT du jour suivant. Cette limitation sera corrigée dans les prochaines versions.
Utilisez le sélecteur Date pour choisir l’intervalle à partir duquel l’exportation doit avoir lieu. La bonne pratique consiste à définir les dates de début et de fin de sorte qu’elles correspondent à la durée de vos campagnes sur vos plateformes en aval.
Le dernier jour de l’intervalle n’est pas inclus dans les exportations. Par exemple, si vous sélectionnez un intervalle entre le 4 et le 11 janvier, la dernière exportation de fichier aura lieu le 10 janvier.
Sélectionnez Créer pour enregistrer le planning.
Les noms de fichier par défaut sont composés du nom de destination, de l’identifiant du segment et d’un indicateur de la date et de l’heure. Vous pouvez, par exemple, modifier les noms des fichiers exportés afin de faire la distinction entre les différentes campagnes ou pour ajouter le temps d’exportation des données aux fichiers.
Sélectionnez l’icône en forme de crayon pour ouvrir une fenêtre modale et modifier les noms des fichiers. Les noms de fichier sont limités à 255 caractères.
L’image ci-dessous montre comment les noms de fichier peuvent être modifiés pour les destinations Amazon S3, mais le processus est identique pour toutes les destinations par lots (par exemple, SFTP ou Stockage Azure Blob).
Dans l’éditeur de nom de fichier, vous pouvez sélectionner différents composants à ajouter au nom du fichier.
Le nom de destination et l’identifiant de segment ne peuvent pas être supprimés des noms de fichier. Vous pouvez en outre ajouter les éléments suivants :
MMDDYYYY_HHMMSS
et un horodatage Unix à 10 chiffres de l’heure de génération des fichiers. Choisissez l’une de ces options si vous souhaitez que vos fichiers aient un nom de fichier dynamique généré avec chaque exportation de fichier incrémentiel.Sélectionnez Appliquer les modifications pour confirmer votre sélection.
Si vous ne sélectionnez pas l’option Date et heure, les noms de fichier seront statiques et le nouveau fichier exporté remplacera le fichier précédent de votre emplacement de stockage à chaque exportation. L’option recommandée consiste à exécuter une tâche d’importation récurrente depuis un emplacement de stockage vers une plateforme de marketing par e-mail.
Une fois tous les segments configurés, sélectionnez Suivant pour continuer.
Pour les destinations basées sur un profil, vous devez sélectionner les attributs de profil à envoyer à la destination cible.
Sur la page Sélectionner des attributs, sélectionnez Ajouter un nouveau champ.
Sélectionnez la flèche située à droite de l’entrée Champ de schéma.
Sur la page Sélectionner un champ, sélectionnez les attributs XDM à envoyer à la destination puis choisissez Sélectionner.
Pour ajouter d’autres mappages, répétez les étapes 1 à 3.
Adobe Experience Platform préremplit votre sélection avec quatre attributs recommandés couramment utilisés de votre schéma : person.name.firstName
, person.name.lastName
, personalEmail.address
, segmentMembership.status
.
Les exportations de fichiers varient comme suit, selon que segmentMembership.status
est sélectionné :
segmentMembership.status
est sélectionné, les fichiers exportés incluent les membres actifs dans l’instantané complet initial ainsi que les membres actifs et expirés dans les exportations incrémentielles suivantes.segmentMembership.status
n’est pas sélectionné, les fichiers exportés incluent uniquement les membres actifs dans l’instantané complet initial et dans les exportations incrémentielles suivantes.Un attribut obligatoire est une case à cocher activée par l’utilisateur qui garantit que tous les enregistrements de profil contiennent l’attribut sélectionné. Par exemple : tous les profils exportés contiennent une adresse e-mail.
Vous pouvez marquer les attributs comme étant obligatoires afin de vous assurer que Platform exporte uniquement les profils qui incluent l’attribut spécifique. Par conséquent, cette action peut être utilisée comme une forme supplémentaire de filtrage. Le marquage d’un attribut comme étant obligatoire n’est pas requis.
Si vous ne sélectionnez pas d’attribut obligatoire, tous les profils qualifiés sont exportés, quels que soient leurs attributs.
Il est recommandé que l’un des attributs soit un identifiant unique de votre schéma. Pour plus d’informations sur les attributs obligatoires, consultez la section Identité dans la documentation Destinations de marketing par e-mail.
Une clé de déduplication est une clé primaire définie par l’utilisateur qui détermine l’identité par laquelle les utilisateurs souhaitent dédupliquer leurs profils.
Les clés de déduplication empêchent dʼavoir plusieurs enregistrements du même profil dans un fichier dʼexportation.
Vous pouvez utiliser les clés de déduplication de trois manières différentes dans :Platform
Vous pouvez exporter un espace de noms d’identité unique vers une destination, l’espace de noms étant alors automatiquement défini comme clé de déduplication. L’envoi de plusieurs espaces de noms vers une destination n’est pas pris en charge.
Vous ne pouvez pas utiliser une combinaison d’espaces de noms d’identité et d’attributs de profil comme clés de déduplication.
Cet exemple illustre le fonctionnement de la déduplication, en fonction des clés de déduplication sélectionnées.
Examinons les deux profils suivants.
Profil A
{
"identityMap": {
"Email": [
{
"id": "johndoe_1@example.com"
},
{
"id": "johndoe_2@example.com"
}
]
},
"segmentMembership": {
"ups": {
"fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
"status": "existing",
"lastQualificationTime": "2021-03-10 10:03:08"
}
}
},
"person": {
"name": {
"lastName": "Doe",
"firstName": "John"
}
},
"personalEmail": {
"address": "johndoe@example.com"
}
}
Profil B
{
"identityMap": {
"Email": [
{
"id": "johndoe_1@example.com"
},
{
"id": "johndoe_2@example.com"
}
]
},
"segmentMembership": {
"ups": {
"fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
"status": "existing",
"lastQualificationTime": "2021-04-10 11:33:28"
}
}
},
"person": {
"name": {
"lastName": "D",
"firstName": "John"
}
},
"personalEmail": {
"address": "johndoe@example.com"
}
}
Sans déduplication, le fichier d’exportation contiendrait les entrées suivantes.
E-mail personnel | Prénom | Nom |
---|---|---|
johndoe@example.com | John | Doe |
johndoe@example.com | John | D |
En supposant une déduplication par l’espace de noms Email, le fichier d’exportation contiendra les entrées suivantes. Le profil B est le dernier ayant rempli les critères pour le segment et est donc le seul à être exporté.
Adresse e-mail* | E-mail personnel | Prénom | Nom |
---|---|---|---|
johndoe_1@example.com | johndoe@example.com | John | D |
johndoe_2@example.com | johndoe@example.com | John | D |
En supposant une déduplication par l’attribut personal Email
, le fichier d’exportation contiendra l’entrée suivante. Le profil B est le dernier ayant rempli les critères pour le segment et est donc le seul à être exporté.
E-mail personnel* | Prénom | Nom |
---|---|---|
johndoe@example.com | John | D |
En supposant une déduplication par la clé composite personalEmail + lastName
, le fichier d’exportation contiendra les entrées suivantes.
E-mail personnel* | Nom* | Prénom |
---|---|---|
johndoe@example.com | D | John |
johndoe@example.com | Doe | John |
Adobe recommande de sélectionner un espace de noms d’identité, tel qu’un CRM ID ou une adresse e-mail comme clé de déduplication, pour s’assurer que tous les enregistrements de profil sont identifiés de manière unique.
Si des libellés d’utilisation des données ont été appliqués à certains champs d’un jeu de données (plutôt qu’à l’ensemble du jeu), l’application de ces libellés au niveau du champ sur l’activation se fait dans les conditions suivantes :
Par exemple, si le champ person.name.firstName
comporte certains libellés d’utilisation des données entrant en conflit avec l’action marketing de la destination, une violation de la stratégie d’utilisation des données s’afficherait dans l’étape de révision. Pour plus d’informations, voir Gouvernance des données dans Adobe Experience Platform.
Sur la page Vérifier, vous pouvez voir un résumé de votre sélection. Sélectionnez Annuler pour interrompre le flux, Précédent pour modifier vos paramètres ou Terminer pour confirmer votre sélection et commencer à envoyer les données à la destination.
Au cours de cette étape, Adobe Experience Platform recherche les violations de la stratégie d’utilisation des données. Vous trouverez ci-dessous un exemple de violation de la stratégie. Vous ne pouvez pas terminer le processus d’activation des segments tant que vous n’avez pas résolu la violation. Pour plus d’informations sur la résolution des violations de stratégie, voir Application des stratégies dans la section documentation sur la gouvernance des données.
Si aucune violation de stratégie n’a été détectée, sélectionnez Terminer pour confirmer la sélection et commencer à envoyer des données à la destination.
Pour les destinations de marketing par e-mail et celles de stockage dans le cloud, Adobe Experience Platform crée un fichier .csv
dans l’emplacement de stockage indiqué. Attendez-vous à ce qu’un nouveau fichier soit créé chaque jour à votre emplacement de stockage. Le format de fichier par défaut est :
<destinationName>_segment<segmentID>_<timestamp-yyyymmddhhmmss>.csv
Les fichiers que vous pouvez recevoir pendant trois jours consécutifs peuvent ressembler à ceux-ci :
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200408061804.csv
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200409052200.csv
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200410061130.csv
La présence de ces fichiers dans votre emplacement de stockage est la confirmation de la réussite de l’activation. Pour comprendre la structure des fichiers exportés, vous pouvez télécharger un exemple de fichier .csv. Cet exemple de fichier comprend les attributs de profil person.firstname
, person.lastname
, person.gender
, person.birthyear
et personalEmail.address
.