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.

   

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.

   

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

   

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.

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.

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

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

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.

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.

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

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.

   

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

   

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

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.

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

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

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

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 votre sélection et commencer à envoyer les données à la destination.

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.