Activer les audiences vers des destinations d’export de profils par lots

Présentation overview

Cet article explique le processus requis pour activer des audiences dans Adobe Experience Platform vers des destinations basées sur des fichiers de profils par lots, telles que l’espace de stockage dans le cloud et les destinations de marketing par e-mail.

Conditions préalables prerequisites

Pour activer des audiences 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.

Formats de fichiers pris en charge pour l’export supported-file-formats-export

Les formats de fichiers suivants sont pris en charge lors de l’exportation d’audiences :

Notez que l’exportation de fichiers CSV vous offre une plus grande flexibilité en termes de structure des fichiers exportés. En savoir plus sur configuration du formatage des fichiers CSV.

Sélectionnez le format de fichier que vous souhaitez exporter lors de la création d’une connexion à la destination basée sur des fichiers.

Sélectionner votre destination select-destination

Sélectionner vos audiences select-audiences

Pour sélectionner les audiences à activer vers la destination, utilisez les cases à cocher situées à gauche des noms d’audience, puis sélectionnez Suivant.

Vous pouvez effectuer un choix parmi plusieurs types d’audiences, selon leur origine :

Planifier l’export d’audience scheduling

Adobe Experience Platform exporte des données pour les destinations de marketing par e-mail et d’espace de stockage dans le cloud sous différents types de fichiers. Sur la page Planification, vous pouvez configurer le planning et les noms des fichiers pour chaque audience que vous exportez.

Experience Platform définit automatiquement un planning par défaut pour chaque exportation de fichier. Vous pouvez modifier la planification par défaut en fonction de vos besoins, en cliquant sur l’icône en forme de crayon en regard de chaque planification et en définissant une planification personnalisée.

Pour modifier plusieurs plannings en même temps, sélectionnez les audiences à l’aide des cases à cocher situées sur le côté gauche de l’écran, puis sélectionnez Modifier le planning. Le planning que vous configurez sera ensuite appliqué à tous les fichiers exportés pour les audiences sélectionnées.

Exporter des fichiers complets export-full-files

Sélectionnez Exporter des fichiers complets pour exporter un fichier contenant un cliché instantané complet de toutes les qualifications de profil pour l’audience sélectionnée.

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 l’audience sélectionnée, et les fichiers suivants sont des qualifications de profil incrémentielles depuis l’exportation précédente.

Configurer les noms de fichiers configure-file-names

Pour la plupart des destinations, les noms de fichier par défaut se composent d’un nom de destination, d’un identifiant d’audience 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 pour ajouter le temps d’exportation des données aux fichiers. Remarque : certains développeurs peuvent choisir d’ajouter différentes options de nom de fichier par défaut pour leurs destinations.

Pour ouvrir une fenêtre modale et modifier les noms des fichiers, sélectionnez l’icône en forme de crayon. 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’ID d’audience ne peuvent pas être supprimés des noms de fichier. Outre ces options, vous pouvez ajouter les options suivantes :

Pour modifier plusieurs noms de fichier en même temps, sélectionnez les audiences à l’aide des cases à cocher situées sur le côté gauche de l’écran, puis sélectionnez Modifier le nom du fichier. Les options de nom de fichier que vous configurez seront ensuite appliquées à tous les fichiers exportés pour les audiences sélectionnées.

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

Une fois toutes les audiences configurées, sélectionnez Suivant pour continuer.

Mappage mapping

Au cours de cette étape, vous devez sélectionner les attributs de profil à ajouter aux fichiers exportés vers la destination cible. Pour sélectionner les attributs de profil et les identités à exporter :

Attributs obligatoires mandatory-attributes

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 deduplication-keys

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

Exemple de déduplication deduplication-example

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": "doejohn_1@example.com"
      }
    ]
  },
  "segmentMembership": {
    "ups": {
      "fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
        "status": "realized",
        "lastQualificationTime": "2021-03-10 10:03:08"
      }
    }
  },
  "person": {
    "name": {
      "lastName": "Doe",
      "firstName": "John"
    }
  },
  "personalEmail": {
    "address": "johndoe@example.com"
  }
}

Profil B

