Référence de mappage des destinations par lot
Cet article décrit les attributs obligatoires, les clés de déduplication, les champs calculés et les limites connues de l’étape Mappage lorsque vous activez des audiences vers des destinations d’exportation de profils par lots.
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
- 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 comme clé de déduplication
- Utiliser une combinaison de deux attributs de profil à partir d’un profil XDM en tant que clé composite
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
-
Sélection déterministe : lorsque plusieurs profils ont des clés de déduplication identiques et la même date et heure de référence, la logique de déduplication détermine le profil à exporter en triant les valeurs d’autres colonnes sélectionnées (à l’exclusion des types complexes tels que les tableaux, les mappages ou les objets). Les valeurs triées sont évaluées dans l’ordre lexicographique, et le premier profil est sélectionné.
-
Exemple de scénario
Tenez compte des données suivantes, où la clé de déduplication est la colonne Email :
test1@test.comtest1@test.comtest2@test.comAprès déduplication, le fichier d’export contiendra :
test1@test.comtest2@test.comExplication : 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.
segmentMembership.seg_namespace.seg_id.statussegmentMembership.seg_namespace.seg_id.lastQualificationTime
Les exportations de fichiers varient comme suit, selon que segmentMembership.seg_namespace.seg_id.status est sélectionné :
- Si le champ
segmentMembership.seg_namespace.seg_id.statusest sélectionné, les fichiers exportés incluent les membres actifs dans l’instantané complet initial et les nouveaux membres actifs et expirés dans les exportations incrémentielles suivantes. - Si le champ
segmentMembership.seg_namespace.seg_id.statusn’est pas sélectionné, les fichiers exportés incluent uniquement les membres actifs dans l’instantané complet initial et dans les exportations incrémentielles suivantes.
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 :
- Utiliser les destinations de stockage dans le cloud héritées pour les flux de données dans lesquels vous souhaitez inclure des espaces de noms d’identité dans les exportations.
- Charger les identités en tant qu’attributs dans Experience Platform, puis les exporter vers vos destinations de stockage dans le cloud.