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

Vue d’ensemble overview

Cet article explique le processus requis pour activer des audiences en Adobe Experience Platform de 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.

Comprendre le comportement d’exportation planifiée export-behavior

Les exportations planifiées incluent les données d’instantané d’audience, ainsi que les modifications incrémentielles de profil ou d’identité qui se produisent entre la création de l’instantané et l’heure d’exportation. Cela diffère des exportations à la demande, qui utilisent uniquement des données d’instantané.

Le tableau suivant met en évidence les différences entre les exportations planifiées et les exportations à la demande, en particulier en termes de fraîcheur des données et d’utilisation prévue :

Si les profils sont mis à jour après l’évaluation de l’audience, les exportations planifiées incluront les valeurs d’attribut mises à jour même si l’appartenance à l’audience a été déterminée au moment de l’évaluation.

Exemple : une audience pour « profils dont l’ID de vente au détail est nul » peut exporter des profils dont l’ID de vente au détail est renseigné si ce champ a été mis à jour après l’évaluation, mais avant l’exportation planifiée.

Recommandations

Pour les exportations à la demande, consultez la documentation sur exportation de fichiers à la demande.

Exporter des fichiers incrémentiels export-incremental-files

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 Experience 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 la manière dont les profils sont dédupliqués. Lorsqu’il existe plusieurs enregistrements pour la même personne, la déduplication garantit que seul le dernier enregistrement est exporté.

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 :Experience 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@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@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’export 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 key-considerations

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.

Effectuer des transformations de données via des champs calculés calculated-fields

Vous pouvez utiliser le contrôle Champs calculés pour effectuer diverses transformations de données sur les données exportées vers des destinations basées sur des fichiers.

Limites connues known-limitations

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

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

En raison d’une limitation connue, vous ne pouvez actuellement pas utiliser la fenêtre Sélectionner le champ pour ajouter des 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. identity-namespaces-export-limitation

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 Beta, 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 le champ pour ajouter des 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.

[Beta]{class="badge informative"} Exporter des tableaux et des objets à partir d’attributs d’enrichissement export-arrays-enrichment-attributes

Lors de l’exportation d’audiences vers des destinations d’espace de stockage avec une sortie JSON ou Parquet et le bouton Exporter des tableaux, des mappages et des objets ​​activé, vous pouvez exporter des structures de données complexes, y compris des tableaux entiers ou des champs sélectionnés à partir de tableaux d’objets, en tant qu’attributs d’enrichissement.

L’étape Attributs d’enrichissement affiche une interface de mappage à deux colonnes :

Cette fonctionnalité n’est disponible que lorsque toutes les conditions suivantes sont remplies :

Exporter un tableau entier export-entire-array

Sélectionnez le nom de l’attribut de tableau dans l’écran de sélection des champs sources. Le champ source est renseigné avec le chemin d’accès au tableau et le champ cible est automatiquement renseigné avec le nom du tableau. La sortie exportée conserve tous les objets du tableau avec toutes leurs propriétés.

Exporter un champ unique à partir d’un tableau d’objets export-single-array-field

Lorsque vous sélectionnez une propriété imbriquée dans un tableau d’objets, le champ ​​est automatiquement renseigné avec une expression calculée transformArray à l’aide de to_object pour extraire cette propriété de chaque objet du tableau.

Par exemple, la sélection de someArray[*].amount renseigne le champ source avec :

transformArray(someArray, x -> to_object("amount", x.amount))

Le champ cible est automatiquement renseigné avec le nom du nœud feuille (amount). Vous pouvez modifier le nom du champ cible si vous le souhaitez.

Exporter plusieurs champs d’un tableau d’objets export-multiple-array-fields

Pour exporter plusieurs propriétés à partir du même tableau d’objets, suivez ce processus en deux étapes :

Par exemple, pour exporter à la fois amount et date à partir de someArray, commencez par sélectionner someArray[*].amount, puis modifiez l’expression en :

transformArray(someArray, x -> to_object("amount", x.amount, "date", x.date))

Seuls les champs que vous spécifiez sont inclus dans chaque objet dans le tableau exporté. De plus, vous pouvez modifier le nom du tableau de niveau supérieur dans votre fichier exporté si vous le souhaitez.

Réviser review

Sur la page Réviser, 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 des 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, 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 que vous avez fourni. Attendez-vous à ce qu’un nouveau fichier soit créé à l’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.