Comment ajouter des champs à un schéma ?
Vous pouvez ajouter des champs à un schéma à l’aide d’un groupe de champs de schéma. Chaque groupe de champs est compatible avec une ou plusieurs classes, ce qui permet de l’utiliser dans n’importe quel schéma qui met en œuvre une de ces classes compatibles. Bien qu’Adobe Experience Platform fournisse plusieurs groupes de champs de secteur avec leurs propres champs prédéfinis, vous pouvez ajouter vos propres champs à un schéma en créant de nouveaux groupes de champ personnalisés à l’aide de l’API ou de l’interface utilisateur.
Pour plus d’informations sur la création de groupes de champs dans l’API Schema Registry, voir le guide de point d’entrée des groupes de champs. Si vous utilisez l’interface utilisateur, consultez le tutoriel de l’éditeur de schémas.
Quelles sont les meilleures utilisations des groupes de champs par rapport aux types de données ?
Les groupes de champs sont des composants qui définissent un ou plusieurs champs dans un schéma. Les groupes de champs imposent la manière dont leurs champs apparaissent dans la hiérarchie du schéma, et présentent donc la même structure dans chaque schéma dans lequel ils sont inclus. Les groupes de champs ne sont compatibles qu’avec des classes spécifiques, identifiées par leur attribut meta:intendedToExtend
.
Les types de données peuvent également fournir un ou plusieurs champs pour un schéma. Toutefois, contrairement aux groupes de champs, les types de données ne sont pas limités à une classe particulière. Ainsi, les types de données constituent une option plus souple pour décrire des structures de données communes réutilisables sur plusieurs schémas avec des classes potentiellement différentes.
Qu’est-ce que l’ID unique d’un schéma ?
Toutes les ressources Schema Registry (schémas, groupes de champs, types de données, classes) ont un URI qui agit comme un ID unique à des fins de référence et de recherche. Lorsqu’un schéma est affiché dans l’API, il se trouve dans les attributs $id
et meta:altId
de niveau supérieur.
Pour plus d’informations, consultez la section sur l’identification des ressources dans le guide de l’API Schema Registry.
Quelle est la taille maximale d’un type de champ long ?
Un type de champ long est un entier dont la taille maximale est de 53 (+1) bits, ce qui lui donne une plage potentielle comprise entre -9007199254740992 et 9007199254740992. Cela est dû à une limitation des possibilités de représentation des entiers longs lors des mises en œuvre de JSON en JavaScript.
Pour plus d’informations sur les types de champs, consultez le document sur les Contraintes de type de champ XDM.
Qu’est-ce que meta:AltId ?
meta:altId
est l’identifiant unique d’un schéma. Le meta:altId
fournit un identifiant de référence facile à utiliser dans les appels API. Cet identifiant évite d’avoir à être codé/décodé chaque fois qu’il est utilisé comme avec le format URI JSON.
Quelles sont les restrictions d’utilisation pour un type de données de mappage ?
XDM place les restrictions suivantes sur l’utilisation de ce type de données :
- Les types de carte DOIVENT être de type objet .
- Les propriétés des types de carte NE DOIVENT PAS ÊTRE définies (en d’autres termes, ils définissent des objets « vides »).
- Les types de mappage DOIVENT inclure un champ additionnelProperties.type qui décrit les valeurs qui peuvent être placées dans le mappage, soit une chaîne, soit un entier.
- La segmentation d’entités multiples peut uniquement être définie en fonction des clés de mappage et non des valeurs.
- Les mappages ne sont pas pris en charge pour les audiences de compte.
Pour plus d’informations, consultez la restrictions d’utilisation des objets map.
Identity Management de schéma
Cette section contient les réponses aux questions courantes sur la définition et la gestion des identités dans vos schémas.
Comment définir les identités pour mon schéma ?
Dans Experience Platform, les identités sont utilisées pour identifier un sujet (généralement une personne en particulier), quelles que soient les sources de données interprétées. Elles sont définies dans les schémas en marquant les champs clés comme « Identité ». Les champs généralement utilisés pour l’identité comprennent l’adresse e-mail, le numéro de téléphone, Experience Cloud ID (ECID), l’identifiant CRM ou d’autres champs d’identification uniques.
Les champs peuvent être marqués comme identités à l’aide de l’API ou de l’interface utilisateur.
Définition des identités dans l’API
Dans l’API, les identités sont établies en créant des descripteurs d’identité. Les descripteurs d’identité signalent qu’une propriété spécifique d’un schéma est un identifiant unique.
Les descripteurs d’identité sont créés par une requête POST au point d’entrée /descriptors. Une réponse réussie renvoie un état HTTP 201 (Created) avec un objet de réponse contenant les détails du nouveau descripteur.
Pour plus d’informations sur la création de descripteurs d’identité dans l’API, consultez le document sur la section des descripteurs dans le guide de développement du Schema Registry.
Définition des identités dans l’interface utilisateur
Une fois votre schéma ouvert dans l’éditeur de schémas, sélectionnez le champ de la section Structure de l’éditeur que vous souhaitez marquer comme identité. Sous Propriétés du champ à droite, cochez la case Identité.
Pour plus d’informations sur la gestion des identités dans l’interface utilisateur, consultez la section sur la définition des champs d’identité dans le tutoriel de l’éditeur de schémas.
Mon schéma a-t-il besoin d’une identité principale ?
Les identités principales sont facultatives, car les schémas peuvent en avoir une ou aucune. Cependant, un schéma doit avoir une identité principale afin de pouvoir être utilisé dans Real-Time Customer Profile. Pour plus d’informations, consultez la section Identité du tutoriel de l’éditeur de schémas.
Activation du profil de schéma
Cette section fournit des conseils sur l’activation des schémas à utiliser avec le profil client en temps réel.
Comment activer un schéma pour l’utiliser dans Real-Time Customer Profile ?
Les schémas peuvent être utilisés dans Real-Time Customer Profile grâce à l’ajout d’une balise « union » dans l’attribut meta:immutableTags
du schéma. L’activation d’un schéma à utiliser avec Profile peut se faire à l’aide de l’API ou de l’interface utilisateur.
Activation d’un schéma existant pour Profile à l’aide de l’API
Effectuez une requête PATCH pour mettre à jour le schéma et ajoutez l’attribut meta:immutableTags
sous forme de tableau contenant la valeur « union ». Si la mise à jour se déroule correctement, la réponse affichera le schéma mis à jour qui contient désormais la balise union.
Pour plus d’informations sur l’utilisation de l’API pour activer un schéma à utiliser dans Real-Time Customer Profile, consultez le document sur les unions du guide de développement du Schema Registry.
Activation d’un schéma existant pour Profile à l’aide de l’interface utilisateur
Dans Experience Platform, cliquez sur Schémas dans le volet de navigation de gauche, et sélectionnez le nom du schéma que vous souhaitez activer dans la liste des schémas. Ensuite, dans la partie droite de l’éditeur, sous Propriétés du schéma, sélectionnez Profile pour l’activer.
Pour plus d’informations, consultez la section sur l’utilisation dans le profil client en temps réel dans le tutoriel de l’éditeur de schémas.
Lorsque les données Adobe Analytics sont importées en tant que source, le schéma créé automatiquement est-il activé pour Profile ?
Le schéma n’est pas automatiquement activé pour le profil client en temps réel. Vous devez activer explicitement le jeu de données pour Profil en fonction du schéma activé pour Profil. Consultez la documentation pour découvrir les étapes et exigences nécessaires pour activer un jeu de données à utiliser dans le profil client en temps réel.
Puis-je supprimer des schémas activés pour Profile ?
Vous ne pouvez pas supprimer un schéma une fois qu’il a été activé pour le profil client en temps réel. Une fois qu’un schéma est activé pour Profil, il ne peut pas être désactivé ni supprimé, et les champs ne peuvent pas être supprimés du schéma. Par conséquent, il est essentiel de planifier et de vérifier soigneusement la configuration du schéma avant de l’activer pour Profile. Vous pouvez toutefois supprimer un jeu de données activé pour Profil. Vous trouverez des informations ici : https://experienceleague.adobe.com/fr/docs/experience-platform/catalog/datasets/user-guide#delete-a-profile-enabled-dataset
Si vous ne souhaitez plus qu’un schéma activé pour Profile soit utilisé, il est recommandé de renommer le schéma pour inclure Ne pas utiliser ou Inactif.
Modification des schémas et restrictions
Cette section fournit des clarifications sur les règles de modification des schémas et la prévention des modifications avec rupture.
Quand un schéma commence-t-il à éviter les modifications avec rupture ?
Des modifications avec rupture peuvent être apportées à un schéma tant qu’il n’a jamais été utilisé pour la création d’un jeu de données ou activé pour être utilisé dans Real-Time Customer Profile. Une fois qu’un schéma a été utilisé pour la création d’un jeu de données ou activé pour être utilisé avec Real-Time Customer Profile, les règles de l’évolution des schémas sont strictement appliquées par le système.
Puis-je modifier directement un schéma d’union ?
Les schémas d’union sont en lecture seule et générés automatiquement par le système. Ils ne peuvent pas être modifiés directement. Les schémas d’union sont créés pour une classe spécifique lorsqu’une balise « union » est ajoutée au schéma qui met en œuvre cette classe.
Pour plus d’informations sur les unions dans XDM, consultez la section sur les unions dans le guide de l’API Schema Registry.
Comment dois-je formater mon fichier de données pour ingérer des données dans mon schéma ?
Experience Platform accepte les fichiers de données au format Parquet ou JSON. Le contenu de ces fichiers doit être conforme au schéma référencé par le jeu de données. Pour plus d’informations sur les bonnes pratiques en matière d’ingestion de fichiers de données, reportez-vous à la présentation de l’ingestion par lots.
Comment convertir un schéma en schéma en lecture seule ?
Vous ne pouvez actuellement pas convertir un schéma en lecture seule.