- Stocker les traits utilisateur comme
subscription_tierouname - Suivre les comportements comme
purchases,clicksoulevels - Segmenter les utilisateurs pour les messages et les Journeys
- Personnaliser le contenu des messages
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 |
| Booléen | "true" / "false", "1" / "0" | Utilisez "1"/"0" pour réduire la taille de la charge utile |
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 pour plus de détails.
Tags vs Événements personnalisés
Les Tags et les Événements personnalisés 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) |
| 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) |
- 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.Tutoriels :
Configuration de panier abandonné
Récupérez les ventes perdues avec des rappels de panier abandonné.
Contenu dynamique de panier abandonné
Personnalisez vos messages de panier abandonné avec du contenu dynamique.
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. |
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 |
Utilisez l’ID externe pour identifier les utilisateurs individuels. N’utilisez pas de tags à cette fin. Voir ID externe et Alias.
Tags de personnalisation
Idéal pour la personnalisation des messages basée sur le nom en utilisant la substitution de variables.| 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 |
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.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.
API REST
Ajoutez, mettez à jour ou supprimez des tags côté serveur en utilisant notre API REST.
Journeys
Appliquez automatiquement des tags lorsque les utilisateurs progressent dans les étapes du Journey.
Importation CSV
Mettez à jour les tags utilisateur en masse en téléchargeant un CSV avec
external_id ou subscription_id.Invites de catégories web
Invitez les utilisateurs à sélectionner eux-mêmes leurs centres d’intérêt, qui sont stockés sous forme de tags.
Messages in-app
Collectez ou mettez à jour les tags en fonction des actions de clic sur les messages in-app.
Saisie manuelle
Modifiez directement les tags depuis le tableau de bord OneSignal.
- Allez dans Audience > Utilisateurs > Profil utilisateur > Tags
Intégrations tierces
Certaines intégrations prennent en charge la synchronisation automatique des tags.
- Segment, HubSpot, Mixpanel et autres
FAQ
Combien de tags puis-je définir par utilisateur ?
Cela dépend de votre forfait. Consultez les limites de votre forfait ou contactez les ventes 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 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 pour supprimer en masse
- Utilisez moins de tags, plus réutilisables (par exemple,
status:active)
Besoin d’aide ?Discutez avec notre équipe d’assistance ou envoyez un e-mail à
support@onesignal.comVeuillez 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 pertinents