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

IMPORTANT

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.

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.

    Image montrant comment accéder à l’onglet Catalogue de destinations

  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.

    Image mettant en surbrillance le bouton Activer les segments

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

    Image montrant comment sélectionner une ou plusieurs destinations pour activer des segments

  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.

Image montrant comment sélectionner un ou plusieurs segments à activer

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.

IMPORTANT

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.

Image mettant en surbrillance le bouton Créer une planification

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

Image de l’interface utilisateur avec la bascule Exporter les fichiers complets sélectionnée.

  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.

    Image mettant en surbrillance l’option Après l’évaluation du segment dans le flux d’activation pour les destinations par lots.
    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.

    Image mettant en surbrillance l’option Planifié dans le flux d’activation pour les destinations par lots et affichant le sélecteur de temps.

    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.

IMPORTANT

Le premier fichier incrémentiel exporté comprend tous les profils qui remplissent les critères d’un segment, agissant comme un renvoi.

Image de l’interface utilisateur avec le bouton bascule Exporter les fichiers incrémentiels sélectionné.

  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.

REMARQUE

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

Image mettant en surbrillance l’icône représentant un crayon, utilisée pour configurer les noms de fichier.

Dans l’éditeur de nom de fichier, vous pouvez sélectionner différents composants à ajouter au nom du fichier.

Image affichant toutes les options de nom de fichier disponibles.

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.

IMPORTANT

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.

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.

    Image mettant en surbrillance le bouton Ajouter un champ .

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

    Image montrant comment sélectionner un champ source.

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

    Image montrant les différents champs disponibles en tant que champs source.

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

REMARQUE

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

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

Image présentant les attributs recommandés préremplis à l’étape de mappage du processus d’activation du segment.

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
IMPORTANT

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.

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.

E-mail personnel Prénom Nom
johndoe@example.com John Doe
johndoe@example.com John D

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

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

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

E-mail personnel* Prénom Nom
johndoe@example.com John D

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.

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.

REMARQUE

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 :

  • Les champs sont utilisés dans la définition de segment.
  • Les champs sont configurés en tant qu’attributs prévisionnels pour la destination cible.

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.

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.

IMPORTANT

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.

Image montrant un exemple de violation de la stratégie de 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.

Image présentant l’écran de révision du workflow d’activation du segment.

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.

Sur cette page