{
  "identityMap": {
    "Email": [
      {
        "id": "johndoe_2@example.com"
      },
      {
        "id": "doejohn_2@example.com"
      }
    ]
  },
  "segmentMembership": {
    "ups": {
      "fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
        "status": "realized",
        "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 deduplication-use-case-1

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é deduplication-use-case-2

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 de l’audience. 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 deduplication-use-case-3

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 de l’audience. Il est donc le seul à être exporté.

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

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.

Comportement de déduplication pour les profils ayant le même horodatage deduplication-same-timestamp

Lors de l’exportation de profils vers des destinations basées sur des fichiers, la déduplication garantit qu’un seul profil est exporté lorsque plusieurs profils partagent la même clé de déduplication et le même horodatage de référence. Cet horodatage représente le moment où l’appartenance à l’audience ou le graphique d’identité d’un profil a été mis à jour pour la dernière fois. Pour plus d’informations sur la mise à jour et l’exportation des profils, consultez le document comportement d’exportation des profils.

Considérations principales

Tenez compte des données suivantes, où la clé de déduplication est la colonne Email :

Après déduplication, le fichier d'export contiendra :

Explication : par test1@test.com, les deux profils partagent la même clé de déduplication et le même horodatage. L’algorithme trie les valeurs des colonnes first_name et last_name de manière lexicographique. Puisque les prénoms sont identiques, l'égalité est résolue en utilisant la colonne last_name, où « Doe » vient avant « Morris ».

Fiabilité améliorée : ce processus de déduplication mis à jour garantit que les exécutions successives avec les mêmes coordonnées produiront toujours les mêmes résultats, ce qui améliore la cohérence.

Exporter des tableaux par le biais de champs calculés export-arrays-calculated-fields

Certains clients bêta peuvent exporter des objets de tableau depuis l’Experience Platform vers des destinations d’espace de stockage. En savoir plus sur l’exportation de tableaux et de champs calculés et contactez votre représentant d’Adobe pour accéder à la fonctionnalité.

Limites connues known-limitations

La nouvelle page Mappage présente les limitations connues suivantes :

L’attribut d’appartenance à une audience ne peut pas être sélectionné par le biais du workflow de mappage

En raison d’une limitation connue, vous ne pouvez actuellement pas utiliser la fenêtre Sélectionner un champ pour ajouter segmentMembership.seg_namespace.seg_id.status à vos exportations de fichiers. Vous devez plutôt coller manuellement la valeur xdm: segmentMembership.seg_namespace.seg_id.status dans le champ de schéma, comme illustré ci-dessous.

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

En savoir plus sur le comportement d’exportation de profils pour les destinations basées sur des fichiers.

Les espaces de noms d’identité ne peuvent actuellement pas être sélectionnés pour les exportations.

La sélection des espaces de noms d’identité à exporter, comme illustrée dans l’image ci-dessous, n’est actuellement pas prise en charge. La sélection des espaces de noms d’identité à exporter entraîne une erreur dans l’étape Révision.

En tant que solution temporaire, si vous devez ajouter des espaces de noms d’identité aux fichiers exportés au cours de la version bêta, vous pouvez effectuer l’une des opérations suivantes :

Sélectionner des attributs de profil select-attributes

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

IMPORTANT

En raison d’une limitation connue, vous ne pouvez actuellement pas utiliser la fenêtre Sélectionner un champ pour ajouter segmentMembership.seg_namespace.seg_id.status à vos exportations de fichiers. Au lieu de cela, vous devez coller manuellement la valeur xdm: segmentMembership.seg_namespace.seg_id.status dans le champ de schéma, comme illustré ci-dessous.

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

Sélectionner les attributs d’enrichissement select-enrichment-attributes

Les attributs d’enrichissement correspondent aux audiences chargées personnalisées ingérées dans Experience Platform en tant que Chargements personnalisés. Au cours de cette étape, vous pouvez sélectionner les attributs à exporter vers votre destination, pour chaque audience externe sélectionnée.

Pour sélectionner des attributs d’enrichissement pour chaque audience externe, procédez comme suit :

Si vous souhaitez activer des audiences externes vers vos destinations sans exporter d’attribut, activez le bouton (bascule) Exclure les attributs d’enrichissement. Cette option exporte les profils des audiences externes, mais aucun de leurs attributs correspondants n’est envoyé à votre destination.

.

Sélectionnez Suivant pour passer à l’étape Réviser.

Réviser review

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.

Évaluation des politiques de consentement consent-policy-evaluation

Si votre organisation a acheté Adobe HealthCare Shield ou Adobe Privacy & Security Shield, sélectionnez Afficher les politiques de consentement applicables pour identifier les politiques de consentement appliquées et le nombre de profils inclus dans l'activation qui en résulte. Pour plus d’informations, consultez Évaluation des politiques de consentement.

Vérifications des politiques d’utilisation des données data-usage-policy-checks

À l’étape Révision, l’Experience Platform vérifie également les violations de la politique d’utilisation des données. Vous trouverez ci-dessous un exemple de violation de la politique. Vous ne pouvez pas terminer le workflow d’activation de l’audience tant que vous n’avez pas résolu la violation. Pour plus d’informations sur la résolution des violations de politique, consultez la section sur les violations de politique d’utilisation des données data usage policy violations dans la documentation sur la gouvernance des données .

Filtrer les audiences filter-audiences

Au cours de cette étape également, vous pouvez utiliser les filtres disponibles sur la page pour afficher uniquement les audiences dont le planning ou le mappage a été mis à jour dans le cadre de ce workflow. Vous pouvez également activer/désactiver les colonnes du tableau à afficher.

Si vous êtes satisfait(e) de votre sélection et qu’aucune violation de politique n’a été détectée, sélectionnez Terminer pour confirmer votre sélection et commencer à envoyer des données à la destination.

Vérifier l’activation de l’audience verify

Lors de l’exportation d’audiences vers des destinations d’espace de stockage, Adobe Experience Platform crée un fichier .csv, .json ou .parquet à l’emplacement de stockage indiqué. Attendez-vous à ce qu’un nouveau fichier soit créé dans votre emplacement de stockage selon le planning défini dans le workflow. Le format de fichier par défaut est illustré ci-dessous, mais vous pouvez modifier les composants du nom de fichier :
<destinationName>_segment<segmentID>_<timestamp-yyyymmddhhmmss>.csv

Par exemple, si vous avez sélectionné une fréquence d’exportation quotidienne, les fichiers que vous recevrez pendant trois jours consécutifs peuvent ressembler à ceci :

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.