# Propriétés personnalisées

Depuis la table audience, vous pouvez créer des propriétés personnalisées afin d'ajouter plus d'information sur vos membres. L'ensemble des propriétés personnalisées s'afficheront ensuite dans les colonnes de la table audience. Vous les retrouverez aussi dans le profil public des membres.

Vous pouvez retrouver la liste de vos propriétés personnalisées au clic sur l'icône `Propriétés` en haut de la table audience.&#x20;

<figure><img src="/files/MX5KDf6i5X9vFlnSo6Fp" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Les propriétés personnalisées ne sont visibles que par les admins.
{% endhint %}

## Propriété personnalisée

Pour chaque propriété personnalisée, vous pouvez afficher l'ensemble de ses caractéristiques dans un panneau latéral en cliquant :&#x20;

* Sur le nom de la propriété dans la liste des colonnes de la table audience (cliquez sur le bouton `Propriétés` à côté du bouton `Filtres` pour l'afficher).
* Sur le bouton `Gérer la propriété` dans le menu de la colonne (cliquez sur les trois points au niveau du titre de la colonne).

Dans le panneau latéral de la propriété, vous pouvez retrouver :&#x20;

* Le nom de la propriété avec un tag qui indique son type.
* Une partie `Détails` qui contient :&#x20;
  * Le slug de la propriété avec un bouton icône `Copier` qui vous permet de copier ce slug dans le presse-papier.&#x20;
  * La description de la propriété.

{% hint style="info" %}
Le slug est un label qui permet d'identifier la propriété et de la manipuler via l'API et le SSO.
{% endhint %}

* Une partie `Valeurs` (si le type de la propriété est `Sélection multiple`, `Sélection simple` ou `Booléen`) qui contient :&#x20;
  * Les différentes valeurs possibles.
  * Pour chaque valeur, le nombre de membres qui ont cette valeur pour la propriété.
* Une partie `Données liées` :&#x20;
  * Le nombre de membres qui ont une valeur pour cette propriété.
  * Le nombre de groupes intelligents basés sur cette propriété.

En bas du panneau latéral, un bouton `Modifier` vous permet d’ouvrir [le panneau latéral d’édition de la propriété.](#modifier-une-propriete)

## Créer une propriété

Pour créer une propriété, cliquez sur `Action` puis sur `Créer une propriété`. Un panneau latéral de création s'ouvre :&#x20;

* Choisissez le **type** de la propriété : `Texte`, `Sélection simple`, `Sélection multiple`, `Booléen`, `Nombre` ou `Date` - *Obligatoire.*
* Donnez un nom au **rôle** (*obligatoire*) et une **description** (*facultative*).
* Si c’est une propriété de type `Sélection simple` ou `Sélection multiple` :&#x20;
  * Deux **réponses** sont pré-créées (`Valeur 1` et `Valeur 2`) : vous pouvez les modifier, les réordonner ou les supprimer.
  * Vous pouvez ajouter des valeurs grâce au bouton `Ajouter une valeur`.
  * **Attention**, il est obligatoire d’avoir au moins 2 réponses.
* Cliquez sur `Créer`⁣ : c'est bon, votre propriété est prête à être remplie ! :clap:

## Modifier une propriété

Vous pouvez modifier une propriété. Pour cela, cliquez sur le bouton `Modifier` depuis le panneau latéral de la propriété. Un panneau latéral d'édition s'ouvre, depuis lequel vous pourrez modifier :&#x20;

* Nom de la propriété. **Attention**, si vous modifiez le nom de la propriété, le nom du slug lui ne change pas.
* Description.&#x20;
* Les valeurs de la propriété (s’il s’agit d’un `Sélection multiple`, `Sélection simple`) :
  * Si une valeur est modifiée, elle sera aussi modifiée pour les membres ayant déjà cette valeur.
  * Si une valeur est supprimée, les membres ayant cette valeur n'auront plus de valeur pour cette propriété.
  * Si une valeur est ajoutée, rien ne change pour les membres ayant déjà une valeur.

Au clic sur `Enregistrer` la propriété est modifiée.

Vous pouvez également supprimer la propriété : au clic sur `Supprimer`, une modale de confirmation s’ouvre. Si vous choisissez de supprimer cette propriété, **ce choix sera définitif et irréversible**. *À utiliser avec précaution* :wink:

{% hint style="warning" %}
Une fois la propriété créée, vous ne pouvez plus modifier son slug.
{% endhint %}

## Modifier la valeur d'une propriété

Une fois votre propriété créée, vous pouvez la remplir pour les différents membres de votre audience !&#x20;

{% hint style="info" %}
Par défaut, les membres ont des valeurs vides pour chaque propriété personnalisée créée.
{% endhint %}

Vous avez plusieurs possibilités pour modifier les valeurs d'une propriété :&#x20;

* [Depuis votre audience au sein de votre Spot.](#edition-manuelle)
* [Par le token JWT (SSO).](#edition-via-connexion-sso)
* [Par l'API.](#edition-via-api)

### Édition manuelle

**Profil d’un membre**

L'ensemble des propriétés personnalisées sont affichées dans le profil public des membres. Pour modifier la valeur d'une propriété, cliquez sur le bouton :pen\_fountain: au niveau de celle-ci. Une fenêtre s'ouvre qui vous permet de modifier cette valeur. Si le membre a déjà une valeur pour cette propriété :&#x20;

* La modale est déjà préremplie avec cette valeur.&#x20;
* Un bouton `Effacer la valeur` vous permet de supprimer cette valeur déjà existante pour le membre.

{% hint style="info" %}
Si le membre a une valeur pour une propriété, une icone :information\_source: apparaît à droite de cette valeur. Au passage de la souris sur cette icône, un tooltip vous indique comment a été renseigné cette valeur (`Manuellement`, `SSO` ou `API`).
{% endhint %}

#### Édition en masse

Depuis la table audience, vous pouvez modifier d'un coup la valeur d'une propriété pour plusieurs membres de votre Spot. Pour cela :&#x20;

* Sélectionnez les membres concernés.
* Cliquez sur le bouton `Action`.
* Cliquez sur le bouton `Modifier la valeur d'une propriété` dans le menu qui apparaît.
* Sélectionnez la propriété dont vous voulez modifier la valeur.

Une fenêtre vous permettant de modifier la valeur de cette propriété s'ouvre ! Il ne vous reste plus qu'à entrer la valeur de votre choix et cette valeur sera appliquée pour l'ensemble des membres préalablement sélectionnés.

### Édition via connexion SSO

Vous pouvez modifier la valeur des propriétés d'un membre au moment de son authentification via SSO. :point\_right: [plus d'informations ici](/manage-spot/sso.md)

### Édition via API

Vous pouvez modifier la valeur des propriétés d'un membre depuis l'API. Pour cela vous avez à votre disposition trois endpoints différents :&#x20;

* Lister les valeurs des propriétés personnalisées pour un membre.
* Modifier la valeur d'une propriété personnalisée pour un membre.
* Modifier ou ajouter une valeur de plusieurs propriétés personnalisée pour un membre.

:point\_right: [plus d'informations ici](broken://pages/pbsBphmdoZJ1MgqesE20)


---

# Agent Instructions: 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:

```
GET https://help.meltingspot.io/manage-spot/audience/membres/proprietes-personnalisees.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
