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

Présentation overview

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

Conditions préalables prerequisites

Pour activer les audiences vers les destinations, doit être connecté à 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’exportation 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 de vos fichiers exportés. En savoir plus sur la configuration de formatage de fichier pour les fichiers CSV.

Sélectionnez le format de fichier souhaité pour l’exportation lors de la création d’une connexion à la destination basée sur les fichiers.

Sélectionner votre destination select-destination

Sélectionner vos audiences select-audiences

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

Vous pouvez sélectionner plusieurs types d’audiences, selon leur origine :

Planifier l’export d’audience scheduling

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 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 export de fichier. Vous pouvez modifier la planification par défaut selon vos besoins, en cliquant sur l’icône en forme de crayon en regard de chaque planification, puis en définissant une planification personnalisée.

Exporter des fichiers complets export-full-files

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 l’audience sélectionnée.

Exporter des 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 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

Pour la plupart des destinations, les noms de fichier par défaut se composent du nom de destination, de l’ID 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 de fichier, sélectionnez l’icône représentant un 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 :

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

Une fois la configuration de toutes vos audiences terminée, 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": "johndoe_2@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_1@example.com"
      },
      {
        "id": "johndoe_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 qui s’est qualifié pour l’audience, c’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 qui s’est qualifié pour l’audience, c’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.

[Beta]{class="badge informative"} Exporter des tableaux par le biais de champs calculés export-arrays-calculated-fields

Certains clients bêta peuvent exporter des objets de tableau d’Experience Platform vers des destinations de stockage dans le cloud. Pour en savoir plus sur l’ export 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é via le 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é ou non :

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

Les attributs d’enrichissement correspondent à des audiences téléchargées personnalisées ingérées dans Experience Platform sous la forme de télé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.

Suivez les étapes ci-dessous pour sélectionner les attributs d’enrichissement pour chaque audience externe :

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

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

Révision 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 la section Évaluation de la stratégie de consentement .

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

À l’étape Réviser, Experience Platform recherche également toutes les violations de stratégie 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 façon de résoudre les violations de stratégie, reportez-vous à la section Violations de stratégie d’utilisation des données de la documentation sur la gouvernance des données.

Filtrage des audiences filter-audiences

En outre, au cours de cette étape, vous pouvez utiliser les filtres disponibles sur la page pour afficher uniquement les audiences dont le planning ou le mapping a été mis à jour dans le cadre de ce workflow. Vous pouvez également basculer entre les colonnes du tableau que vous souhaitez afficher.

Si votre sélection vous satisfait et qu’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 de l’audience verify

Lors de l’exportation d’audiences vers des destinations de stockage dans le cloud, Adobe Experience Platform crée un fichier .csv, .json ou .parquet dans l’emplacement de stockage que vous avez fourni. 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.