> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tags

> Utilisez les tags de données OneSignal pour stocker les propriétés utilisateur et suivre les événements pour une segmentation avancée et une messagerie personnalisée.

Les tags de données sont des paires clé-valeur qui vous permettent de stocker des propriétés personnalisées et de suivre le comportement des utilisateurs dans OneSignal. Ils permettent une segmentation et une personnalisation puissantes.

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/t82DSCUXShk?si=KH_u3zB2N5ci8GLT" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

Utilisez les tags pour :

* Stocker les traits utilisateur comme `subscription_tier` ou `name`
* Suivre les comportements comme `purchases`, `clicks` ou `levels`
* Segmenter les utilisateurs pour les messages et les Journeys
* Personnaliser le contenu des messages

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/Z-rYqwEUU0M?si=Qjx2dMdFXwXSuZJR" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

***

## Règles de formatage des valeurs de tags de données

Toutes les valeurs de tags doivent être des **chaînes**. Vous pouvez toujours stocker des nombres, des horodatages et des valeurs de type booléen—il suffit de les convertir en chaînes !

| Type de valeur | Exemple de format                   | Notes                                                                                      |
| -------------- | ----------------------------------- | ------------------------------------------------------------------------------------------ |
| Libellé chaîne | `"free"`, `"VIP"`                   | Pour les types d'utilisateurs, privilèges, statuts                                         |
| Nombre         | `"42"`, `"3.14"`                    | Active les filtres numériques (`supérieur à`, `inférieur à`)                               |
| Horodatage     | `"1685400000"`                      | Horodatage Unix (en secondes). À utiliser avec les [opérateurs de temps](./time-operators) |
| Booléen        | `"true"` / `"false"`, `"1"` / `"0"` | Utilisez `"1"`/`"0"` pour réduire la taille de la charge utile                             |

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/YTp-jLcajJ0?si=uSRn2cQ7Yur5MAp0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

<Warning>
  **Non pris en charge :** Tableaux, objets, valeurs imbriquées ou blobs JSON. Si vous devez stocker des données complexes, utilisez les [Événements personnalisés](./custom-events).
</Warning>

### Mots-clés restreints

Les mots-clés suivants sont restreints et ne doivent pas être utilisés comme clés de tags car ils sont utilisés en interne pour la personnalisation des messages :
`message`, `notification`, `subscription`, `user`, `template`, `app`, `org`, `dynamic_content`, `data_feed`, `journey`, `custom_data`

Voir [Personnalisation des messages](./message-personalization) pour plus de détails.

### Tags vs Événements personnalisés

Les [Tags](/docs/en/add-user-data-tags) et les [Événements personnalisés](/docs/en/custom-events) sont tous deux des moyens d'ajouter des données à vos utilisateurs. Cependant, il existe quelques différences clés :

