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

Présentation

Cet article explique le processus requis pour activer les données d’audience dans des destinations basées sur des profils de lot 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 les données vers les destinations, vous devez être connecté à une destination. Si vous ne l’avez pas déjà fait, accédez au catalogue des destinations, parcourez les destinations prises en charge et configurez la destination que vous souhaitez utiliser.

Sélectionner votre destination

  1. Accédez à Connexions > Destinations, puis sélectionnez l’onglet Catalogue.

    Onglet Catalogue de destinations

  2. Sélectionnez Activer les segments sur la carte correspondant à la destination vers laquelle vous souhaitez activer vos segments, comme illustré dans l’image ci-dessous.

    Bouton Activer les segments

  3. Sélectionnez la connexion de destination à utiliser pour activer vos segments, puis cliquez sur Suivant.

    Sélectionner la destination

  4. Passez à la section suivante pour sélectionner vos segments.

Sélection de 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.

Sélection de segments

Planification de l’exportation de segments

Adobe Experience Platform exporte les données pour les destinations de marketing par e-mail et de stockage dans le cloud sous la forme de CSV fichiers. 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 de fichiers fractionnés sont ajoutés avec un nombre indiquant que le fichier fait partie d’un export plus important, en tant que tel : 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.

Bouton Créer un planning

Exporter les fichiers complets

Sélectionnez Exporter les fichiers complets pour déclencher l’exportation d’un fichier contenant un instantané complet de toutes les qualifications de profil pour le segment sélectionné.

Exporter les fichiers complets

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

    • Une fois : planifier une exportation de fichiers complète à la demande unique.
    • Quotidien : planifier des exportations complètes de fichiers une fois par jour, tous les jours, au moment que vous spécifiez.
  2. Utilisez le sélecteur Heure pour choisir l’heure de la journée, au format UTC, où doit avoir lieu l’exportation.

    IMPORTANT

    En raison de la configuration des processus Experience Platform internes, la première exportation incrémentielle ou complète de fichier 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 le jour suivant. Cette limitation sera corrigée dans les prochaines versions.

  3. Utilisez le sélecteur Date pour choisir le jour ou l’intervalle au cours duquel l’exportation doit avoir lieu.

    CONSEIL

    Pour les exportations quotidiennes, définissez les dates de début et de fin afin de correspondre à la durée de vos campagnes sur vos plateformes en aval.

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

Exportation de fichiers incrémentiels

Sélectionnez Exporter les fichiers incrémentiels pour déclencher une exportation où le premier fichier est un 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 et qui fonctionnent comme un renvoi.

Exportation de fichiers incrémentiels

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

    • Quotidien : planifier des exportations incrémentielles de fichiers une fois par jour, tous les jours, au moment que vous spécifiez.
    • Horaire : planifier des exportations incrémentielles de fichiers 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, où doit avoir lieu l’exportation.

    IMPORTANT

    En raison de la configuration des processus Experience Platform internes, la première exportation incrémentielle ou complète de fichier 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 le jour suivant. Cette limitation sera corrigée dans les prochaines versions.

  3. Utilisez le sélecteur Date pour choisir le jour ou l’intervalle au cours duquel l’exportation doit avoir lieu.

    CONSEIL

    Définissez les dates de début et de fin pour correspondre à la durée de vos campagnes sur vos plateformes en aval.

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

Configuration des noms de fichier

Les noms de fichier par défaut sont composés du nom de destination, de l’identifiant de segment et d’un indicateur de date et d’heure. Vous pouvez, par exemple, modifier les noms des fichiers exportés afin de faire la distinction entre les différentes campagnes ou d’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.

configurer le nom du fichier

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

modifier les options de nom de 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 du segment : Vous pouvez ajouter le nom du segment au nom du fichier.
  • Date et heure : Choisissez entre l’ajout d’un MMDDYYYY_HHMMSS format ou d’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 export incrémentiel.
  • Texte personnalisé : Ajoutez du texte personnalisé aux noms des fichiers.

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

IMPORTANT

Si vous ne sélectionnez pas le composant Date et heure , les noms de fichier seront statiques et le nouveau fichier exporté remplacera le fichier précédent dans votre emplacement de stockage par chaque exportation. Lors de l’exécution d’une tâche d’importation récurrente depuis un emplacement de stockage vers une plateforme de marketing par e-mail, il s’agit de l’option recommandée.

Une fois la configuration de tous les segments terminée, sélectionnez Suivant pour continuer.

Sélection 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. Dans la page Sélectionner les attributs, sélectionnez Ajouter un nouveau champ.

    Ajouter un nouveau mappage

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

    Sélectionner le champ source

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

    Sélectionner la page du champ 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é ou non :

  • Si le champ segmentMembership.status est sélectionné, les fichiers exportés incluent des membres Principal dans l’instantané complet initial et Principal et des membres 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 Principal dans l’instantané complet initial et dans les exportations incrémentielles suivantes.

attributs recommandés

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 email. ​

Vous pouvez marquer les attributs comme obligatoires pour vous assurer que Platform exporte uniquement les profils qui incluent l’attribut spécifique. Par conséquent, il peut être utilisé comme une forme supplémentaire de filtrage. Le marquage d’un attribut comme obligatoire est non obligatoire.

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é de la documentation Destinations de marketing par e-mail .

Clés de déduplication

Une clé de déduplication est une clé Principale 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 éliminent la possibilité dʼavoir plusieurs enregistrements du même profil dans un fichier dʼexportation.

Il existe trois façons d’utiliser les clés de déduplication dans Platform :

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

Vous pouvez exporter un espace de noms d’identité unique vers une destination et l’espace de noms est automatiquement défini comme clé de déduplication. L’envoi de plusieurs espaces de noms à 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édoublonnage, le fichier d'export contiendrait les entrées suivantes.

personalEmail firstName lastName
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 qui a rempli les critères pour le segment. Il est donc le seul à être exporté.

Email* personalEmail firstName lastName
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 qui a rempli les critères pour le segment. Il est donc le seul à être exporté.

personalEmail* firstName lastName
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.

personalEmail* lastName* firstName
johndoe@example.com D John
johndoe@example.com Doe John

Adobe recommande de sélectionner un espace de noms d’identité tel qu’une CRM ID ou une adresse électronique comme clé de déduplication, afin de 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 de données), l’application de ces libellés au niveau du champ lors de l’activation se produit 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 contient certains libellés d’utilisation des données qui entrent en conflit avec l’action marketing de la destination, une violation de la politique d’utilisation des données s’affichera à 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 stratégie d’utilisation des données. Vous trouverez ci-dessous un exemple de violation d’une stratégie. Vous ne pouvez pas terminer le workflow d’activation du segment tant que vous n’avez pas résolu la violation. Pour plus d’informations sur la manière de résoudre les violations de stratégie, voir Application de la stratégie dans la section de documentation sur la gouvernance des données.

violation de la politique de données

Si aucune violation de stratégie n’a été détectée, sélectionnez Terminer pour confirmer votre sélection et commencer à envoyer les données à la destination.

Révision

Vérification de l’activation des segments

Pour les destinations de marketing par e-mail et de stockage dans le cloud, Adobe Experience Platform crée un fichier .csv délimité par des tabulations dans l’emplacement de stockage que vous avez fourni. Attendez-vous à ce qu’un nouveau fichier soit créé chaque jour à votre emplacement de stockage. Le format de fichier par défaut est le suivant :
<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. Ce fichier d’exemple comprend les attributs de profil person.firstname, person.lastname, person.gender, person.birthyear et personalEmail.address.

Sur cette page