> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/developers-guides/fr/pass-architecture/structure.md).
# Structure
## Structure
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.
{% hint style="info" %}
The Wallet Crew adopte un modèle axé sur la confidentialité. Les données personnelles ne sont pas stockées par défaut. La plateforme stocke des identifiants externes et, lorsque nécessaire, des valeurs limitées non sensibles telles que des métadonnées ou des données supplémentaires.
{% endhint %}
Exemples concrets
* Une Carte de fidélité peut utiliser un ID client CRM comme identifiant externe, un `storeId` comme métadonnées, et un message de campagne comme données supplémentaires.
* Une Carte de billetterie peut utiliser un ID de billet provenant 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 que contient une Carte
Une Carte est constituée de plusieurs blocs de données. Chaque bloc a un objectif différent.
* **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 source utilisées pour construire la Carte.
### Informations générales
La section générale contient les détails principaux de l'enregistrement de 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.
*Les informations générales aident à confirmer l'état actuel de la Carte et le modèle qu'elle utilise.*
### Identifiants externes
Les identifiants externes relient une Carte à un ou plusieurs systèmes connectés. Ils rendent possible la récupération des données nécessaires pour construire 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.
Les identifiants sont stockés sous forme de paires clé-valeur. Cela permet d'associer la bonne référence à chaque système source.
*Utilisez les identifiants externes lorsqu'une Carte doit rester liée à un système source.*
### 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 sur les Cartes liées à une seule boutique.
*Utilisez les métadonnées lorsque la valeur doit prendre en charge le filtrage, le ciblage ou le reporting.*
### Données supplémentaires
Les données supplémentaires sont des informations optionnelles au niveau de la Carte. Elles ne sont pas requises 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 du portefeuille. Un message de bienvenue personnalisé est un exemple courant.
*Utilisez les données supplémentaires lorsque la valeur enrichit la Carte sans devoir déterminer la sélection de l'audience.*
### Données externes
Les données externes montrent les informations source 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.
*Utilisez les données externes pour inspecter les valeurs sources brutes derrière une Carte.*
### Choisir le bon type de champ
Choisir le bon type de champ permet de garder le modèle de Carte propre et maintenable.
* Utilisez **les identifiants externes** pour relier la Carte à un système source.
* Utilisez **les métadonnées** pour segmenter les Cartes.
* Utilisez **les données supplémentaires** pour enrichir les Cartes sélectionnées.
* Utilisez **les données externes** pour valider la charge utile source.
### FAQ
The Wallet Crew stocke-t-il des données personnelles sur l'enregistrement de Carte ?
Pas par défaut. The Wallet Crew stocke des identifiants externes et peut stocker, lorsque nécessaire, des valeurs limitées non sensibles telles que des métadonnées ou des données supplémentaires.
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 enrichir 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.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.thewalletcrew.io/developers-guides/fr/pass-architecture/structure.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.