Contrôles de l’intégrité des schémas et des identités
Les contrôles d’intégrité des schémas et des identités analysent vos schémas et espaces de noms d’identité à la recherche de bonnes pratiques manquantes et d’erreurs de configuration qui entraînent une résolution d’identité incomplète, un nombre de profils exagéré et une activation inexacte.
Validation des champs d’identité identity-field-validation
Analyses visant à garantir que les champs d’identité comportent des contraintes de longueur minimale et maximale et des règles de modèle regex pour l’intégrité des données.
Lorsque vous sélectionnez la vignette Validation de champ d’identité, un panneau de détails s’ouvre à droite. Le panneau affiche les éléments suivants :
- Description : analyses pour s’assurer que les champs d’identité ont des longueurs minimale et maximale et des règles de modèle regex pour l’intégrité des données. Répertorie les schémas et champs concernés.
- Impact : si les champs d’identité des schémas n’ont pas de longueurs min./max. et de validations de modèle définies, cela peut entraîner des données incohérentes, ce qui peut compromettre l’intégrité et la qualité des données.
- Domaines généraux d’impact : identifiants de faible qualité en Identity Service ; assemblage peu fiable.
- Documentation Experience League : lien vers les bonnes pratiques pour la modélisation des données.
- Schémas affectés : une liste des schémas affectés, chacun disposant d’un expandeur pour afficher plus de détails et d’un lien pour ouvrir le schéma.
Pour plus d’informations, consultez les conseils sur l’intégrité des données dans la documentation sur les bonnes pratiques relatives aux schémas.
Règles de liaison des graphiques d’identités identity-graph-linking-rules
Vérifie que les règles de liaison des graphiques d’identités sont configurées pour un sandbox afin d’empêcher la réduction des profils.
Lorsque vous sélectionnez la vignette Règles de liaison de graphiques d’identités, un panneau de détails s’ouvre à droite. Le panneau affiche les éléments suivants :
- Description : vérifie que les règles de liaison appropriées sont configurées pour empêcher la réduction des profils. Il affiche le statut actuel des règles et les identités uniques par graphique.
- Impact : si les règles de liaison des graphiques d’identités ne sont pas définies, certaines données peuvent essayer de fusionner plusieurs profils disparates en un seul profil. Pour éviter les fusions indésirables, les configurations fournies par le biais des règles de liaison de graphiques d’identités doivent être utilisées.
- Zones générales d’impact : profils réduits ou fusionnés.
- Documentation Experience League : lien vers la présentation des règles de liaison du graphique d’identités pour plus d’informations.
- Configurer les règles de liaison : lorsque la vérification échoue, un bouton s’affiche pour que vous puissiez configurer les règles de liaison directement à partir du panneau.
Pour plus d’informations, consultez la présentation des règles de liaison de graphiques d’identités présentation et le guide d’implémentation.
Configuration des identités des personnes et des non-personnes people-non-people-identity
Valide l’utilisation correcte des types d’identité personnes et non-personnes dans les classes de schéma.
Lorsque vous sélectionnez la vignette Configuration de l’identité des personnes et des personnes autres que les personnes, un panneau de détails s’ouvre à droite. Le panneau affiche les éléments suivants :
- Description : valide l’utilisation appropriée des types d’identité dans les classes de schéma. Répertorie les schémas mal configurés et met en évidence les affectations incorrectes.
- Impact : si une entité non-personne se voit attribuer une identité de personne, cela gonfle le nombre de profils et rend ces données inéligibles dans le cadre d’une recherche. Si une entité de personne se voit attribuer une identité non-personne, les données ne sont pas disponibles pour la segmentation Edge ou en flux continu.
- Zones générales d’impact : graphiques d’identités incomplets ; nombres de profils exagérés ; mauvaise utilisation de la recherche.
- Schémas affectés : liste des schémas rencontrant des problèmes. Développez une ligne de schéma pour afficher le chemin d’accès, le nom de l’identité et le type de schéma pour chaque configuration incorrecte. Utilisez l’icône de lien pour ouvrir le schéma.
Pour plus d’informations, consultez la documentation sur les types d’identité et les bonnes pratiques relatives aux schémas.
Description de l’espace de noms d’identité personnalisé namespace-missing-description
Analyse pour s’assurer que les métadonnées et les descriptions des espaces de noms d’identité personnalisés sont complètes.
Lorsque vous sélectionnez la carte Description de l’espace de noms d’identité personnalisé, un panneau de détails s’ouvre à droite. Le panneau affiche les éléments suivants :
- Description : effectue des analyses pour s’assurer que les métadonnées et les descriptions des espaces de noms sont complètes. Affiche les espaces de noms et les propriétaires avec des champs de description vides.
- Impact : la définition d’une description sur un espace de noms d’identité personnalisé améliore la clarté en fournissant le contexte de l’objectif de chaque espace de noms. Cela permet aux membres de l’équipe et aux parties prenantes de comprendre rapidement la fonction de chaque espace de noms sans confusion.
- Zones générales d’impact : confusion du débogage ou de l’utilisation ; intention de validation peu claire.
- Documentation Experience League : lien vers la création d’espaces de noms personnalisés pour plus d’informations.
- Espaces de noms affectés : liste des espaces de noms d’identité personnalisés auxquels il manque des descriptions. Utilisez l’icône de lien en regard de chaque espace de noms pour l’afficher ou le modifier.
Pour plus d’informations, consultez la documentation sur la création d’espaces de noms personnalisés.
Espace de noms d’identité non utilisé namespace-not-in-use
Détecte les espaces de noms d’identité obsolètes ou inutilisés qui doivent être marqués pour nettoyage. Ce contrôle était auparavant documenté comme « Espace de noms d’identité obsolète ».
Lorsque vous sélectionnez la vignette Espace de noms d’identité non utilisé, un panneau de détails s’ouvre à droite. Le panneau affiche les éléments suivants :
- Description : détecte les espaces de noms d’identité obsolètes ou inutilisés pour le nettoyage. Répertorie les espaces de noms inutilisés avec la dernière date et heure d’utilisation ou la référence de schéma.
- Impact : les espaces de noms d’identité non utilisés dans un schéma doivent être marqués pour suppression en ajoutant une balise « DEPRECATED » ou « DO NOT USE » à leurs noms. La suppression des espaces de noms d’identité n’est actuellement pas prise en charge.
- Domaines généraux d’impact : risque de confusion et d’étiquetage erroné.
- Documentation Experience League : lien vers les espaces de noms d’identité obsolètes pour obtenir plus de documentation.
- Espaces de noms affectés : liste d’espaces de noms d’identité obsolètes ou inutilisés. Utilisez l’icône de lien en regard de chaque espace de noms pour l’afficher ou le gérer.
Pour plus d’informations, consultez l’article de la base de connaissances Experience Cloud sur les espaces de noms obsolètes.
Identité non-personne sur le champ de relation non-person-identity-relationship-field
Indique les champs de schéma qui contiennent à la fois un descripteur d’identité et un descripteur de relation.
Lorsque vous sélectionnez la carte Identité non-personne sur le champ de relation, un panneau de détails s’ouvre à droite. Le panneau affiche les éléments suivants :
- Description : explique que la mise en place d’un descripteur de relation sur un champ de schéma établit une jointure directe et dynamique entre deux schémas distincts. Il indique au magasin de Real-Time Customer Profile et au Audience Builder qu’un champ du schéma principal ou source agit comme une clé étrangère pointant vers un enregistrement de recherche ou de dimension dans le schéma cible. Ce contrôle recherche les champs de schéma qui contiennent à la fois un descripteur d’identité et un descripteur de relation pour le même champ.
- Impact : ces descripteurs s’excluent mutuellement et l’inclusion des deux sur le même champ est une erreur de modélisation des données. Les résultats peuvent inclure une segmentation et des activations d’audience incorrectes.
- Domaines généraux d’impact : Qualité de l’audience.
- Documentation Experience League : lien vers la composition de schémas XDM pour l’identité.
- Schémas affectés : une liste de schémas dont les champs ont des descripteurs en conflit, le cas échéant. Lorsqu’aucun problème n’est détecté, le panneau affiche une confirmation Vérification réussie à la place.
Pour plus d’informations, voir la documentation sur la composition de schémas.
Nombre de relations à entités multiples multi-entity-relationship-count
Surveille le nombre de relations à entités multiples définies dans un sandbox lorsqu’elles approchent de la limite de la plateforme.
Lorsque vous sélectionnez la carte Nombre de relations entre entités multiples, un panneau de détails s’ouvre à droite. Le panneau affiche les éléments suivants :
- Description : explique que les relations à entités multiples relient des entités principales, telles que Real-Time Customer Profiles ou ExperienceEvents, à des entités de dimension secondaires, telles que des catalogues de produits, des magasins ou des comptes professionnels. Ce contrôle vérifie si la limite de 5 relations à entités multiples définies dans le sandbox est dépassée.
- Impact : une cardinalité élevée et des jointures de schéma excessives augmentent la complexité du calcul dans le magasin de Real-Time Customer Profile. Le dépassement de la limite peut dégrader les performances de Segmentation Service et augmenter la latence d’évaluation des audiences.
- Zones générales d’impact : segmentation par lots.
- Documentation Experience League : lien vers les bonnes pratiques pour la modélisation des données.
Pour plus d’informations, consultez les bonnes pratiques de modélisation des données et le tutoriel sur la segmentation d’entités multiples.
Groupe de champs d’audit manquant missing-audit-field-group
Vérifie que les schémas XDM Individual Profile incluent le groupe de champs Détails de l’audit du système Source externe .
Lorsque vous sélectionnez la vignette Groupe de champs d’audit manquant, un panneau de détails s’ouvre à droite. Le panneau affiche les éléments suivants :
- Description : vérifie que les schémas de profil individuel XDM incluent le groupe de champs Détails de l’audit du système Source externe, obligatoire pour le suivi de la provenance des enregistrements et la mise à jour des dates et heures.
- Impact : sans champs d’audit, il n’existe aucune visibilité au niveau des enregistrements sur le moment où les données ont été ingérées dans Experience Platform, ce qui rend difficile la résolution des problèmes d’enregistrements obsolètes ou dupliqués.
- Domaines généraux d’impact : incapacité à contrôler les modifications des données externes.
- Documentation Experience League : lien vers le groupe de champs Détails de l’audit du système Source externe.
- Recommandation : si ce champ est manquant, ajoutez le groupe de champs Détails de l’audit du système Source externe .
- Schémas affectés : liste des schémas auxquels il manque le groupe de champs. Utilisez l’icône de lien en regard de chaque schéma pour l’ouvrir.
Pour plus d’informations, consultez la documentation du groupe de champs Détails de l’audit du système Source externe .
Unicité de l’identité du Principal primary-identity-uniqueness
Compare la manière dont les espaces de noms d’identité sont utilisés en tant qu’identités principales à leur définition dans les règles de liaison des graphiques d’identités.
Lorsque vous sélectionnez la vignette Identité unique du Principal, un panneau de détails s’ouvre à droite. Le panneau affiche les éléments suivants :
- Description : explique que les identités principales pilotent l’assemblage des Real-Time Customer Profiles. Les règles de liaison définissent les espaces de noms d’identité qui doivent et ne doivent pas apparaître plusieurs fois dans le même graphique d’identités. Ce contrôle compare la manière dont les espaces de noms d’identité sont utilisés comme identités principales par rapport à leur définition dans les règles de liaison des graphiques d’identités.
- Impact : le stockage des enregistrements de classe de profil avec des valeurs scalaires simples à l’aide d’une identité de profil non unique entraîne l’ignorance de tous les enregistrements sauf un lors de l’accès au profil. Deux exceptions s’appliquent : les schémas contenant uniquement des tableaux fusionnés et les cas où l’enregistrement souhaité est toujours sélectionné en fonction du moment de l’ingestion et de la politique de fusion.
- Domaines généraux d’impact : exactitude du profil, qualité de l’audience et qualité de l’activation.
- Documentation Experience League : lien vers l’aperçu des règles de liaison des graphiques d’identités.
Pour plus d’informations, consultez la présentation des règles de liaison des graphiques d’identités 🔗.
Relations à plusieurs niveaux multi-level-relationships
Détecte les relations qui ne sont pas correctement définies entre les schémas à deux dimensions.
Lorsque vous sélectionnez la vignette Relations à plusieurs niveaux, un panneau de détails s’ouvre à droite. Le panneau affiche les éléments suivants :
- Description : explique que les relations ne doivent être établies qu’entre les schémas de la classe XDM Individual Profile ou XDM ExperienceEvent et les schémas dimensionnels. Ce contrôle recherche les relations incorrectement définies entre les schémas dimensionnels.
- Impact : les chaînes de relations à plusieurs niveaux ne sont pas prises en charge et provoquent un comportement imprévisible lors de la segmentation.
- Domaines généraux d’impact : Segmentation et qualité de l’audience.
- Documentation Experience League : lien vers les bonnes pratiques pour la modélisation des données.
Pour plus d’informations, voir bonnes pratiques de modélisation des données.
Profondeur de champ d’identité du Principal primary-identity-field-depth
Vérifie que les champs d’identité principale ne sont pas imbriqués trop profondément dans la hiérarchie des champs du schéma.
Lorsque vous sélectionnez la vignette Profondeur du champ d’identité du Principal, un panneau de détails s’ouvre à droite. Le panneau affiche les éléments suivants :
- Description : explique que la profondeur du champ Identité principale fait référence à l’emplacement d’un champ d’identité principale dans la hiérarchie de champ d’un schéma XDM, ainsi qu’aux contraintes et aux bonnes pratiques qui régissent cet emplacement. Ce contrôle vérifie que les champs d’identité principale ne sont pas imbriqués de plus de quatre niveaux.
- Impact : les champs d’identité de Principal imbriqués au-delà de quatre niveaux peuvent provoquer un comportement imprévisible au niveau de l’ingestion et de la segmentation des données.
- Domaines généraux d’impact : ingestion des données, segmentation et qualité de l’audience.
- Documentation Experience League : lien vers les bonnes pratiques pour la modélisation des données.
Pour plus d’informations, voir bonnes pratiques de modélisation des données.
Duplication de groupes de champs sur plusieurs schémas duplicate-field-groups-across-schemas
Détecte les groupes de champs non identitaires qui restent actifs sur plusieurs schémas.
Lorsque vous sélectionnez la carte Dupliquer des groupes de champs dans plusieurs schémas, un panneau de détails s’ouvre à droite. Le panneau affiche les éléments suivants :
- Description : explique que Experience Platform permet l’inclusion de groupes de champs spécifiques dans plusieurs schémas. Bien qu’il s’agisse d’une utilisation normale lors de la création de schémas, il n’est pas recommandé de modéliser les données en gardant les champs individuels non identitaires visibles dans plusieurs schémas. Ce contrôle vérifie si des champs de non-identité restent actifs sur plusieurs schémas.
- Impact : l’approvisionnement de valeurs en plusieurs jeux de données pour le même champ de schéma peut rendre imprévisibles les résultats de l’audience qui testent ces champs. Les politiques de fusion peuvent minimiser ce problème, mais ne l’éliminent jamais complètement, et les variations résultantes sont souvent difficiles à déboguer.
- Domaines généraux d’impact : Segmentation et résultats des audiences.
- Documentation Experience League : lien permettant d’ajouter des groupes de champs à un schéma.
- Recommandation : modifiez les schémas à l’aide de la fonctionnalité de champs associés gérés et masquez les champs qui ne sont pas des champs d’identité dans tous les schémas sauf un.
- Groupes de champs concernés : liste des groupes de champs partagés entre les schémas, avec la référence au groupe de champs et le nom du schéma. Utilisez l’icône de lien pour ouvrir le schéma.
Pour plus d’informations, voir Ajouter des groupes de champs à un schéma.
Groupe de champs de détection de robots manquant bot-detection-field-group-missing
Vérifie que les schémas ExperienceEvent incluent le groupe de champs Informations sur la détection des robots.
botDetection.isBot à l’aide d’un signal de détection de robot, puis excluez les robots de vos segments.Lorsque vous sélectionnez la carte Groupe de champs de détection de robots manquant, un panneau de détails s’ouvre à droite. Le panneau affiche les éléments suivants :
- Description : explique que Experience Platform fournit un groupe de champs de détection des robots pour les schémas XDM ExperienceEvent. Ce groupe de champs permet de signaler le trafic non humain, tel que les robots d’exploration web, les grattoirs et les agents automatisés, au niveau de l’événement. Ce contrôle vérifie que le groupe de champs a été inclus dans le schéma ExperienceEvent selon les besoins.
- Impact : lorsque ce groupe de champs est absent des schémas ExperienceEvent qui capturent des données d’interaction web ou d’application, il n’existe pas de mécanisme normalisé permettant d’identifier les événements générés par les robots à partir de l’activité légitime des clients.
- Domaines généraux d’impact : segmentation d’audience et débit d’évaluation des performances d’audience en flux continu.
- Documentation Experience League : lien vers le groupe de champs Informations sur la détection des robots.
- Recommandation : ajoutez le groupe de champs Informations de détection des robots à chaque schéma ExperienceEvent marqué. Renseignez le champ
botDetection.isBotà l’aide d’un signal de détection de robot, puis excluez les robots de vos segments.
Pour plus d’informations, consultez la documentation du groupe de champs Informations sur la détection des robots .
Chaînes vides autorisées zero-length-strings-allowed
Vérifie que les champs de chaîne requièrent une longueur minimale d’un caractère.
Lorsque vous sélectionnez la carte Chaînes de longueur nulle autorisées, un panneau de détails s’ouvre à droite. Le panneau affiche les éléments suivants :
- Description : explique que Experience Platform autorise par défaut les valeurs nulles et les valeurs de chaîne vides lors de l’ingestion des données. Une bonne pratique consiste à interdire les valeurs de chaîne de longueur nulle en attribuant une longueur minimale d’un sur tous les champs de chaîne. Ce contrôle recherche les schémas ne disposant pas de ce paramètre de longueur minimale.
- Impact : lorsque les champs de chaîne ne disposent pas d’une contrainte de longueur minimale, des chaînes vides peuvent être ingérées, ce qui complique l’utilisation de ces données lors de la définition de l’audience, de la création SQL, des règles de Adobe Journey Optimizer et d’autres fonctionnalités.
- Domaines généraux d’impact : Qualité de l’audience.
- Documentation Experience League : lien vers les bonnes pratiques pour la modélisation des données.
- Recommandation : ajoutez des contraintes de longueur minimale à tous les champs de chaîne.
- Schémas concernés : liste des schémas et chemins d’accès aux champs concernés. Utilisez l’icône de lien pour ouvrir le schéma.
Pour plus d’informations, voir bonnes pratiques de modélisation des données.
Tableaux sans contraintes arrays-without-constraints
Vérifie que les champs de tableau définissent les contraintes d’élément minimales et maximales.
Lorsque vous sélectionnez la carte Tableaux sans contraintes, un panneau de détails s’ouvre à droite. Le panneau affiche les éléments suivants :
- Description : explique que Experience Platform permet de spécifier des longueurs minimales et maximales pour le nombre d’éléments dans les champs du tableau. Ce contrôle vérifie si les champs de tableau ne comportent pas de contraintes sur le nombre d’éléments qu’ils peuvent contenir.
- Impact : en l’absence de contraintes de longueur minimale ou maximale définies dans le schéma, il n’existe aucune validation sur le nombre d’éléments dans un tableau lors de l’ingestion des données, ce qui peut entraîner des enregistrements d’ingestion dépassant les mécanismes de sécurisation.
- Domaines généraux d’impact : ingestion des données et qualité de l’audience.
- Documentation Experience League : lien vers les bonnes pratiques pour la modélisation des données.
Pour plus d’informations, voir bonnes pratiques de modélisation des données.
Groupe de champs de consentement manquant consent-field-group-missing
Vérifie que les schémas activés pour le profil incluent le groupe de champs Détails du consentement et des préférences .
Lorsque vous sélectionnez la vignette Groupe de champs de consentement manquant, un panneau de détails s’ouvre à droite. Le panneau affiche les éléments suivants :
- Description : explique que le groupe de champs Consentements et Préférences capture les signaux de consentement du client, tels que les préférences d’opt-in et d’opt-out pour les canaux marketing, la personnalisation et la collecte de données, dans une structure normalisée. Ce contrôle vérifie si le groupe de champs est inclus dans au moins un schéma activé pour Profil.
- Impact : lorsque ce groupe de champs est absent des schémas activés pour le profil, Experience Platform ne pouvez pas appliquer de politiques de consentement au niveau du profil à l’aide de son infrastructure de consentement native.
- Domaines généraux d’impact : Qualité de l’activation.
- Documentation Experience League : lien vers le groupe de champs Consentements et Préférences.
Pour plus d’informations, consultez la documentation du groupe de champs Consentements et préférences .
Étapes suivantes next-steps
- Revenez à la présentation des contrôles d’intégrité pour explorer d’autres catégories de contrôles.
- Découvrez les bonnes pratiques relatives aux schémas pour concevoir des modèles de données fiables.
- Comprenez règles de liaison des graphiques d’identités pour éviter la réduction du profil.
- Consultez la documentation sur les espaces de noms d’identité pour connaître les bonnes pratiques de gestion des espaces de noms.