This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Structure des données de la Carte

Comprenez comment les données de la Carte sont organisées dans The Wallet Crew, y compris les identifiants, les métadonnées, les données supplémentaires et les données externes.

Structure de données de Carte

Cette page explique comment les données de Carte sont organisées dans The Wallet Crew. Elle montre quelles valeurs sont stockées dans l’enregistrement de Carte, quelles valeurs restent dans les systèmes connectés et quand utiliser chaque type de champ.

The Wallet Crew suit un modèle axé sur la confidentialité. Ne stockez que les données nécessaires à l’expérience de Carte et au flux d’intégration. Vérifiez chaque configuration de locataire avant d’utiliser des données personnelles dans les identifiants, les métadonnées ou les données supplémentaires.

Exemples concrets
  • Une Carte de fidélité peut utiliser un ID client CRM comme identifiant externe, un storeId comme métadonnée, et un message de campagne comme données supplémentaires.

  • Une Carte de billetterie peut utiliser un ID de billet du système de billetterie, un venue champ de métadonnées pour la segmentation, et une note de surclassement de siège comme données supplémentaires.

  • Une Carte d’adhésion peut combiner plusieurs identifiants lorsque les données proviennent de plus d’un système, comme Shopify, Klaviyo et un CRM interne.

Ce qu’une Carte contient

Une Carte est composée de plusieurs blocs de données. Chaque bloc remplit une fonction différente.

  • Informations générales décrit l’enregistrement de Carte lui-même.

  • Identifiants externes relient la Carte à d’autres systèmes.

  • Métadonnées prend en charge la segmentation et le ciblage.

  • Données supplémentaires enrichit la Carte lorsqu’aucun système source ne fournit la valeur.

  • Données externes montre les données sources utilisées pour construire la Carte.

Informations générales

La section générale contient les détails de l’enregistrement principal de la Carte. Elle inclut la date de création, la date de dernière mise à jour, l’état d’Apple Wallet et de Google Wallet, ainsi que le type de Carte.

Le type de Carte est la seule valeur de cette section qui peut être modifiée manuellement.

Pass general information, including creation date, update date, wallet status, and pass type
Vérifiez les dates de création et de mise à jour, l’état d’Apple Wallet et de Google Wallet, ainsi que le type de Carte, qui est la seule valeur ici pouvant être modifiée manuellement.

Identifiants externes

Les identifiants externes relient une Carte à un ou plusieurs systèmes connectés. Ils permettent de récupérer les données nécessaires à la création de la Carte sans stocker ces données personnelles dans The Wallet Crew.

Une seule Carte peut contenir plusieurs identifiants. Chaque identifiant correspond à un point d’intégration spécifique, comme Shopify, Klaviyo ou Cegid Y2.

List of external identifiers attached to a pass
Vérifiez qu’un identifiant est présent pour chaque système connecté dont dépend la Carte.

Les identifiants sont stockés sous forme de paires clé-valeur. Cela permet d’associer la bonne référence à chaque système source.

Form used to add an external identifier to a pass
Vérifiez que la clé de l’identifiant correspond à la clé attendue par le système source avant de l’enregistrer.

Métadonnées

Les métadonnées sont utilisées pour segmenter les Cartes. Elles aident à regrouper les Cartes selon des critères opérationnels ou marketing.

Par exemple, un storeId champ de métadonnées peut séparer les Cartes par emplacement. Cela permet de cibler une notification push pour les Cartes liées à une seule boutique.

Metadata fields used to segment passes
Vérifiez que les champs nécessaires au filtrage, au ciblage et au reporting sont présents dans les métadonnées.

Données supplémentaires

Les données supplémentaires sont des informations facultatives au niveau de la Carte. Elles ne sont pas nécessaires pour créer la Carte et ne sont pas destinées à la segmentation.

Ces données sont utiles lorsqu’une valeur n’existe pas dans un système connecté, mais améliore tout de même l’expérience Wallet. Un message de bienvenue personnalisé est un exemple courant.

Additional data attached to a pass for wallet enrichment
Vérifiez que les valeurs conservées uniquement sur la Carte, comme un message de bienvenue, apparaissent ici plutôt que dans les métadonnées.

Données externes

Les données externes affichent les informations sources utilisées pour construire la Carte. Elles aident à vérifier quelles valeurs ont été collectées et quel système connecté les a fournies.

Cette vue est utile pour la validation et le dépannage. Elle facilite la confirmation que la Carte reçoit les données attendues avant ou après une mise à jour.

External data used to build a pass and its source systems
Vérifiez quel système connecté a fourni chaque valeur brute derrière la Carte.

Choisir le bon type de champ

Choisir le bon type de champ permet de conserver un modèle de Carte propre et maintenable.

  • Utilisation des identifiants externes pour relier la Carte à un système source.

  • Utilisation métadonnées pour segmenter les Cartes.

  • Utilisation données supplémentaires pour enrichir certaines Cartes.

  • Utilisation données externes pour valider la charge utile source.

FAQ

The Wallet Crew stocke-t-il des données personnelles dans l’enregistrement de Carte ?

Le modèle de Carte prend en charge les identifiants, les métadonnées et les données supplémentaires. Ne stockez des données personnelles que lorsque le cas d’usage et la configuration du locataire l’exigent.

Quelle est la différence entre les métadonnées et les données supplémentaires ?

Les métadonnées sont conçues pour la segmentation. Les données supplémentaires sont conçues pour l’enrichissement de la Carte. Si une valeur doit être utilisée pour le ciblage ou le filtrage, elle doit figurer dans les métadonnées.

Une seule Carte peut-elle être connectée à plusieurs systèmes ?

Oui. Une seule Carte peut contenir plusieurs identifiants externes. Chaque identifiant peut représenter un système connecté différent.

Mis à jour