Activer les données d’audience vers des destinations d’exportation de profils par lots

Présentation

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.

Conditions préalables

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.

Sélectionnez votre destination

1. Accédez à Connexions et destinations, puis sélectionnez l’onglet Catalogue.

   

2. 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.

   

3. Sélectionnez la connexion de destination à utiliser pour activer des segments, puis sélectionner Suivant.

   

4. Accédez à la section suivante pour sélectionner des segments.

Sélectionnez vos 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.

Planifier l’exportation de segments

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.

Sélectionnez le bouton Créer un planning correspondant au segment que vous souhaitez envoyer à votre destination.

Exporter des fichiers complets

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é.

1. Utilisez le sélecteur Fréquence pour sélectionner la fréquence d’exportation :

   • Une fois : planifiez une exportation de fichiers complets sur demande unique.
   • Tous les jours : planifiez des exportations de fichiers complets une fois par jour, tous les jours, au moment choisi.

2. 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.

   REMARQUE

   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.

   

   IMPORTANT

   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.

3. 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.

   IMPORTANT

   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.

4. Sélectionnez Créer pour enregistrer le planning.

Exporter des fichiers incrémentiels

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.

1. Utilisez le sélecteur Fréquence pour sélectionner la fréquence d’exportation :

   • Tous les jours : planification d’exportations de fichiers incrémentiels une fois par jour, tous les jours, au moment choisi.
   • Par heure : planification d’exportations de fichiers incrémentiels toutes les 3, 6, 8 ou 12 heures.

2. Utilisez le sélecteur Heure pour choisir l’heure de la journée, au format UTC, à laquelle l’exportation doit avoir lieu.

   IMPORTANT

   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.

3. 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.

   IMPORTANT

   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.

4. Sélectionnez Créer pour enregistrer le planning.

Configurer les noms de fichiers

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.

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 :

• Nom de segment : vous pouvez ajouter un nom de segment au nom de fichier.
• Date et heure : vous permet de choisir entre l’ajout d’un format 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.
• Texte personnalisé : vous permet d’ajouter un texte personnalisé aux noms des fichiers.

Sélectionnez Appliquer les modifications pour confirmer votre sélection.

Une fois tous les segments configurés, sélectionnez Suivant pour continuer.

Sélectionner des attributs de profil

Pour les destinations basées sur un profil, vous devez sélectionner les attributs de profil à envoyer à la destination cible.

1. Sur la page Sélectionner des attributs, sélectionnez Ajouter un nouveau champ.

   

2. Sélectionnez la flèche située à droite de l’entrée Champ de schéma.

   

3. Sur la page Sélectionner un champ, sélectionnez les attributs XDM à envoyer à la destination puis choisissez Sélectionner.

   

4. Pour ajouter d’autres mappages, répétez les étapes 1 à 3.

Les exportations de fichiers varient comme suit, selon que segmentMembership.status est sélectionné :

• Si le champ 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.
• Si le champ 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.

Attributs obligatoires

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.

Clés de déduplication

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

• Utiliser un espace de noms d’identité unique comme clé de déduplication
• Utiliser un attribut de profil unique à partir d’un profil XDM comme clé de déduplication
• Utiliser une combinaison de deux attributs de profil à partir d’un profil XDM en tant que clé composite

Exemple 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"
  }
}

Cas d’utilisation 1 de la déduplication : pas de déduplication

Sans déduplication, le fichier d’exportation contiendrait les entrées suivantes.

Cas d’utilisation 2 de la déduplication : déduplication basée sur l’espace de noms d’identité

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é.

Cas d’utilisation 3 de la déduplication : déduplication basée sur un attribut de profil unique

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é.

Cas d’utilisation 4 de la déduplication : déduplication basée sur deux attributs de profil

En supposant une déduplication par la clé composite personalEmail + lastName, le fichier d’exportation contiendra les entrées suivantes.

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.

Révision

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.

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.

Vérifier l’activation des segments

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.

Ressources Business.Adobe.com