> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/data-quality/event-specification.md).

# Spécification des événements

Dans l’ *interface Event Specification* , vous pouvez définir le **schéma de vos données** et déterminer les [actions ](#validation-rule-actions)à effectuer si un événement n’est pas conforme à vos **spécifications d’événement** (également appelées règles de validation)

L’ajout de spécifications d’événement vous permet de définir le payload et les éléments attendus afin de vérifier si les données respectent ces spécifications et de repérer d’éventuelles erreurs.

Ensuite, dans la vue [Source data quality](https://doc.commandersact.com/fr/fonctionnalites/data-quality/data-quality.md) , vous pouvez définir une alerte automatique ou consulter le récapitulatif de toutes les violations des spécifications afin de les corriger à la source ou à l’aide de la fonctionnalité [Data Cleansing](https://doc.commandersact.com/fr/fonctionnalites/data-quality/data-cleansing.md) en temps réel.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-bc5791aaf6e04eff6ee22b5360fccecf5983b1c5%2FNDL1.png?alt=media" alt=""><figcaption></figcaption></figure>

Vous pouvez choisir d’ajouter un [événement standard](https://doc.commandersact.com/fr/developpeurs/tracking-and-integrations/tracking/events-reference.md) (issu du catalogue d’événements) ou une spécification personnalisée.

Le schéma des événements standard est déjà défini, mais vous pouvez le modifier en ajoutant d’autres propriétés (standard ou personnalisées).

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-af960dbfcf916157fc283adee3b03e97788fccb9%2Fndl2.png?alt=media" alt=""><figcaption></figcaption></figure>

### Créer une propriété personnalisée

Vous pouvez créer des propriétés personnalisées et les ajouter à votre spécification d’événement.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-bc1ca5cbd13bd3fd9235dd6c8428716e63e89f72%2Fndl3.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Définir précisément le type de données

* String : le type le plus utilisé, qui correspond à un format texte (ex. : name = 'ABC')
* Number : correspond à un nombre (à virgule flottante ou entier) (ex. : value = '12')
* Boolean : la propriété ne peut prendre que 2 valeurs, true ou false (ex. : paid = 'true')
* Object : correspond à un tableau de valeurs (ex. : items = shirt, pant, shoes)

#### Définir précisément le type de structure

* Default (valeur simple) : structure la plus utilisée, correspondant à une valeur unique. (ex. : name = 'ABC')
* List (tableau de valeurs) : liste de toutes les valeurs de la propriété (ex. : items = shirt, pant, pant)
* Set (tableau de valeurs uniques) : liste de valeurs uniques (ex. : items = shirt, pant)

#### Option PII

Vous pouvez définir votre propriété comme « Personal Identifiable Information (PII) », ce qui signifie qu’elle contient des informations personnelles susceptibles d’identifier un utilisateur (adresse e-mail, adresse postale, ID client…).

Si cette option est définie sur true, la propriété sera considérée comme une PII.

Si cette propriété est stockée et définie comme PII, elle sera automatiquement chiffrée en AES-256 avant d’être écrite dans la base de données.

### Actions des règles de validation

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-3de11f16e64c1cf83ad5b93b15f0853d5e9c337b%2Fndl4.png?alt=media" alt=""><figcaption></figcaption></figure>

Vous pouvez définir des réponses personnalisées aux scénarios de validation des données :

* **Propriété obligatoire manquante :** Choisissez d’accepter ou de rejeter entièrement les événements lorsqu’une propriété obligatoire est manquante.
* **Format de valeur inattendu :** Configurez le système pour omettre les propriétés qui ne correspondent pas au format attendu, ou pour accepter ou rejeter entièrement l’événement.
* **Événements non spécifiés :** Vous pouvez accepter les événements qui ne sont pas prédéfinis dans votre schéma. Vous pouvez également décider si cette action doit déclencher un avertissement dans le rapport Source Data Quality.
* **Propriétés non spécifiées :** Choisissez d’omettre les propriétés non définies ou de les accepter, avec ou sans avertissement.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.commandersact.com/fr/fonctionnalites/data-quality/event-specification.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
