Les tags sont l’un des outils les plus utiles que Pushwoosh propose, permettant une gamme de fonctionnalités sophistiquées. En utilisant les tags, vous pouvez segmenter votre audience et envoyer des notifications push ciblées à des utilisateurs spécifiques en fonction de leurs attributs.
Les tags peuvent contenir toutes les données arbitraires associées à un utilisateur ou un appareil particulier. Ces données peuvent inclure des noms d’utilisateur, des identifiants, des villes, des équipes de football préférées, des catégories d’actualités préférées, ou toute autre information pertinente sur vos utilisateurs.
Commencez par identifier les besoins de votre entreprise et déterminez comment vous souhaitez segmenter votre audience. Prenez en compte des facteurs tels que l’âge, la localisation, l’historique des achats in-app, ou tout autre critère pertinent pour cibler les utilisateurs.
Les valeurs des tags peuvent vous aider à rendre vos campagnes push plus intelligentes. Chaque tag est capable de stocker un nombre quasi illimité de valeurs. Fondamentalement, cela signifie qu’un seul tag suffirait pour enregistrer un type spécifique d’information sur chaque utilisateur final dans votre base de données.
Il n’y a que quelques tags disponibles pour chaque compte, mais compte tenu de l’espace quasi infini pour chaque tag, quelques tags suffisent pour recueillir une énorme quantité d’informations sur vos utilisateurs et mettre en place des modèles de ciblage très complexes.
Chaque type de Tag a un ensemble spécifique d’opérateurs applicables. Les opérateurs de tags définissent la relation entre le Tag et ses valeurs à des fins de segmentation.
is, is not, are, not in, not set, anyis, is not, are, not in, not set, anyin, not in, not set, anyis (true/false), not set, anyexactly on, on or after, on or before, between, not set, anyis, is not, greater or equals, less or equals, between, in, not in, not set, anyis, is not, greater or equals, less or equals, between, in, not in, not set, anyCe paramètre décrit le comportement des tags par rapport à différentes applications dans le même compte. Les tags spécifiques à l’application peuvent avoir différents ensembles de valeurs pour chaque application sur le même compte. Les tags non spécifiques à l’application, au contraire, stockent la même valeur pour toutes les applications qui utilisent ce Tag.
Disons que vous avez deux applications, une application d’actualités et un jeu, et que vous souhaitez cibler uniquement les utilisateurs qui ont explicitement accepté de recevoir des notifications push de votre part. Vous créez donc un tag booléen appelé « Subscribed » et définissez la valeur "true" pour les utilisateurs qui souhaitent recevoir des notifications push de votre part, et "false" pour ceux qui ne veulent pas être notifiés.
Une de vos utilisatrices, Anna, a installé vos deux applications. Elle accepte d’être notifiée des dernières nouvelles, mais a refusé toutes les notifications push de l’application de jeu.
Si le tag « Subscribed » est spécifique à l’application, tout se passera comme prévu. Cependant, si ce tag était non spécifique à l’application, alors chacune de vos applications écraserait la valeur définie par l’autre application, ce qui pourrait ruiner votre ciblage et causer de la frustration.
D’un autre côté, les tags non spécifiques à l’application peuvent être utiles si vous souhaitez effectuer un ciblage inter-applications et suivre les utilisateurs qui ont le même nom d’utilisateur dans différentes applications.
Tous les Tags dans Pushwoosh sont spécifiques à l’utilisateur par conception et sont assignés à tous les appareils de l’utilisateur lorsqu’ils sont définis par UserID au lieu de HWID.
{ "request":{ "application": "XXXXX-XXXXX", // Code d'application Pushwoosh "userId": "l'id d'un utilisateur spécifique", "tags": { "UserSpecificStringTag": "valeur de chaîne", "UserSpecificIntegerTag": 42 } }}Ces tags sont disponibles par défaut avec Pushwoosh, vous n’avez donc pas à les définir manuellement (et, en fait, vous ne devriez pas). La plupart d’entre eux sont définis depuis l’application et envoyés à notre serveur via registerDevice et d’autres appels API, et certains sont définis par le serveur lui-même.
| Nom | Type | Défini où | Description |
|---|---|---|---|
| Application Version | Version | SDK | Version actuelle de l’application installée sur un appareil |
| Browser Type | String | SDK | Lorsqu’un appareil est enregistré pour votre projet web, son type – mobile ou ordinateur – est suivi automatiquement |
| City | String | Serveur | Dernière localisation géographique enregistrée d’un appareil |
| Country | String | Serveur | Dernière localisation géographique enregistrée d’un appareil |
| Device Model | String | SDK | Indique le modèle de l’appareil sur lequel l’application est installée |
| First Install | Date | Serveur | Indique le moment où un appareil a été enregistré pour les notifications pour la première fois |
| In-App Product | List | SDK | Les produits in-app achetés par un utilisateur de l’application |
| Last In-App Purchase Date | Date | SDK | La date du dernier achat in-app effectué sur un appareil |
| Language | String | SDK | Abréviation de deux lettres en minuscules de la locale d’un appareil selon la norme ISO-639-1 ; prise des paramètres de l’appareil |
| Last Application Open | Date | Serveur | L’heure du lancement le plus récent de l’application sur un appareil |
| OS Version | Version | SDK | La version du système d’exploitation fonctionnant sur un appareil |
| Platform | String | SDK | La plateforme sur laquelle l’utilisateur utilise votre projet. |
| Push Alerts Enabled | Boolean | SDK | Indique si les alertes push sont autorisées dans les paramètres de l’appareil |
| SDK Version | Version | SDK | La version du SDK Pushwoosh implémentée sur un appareil |
| Unsubscribed Emails | Boolean | SDK | Indique si un utilisateur s’est désabonné de la réception d’e-mails de votre application |
C’est ici que votre créativité entre en jeu pour atteindre vos objectifs commerciaux spécifiques. Des tags personnalisés peuvent être créés en fonction de la logique de segmentation ou du modèle de ciblage approprié à vos besoins commerciaux uniques. Collaborez avec votre équipe marketing pour définir les tags personnalisés supplémentaires nécessaires à vos campagnes.
Vous pouvez ajouter un nouveau tag dans le Panneau de Contrôle Pushwoosh ou utiliser la méthode /addTag.
POST https://api.pushwoosh.com/json/1.3/addTag
Crée un tag dans votre compte.
| Nom | Type | Description |
|---|---|---|
| auth* | string | Jeton d’accès API depuis le Panneau de Contrôle Pushwoosh. |
| tag* | object | Paramètres du tag. |
| tag.name* | string | Nom du tag. |
| tag.type* | integer | Type de tag. Voir les valeurs possibles ci-dessous. |
| tag.application_specific | boolean | Définit si la valeur du tag doit être différente pour plusieurs applications ou être la même pour toutes les applications. |
{ "status_code": 200, "status_message": "OK", "response": { "result": true }}{ "request": { "auth": "yxoPUlwqm…………pIyEX4H", // requis, jeton d'accès API depuis le Panneau de Contrôle Pushwoosh "tag": { "name": "TAG_NAME", // requis "type": 1, // requis, voir les valeurs possibles ci-dessous "application_specific": true, // ou 'false', optionnel. Définit si la valeur du tag doit être différente pour plusieurs applications ou être la même pour toutes les applications "user_specific": true // ou 'false', optionnel, utilisé pour les tags application_specific } }}Types de valeurs de tag possibles :
Une fois que vous avez ajouté et configuré un tag, il est prêt à commencer à collecter des informations auprès de vos utilisateurs. Suivez ces étapes pour l’implémenter :
setTags pour assigner des tags et collecter des données utilisateur.Vous trouverez ci-dessous des exemples d’implémentation pour différents frameworks utilisant la fonction setTags.
iOS Native
NSDictionary *tags = @{ @"Alias" : aliasField.text, @"FavNumber" : @([favNumField.text intValue]), @"price" : [PWTags incrementalTagWithInteger:5], @"List" : @[ @"Item1", @"Item2", @"Item3" ]};
[[PushNotificationManager pushManager] setTags:tags];Android Native
pushwoosh.setTags(Tags.intTag("intTag", 42));Cordova
PushNotification.prototype.setTags = function( config, success, fail )Flutter
Future<void> setTags(Map tags) async { await _channel.invokeMethod("setTags", {"tags" : tags});}React Native
pushNotification.setTags({ "string_tag" : "Hello world", "int_tag" : 42, "list_tag":["hello", "world"]});Unity
Définit un Tag de type Integer pour l’appareil.
public virtual void SetIntTag(string tagName, int tagValue)Définit un Tag de type String pour l’appareil.
public virtual void SetStringTag(string tagName, string tagValue)Définit un Tag de type List pour l’appareil.
public virtual void SetListTag(string tagName, List<object> tagValues)Unreal Engine
FPushwooshModule& pushwoosh = FPushwooshModule::Get();pushwoosh.SetTags("{ \"intTag\" : 1, \"stringTag\" : \"example\", \"listTag\" : [ \"a\", \"b\", \"c\" ] }");Expo
Pushwoosh.setTags({ "key": keyValue, "value": inputValue });.NET MAUI
NSDictionary *tags = @{ @"Alias" : aliasField.text, @"FavNumber" : @([favNumField.text intValue]), @"price" : [PWTags incrementalTagWithInteger:5], @"List" : @[ @"Item1", @"Item2", @"Item3" ]};[[PushNotificationManager pushManager] setTags:tags];Outsystems
Paramètres d’entrée
Tags – Une liste d’enregistrements de tags contenant TagName et TagValue.
TagName doit toujours être de type Text.TagValue peut être Text, Integer, Boolean, Date, etc.Bien que dans la plupart des cas (99 %), les tags soient définis depuis l’application, vous pouvez également définir des tags via l’API Pushwoosh. Voici un exemple de requête typique vers le point de terminaison /setTags :
POST https://api.pushwoosh.com/json/1.3/setTags
{ "request": { "application": "XXXXX-XXXXX", // requis, code d'application Pushwoosh "hwid": "8f65bXXXf378eXXXbeceXXX4e153XXX2", // requis, ID de l'appareil matériel utilisé dans l'API /registerDevice "tags": { // requis "StringTag": "valeur de chaîne", // Exemple d'un tag de type chaîne "IntegerTag": 42, // Exemple d'un tag de type entier "ListTag": ["string1", "string2"], // Exemple d'un tag de type liste "DateTag": "2024-10-02 22:11", // Note : l'heure doit être en UTC "BooleanTag": true // Valeurs valides : true, false } }}Pour plus de détails, consultez la documentation de l’API setTags
La localisation de l’appareil est déterminée en fonction de son adresse IP au moment où votre application a été lancée pour la dernière fois sur cet appareil. GeoIP soumet les données de localisation à Pushwoosh, et Pushwoosh enregistre la localisation reçue de GeoIP comme valeur du tag City pour un appareil particulier.
Dans certains cas, la localisation soumise par GeoIP diffère du nom de la ville — par exemple, lorsqu’elle fait référence à un quartier d’une ville ou à une autre unité administrative. Soyez prudent lorsque vous utilisez le tag City par défaut à des fins de segmentation : assurez-vous de sélectionner les valeurs appropriées.
Par exemple, si vous prévoyez de cibler des utilisateurs de Munich, vous devez le couvrir avec un ensemble de valeurs de tag City, y compris « Munich » lui-même (avec toutes les valeurs correspondantes, telles que différentes variantes d’orthographe qui pourraient être retournées par GeoIP et enregistrées comme valeurs de tag) et plusieurs zones voisines.