| Fonctionnalité          |                      Tags                     |                                         Événements personnalisés                                        |
| ----------------------- | :-------------------------------------------: | :-----------------------------------------------------------------------------------------------------: |
| Utilisation des données |        Segmentation et personnalisation       | Déclencher des Journeys sans Segment, étapes Wait Until, personnalisation directement dans les Journeys |
| Rétention des données   |                     À vie                     |              30+ jours ([stockage à vie disponible](/docs/en/billing-faq#streaming-events))             |
| Format des données      |         Chaînes ou nombres clé-valeur         |                                                   JSON                                                  |
| Source des données      | SDK OneSignal, API ou intégrations (limitées) |                                    SDK OneSignal, API ou intégrations                                   |
| Accès aux données       | Segmentation et personnalisation des messages |      Personnalisation des Journeys et des modèles de messages Journey, Segmentation (Prochainement)     |

La distinction clé entre les Tags et les Événements personnalisés réside dans leur profondeur et leurs cas d'utilisation. Les tags sont des propriétés d'un utilisateur, telles que le Nom, le Statut du compte ou l'Emplacement. Les événements sont des choses que l'utilisateur a faites, comme Acheter un article, Terminer un niveau ou Inviter un ami. Les tags et les événements peuvent tous deux être utilisés pour la segmentation et la personnalisation.

En pratique, vous utiliserez probablement les deux :

* Les tags pour les propriétés utilisateur qui sont statiques et ne changent pas souvent
* Les événements personnalisés pour les scénarios en temps réel, la segmentation complexe et les flux de travail de parcours plus sophistiqués

***

## Stratégies de tags recommandées

Les tags de données doivent représenter les informations que vous souhaitez **utiliser dans les messages ou la segmentation d'audience**. Ils ne sont pas destinés à stocker des profils utilisateurs complets ou des journaux—utilisez votre base de données backend pour cela.

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/DeCnQYA21TY?si=YnAv50tpiiVdNEX7" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

### Tags de comportement basés sur les événements

Suivez les actions des utilisateurs avec des tags. Idéal pour déclencher des Journeys, des suivis ou des rappels.

| Clé               | Exemple de valeur          | Description                                                                                                             |
| ----------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `cart_update`     | `"1685400000"`             | Dernière fois que l'utilisateur a ajouté quelque chose au panier. Utilisez les [opérateurs de temps](./time-operators). |
| `last_order`      | `"1684100000"`             | Horodatage du dernier achat terminé                                                                                     |
| `amount_spent`    | `"100"`                    | Total dépensé—nombre converti en chaîne, pas de symbole monétaire                                                       |
| `social_share`    | `"2"`                      | Nombre de partages sociaux ou de parrainages                                                                            |
| `tutorial_status` | `"step2"` ou `"completed"` | Progression du tutoriel—utilisez des valeurs de chaîne lisibles ou numérotées                                           |

### Tags d'activité de jeu

Utilisés par les jeux pour personnaliser en fonction des performances de l'utilisateur.

| Clé          | Exemple de valeur | Description                   |
| ------------ | ----------------- | ----------------------------- |
| `points`     | `"1250"`          | Points d'expérience ou de jeu |
| `level`      | `"8"`             | Niveau de jeu actuel          |
| `high_score` | `"3000"`          | Score le plus élevé atteint   |

### Tags de statut de compte

Utilisez-les pour cibler les utilisateurs par niveau de compte ou changement de statut.

| Clé               | Exemple de valeur       | Description                                |
| ----------------- | ----------------------- | ------------------------------------------ |
| `user_type`       | `"free"`, `"premium"`   | Niveau d'abonnement ou d'accès             |
| `has_downgraded`  | `"1"` ou `"1685400000"` | Booléen ou horodatage de la rétrogradation |
| `user_privileges` | `"admin"`, `"guest"`    | Segmentation basée sur les rôles           |

<Note>
  Utilisez l'**ID externe** pour identifier les utilisateurs individuels. N'utilisez **pas** de tags à cette fin. Voir [ID externe](./users#external-id) et [Alias](./aliases).
</Note>

### Tags de personnalisation

Idéal pour la personnalisation des messages basée sur le nom en utilisant la [substitution de variables](./message-personalization).

| Clé          | Exemple de valeur | Description                   |
| ------------ | ----------------- | ----------------------------- |
| `first_name` | `"Jon"`           | Prénom                        |
| `last_name`  | `"Smith"`         | Nom de famille                |
| `user_name`  | `"PokeCatcher22"` | Nom d'affichage ou pseudonyme |

### Tags de localisation et démographiques

Segmentez les utilisateurs par région ou âge.

| Clé          | Exemple de valeur | Description                                                                                         |
| ------------ | ----------------- | --------------------------------------------------------------------------------------------------- |
| `region`     | `"New York"`      | Zone métropolitaine, utilisez éventuellement [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) |
| `postcode`   | `"94105"`         | Code postal                                                                                         |
| `location`   | `"Downtown LA"`   | Localisation personnalisée sous forme de chaîne                                                     |
| `birthdate`  | `"915148800"`     | Horodatage Unix en secondes (date de naissance)                                                     |
| `birth_year` | `"1998"`          | Année de naissance à quatre chiffres                                                                |
| `age_range`  | `"18-35"`         | Utile pour la segmentation générale de l'audience                                                   |

## Comment ajouter, mettre à jour et supprimer des tags

Vous pouvez gérer les tags en utilisant l'une des méthodes ci-dessous, selon votre cas d'usage et votre configuration technique.

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/e5B3nJyr_ao?si=PfVu4bHMkQJydc41" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

<br />

<Columns cols={2}>
  <Card title="Méthodes SDK (Recommandé)">
    Définissez les tags en temps réel depuis votre application ou site web pendant que les utilisateurs effectuent des actions.

    * → [Référence du SDK mobile](./mobile-sdk-reference#data-tags)
    * → [Référence du SDK web](./web-sdk-reference#data-tags)
  </Card>

  <Card title="API REST" href="/reference/update-user">
    Ajoutez, mettez à jour ou supprimez des tags côté serveur en utilisant notre API REST.
  </Card>

  <Card title="Journeys" href="./journeys-overview">
    Appliquez automatiquement des tags lorsque les utilisateurs progressent dans les étapes du Journey.
  </Card>

  <Card title="Importation CSV" href="./import">
    Mettez à jour les tags utilisateur en masse en téléchargeant un CSV avec `external_id` ou `subscription_id`.
  </Card>

  <Card title="Invites de catégories web" href="./permission-requests">
    Invitez les utilisateurs à sélectionner eux-mêmes leurs centres d'intérêt, qui sont stockés sous forme de tags.
  </Card>

  <Card title="Messages in-app" href="./in-app-messages-setup">
    Collectez ou mettez à jour les tags en fonction des actions de clic sur les messages in-app.
  </Card>

  <Card title="Saisie manuelle">
    Modifiez directement les tags depuis le tableau de bord OneSignal.

    * Allez dans **Audience > Utilisateurs > Profil utilisateur > Tags**
  </Card>

  <Card title="Intégrations tierces" href="./integrations">
    Certaines intégrations prennent en charge la synchronisation automatique des tags.

    * Segment, HubSpot, Mixpanel et autres
  </Card>
</Columns>

***

## FAQ

### Combien de tags puis-je définir par utilisateur ?

Cela dépend de votre forfait. Consultez les [limites de votre forfait](https://onesignal.com/pricing) ou [contactez les ventes](https://onesignal.com/contact) pour augmenter votre quota.

### Que se passe-t-il avec mes tags si je dépasse les limites du forfait ?

Il n'y a pas de limite au nombre de tags disponibles dans une application OneSignal. La limite s'applique au nombre de tags qui peuvent être définis sur chaque utilisateur individuel à un moment donné.

Vous **ne pouvez pas ajouter ou mettre à jour** de tags pour les utilisateurs qui sont à ou au-dessus de leur limite. Vous devez d'abord supprimer des tags, puis envoyer une deuxième requête pour en ajouter de nouveaux.

Les tags déjà définis persisteront.

Exemple :

Limite de votre forfait = 20 tags/utilisateur.

* L'utilisateur a 19 tags :
  * ✅ Ajouter 1 nouveau tag = succès
  * ❌ Ajouter 2+ nouveaux tags = échec
* L'utilisateur a 20 tags :
  * ❌ Ajouter n'importe quel nouveau tag = échec
  * ✅ Mettre à jour 1+ tag existant = succès

### Où puis-je vérifier l'utilisation des tags ?

* Tableau de bord : **Audience > Utilisateurs > Colonne Tags**
* [Exporter les utilisateurs](./exporting-data) pour une vue complète

### Comment puis-je réduire l'utilisation des tags ?

* Supprimez les tags en utilisant le SDK ou l'API
* Utilisez l'[importation CSV](./import) pour supprimer en masse
* Utilisez moins de tags, plus réutilisables (par exemple, `status:active`)

<Info>
  Besoin d'aide ?

  Discutez avec notre équipe d'assistance ou envoyez un e-mail à `support@onesignal.com`

  Veuillez inclure :

  * Les détails du problème que vous rencontrez et les étapes de reproduction si disponibles
  * Votre OneSignal App ID
  * L'External ID ou le Subscription ID le cas échéant
  * L'URL du message que vous avez testé dans le OneSignal Dashboard le cas échéant
  * Tous les [journaux ou messages d'erreur](/docs/en/capturing-a-debug-log) pertinents

  Nous serons ravis de vous aider !
</Info>

***