Les balises sont l’un des outils les plus utiles que Pushwoosh propose, permettant une gamme de fonctionnalités sophistiquées. En utilisant des balises, vous pouvez segmenter votre audience et envoyer des notifications push ciblées à des utilisateurs spécifiques en fonction de leurs attributs.
Les balises peuvent contenir n’importe quelle donnée arbitraire associée à 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. Tenez compte de 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 de balise peuvent vous aider à rendre vos campagnes push plus intelligentes. Chaque balise est capable de stocker un nombre presque illimité de valeurs. Fondamentalement, cela signifie qu’une seule balise suffirait pour enregistrer un type spécifique d’informations sur chaque utilisateur final dans votre base de données.
Il n’y a que quelques balises disponibles pour chaque compte, mais compte tenu de l’espace quasi infini pour chaque balise, quelques balises 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 balise a un ensemble spécifique d’opérateurs applicables. Les opérateurs de balise définissent la relation entre la balise 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 balises par rapport à différentes applications dans le même compte. Les balises spécifiques à une application peuvent avoir différents ensembles de valeurs pour chaque application sur le même compte. Les balises non spécifiques à une application, au contraire, stockent la même valeur pour toutes les applications qui utilisent cette balise.
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 une balise booléenne appelée « 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.
L’une de vos utilisatrices, Anna, a installé vos deux applications. Elle accepte d’être notifiée des dernières nouvelles, mais a refusé de recevoir des notifications push de l’application de jeu.
Si la balise « Subscribed » est spécifique à l’application, tout se passera comme prévu. Cependant, si cette balise était non spécifique à l’application, alors chacune de vos applications écraserait la valeur définie par l’autre application, ce qui peut ruiner votre ciblage et causer de la frustration.
D’un autre côté, les balises non spécifiques à une 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.
Toutes les balises dans Pushwoosh sont spécifiques à l’utilisateur par conception et sont attribuées à tous les appareils de l’utilisateur lorsqu’elles sont définies 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 balises sont disponibles d’emblée avec Pushwoosh, vous n’avez donc pas à les définir manuellement (et, en fait, vous ne devriez pas). La plupart d’entre elles sont définies depuis l’application et envoyées à notre serveur via les appels API registerDevice et autres, et certaines sont définies par le serveur lui-même.
| Nom | Type | Où elle est définie | Description |
|---|---|---|---|
| Application Version | Version | SDK | Version actuelle de l’application installée sur un appareil |
| Browser Type | Chaîne de caractères | SDK | Lorsqu’un appareil est enregistré pour votre projet web, son type – mobile ou ordinateur – est suivi automatiquement |
| City | Chaîne de caractères | Serveur | Dernière localisation géographique enregistrée d’un appareil |
| Country | Chaîne de caractères | Serveur | Dernière localisation géographique enregistrée d’un appareil |
| Device Model | Chaîne de caractères | 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 | Liste | 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 | Chaîne de caractères | 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 | Chaîne de caractères | SDK | La plateforme sur laquelle l’utilisateur utilise votre projet. |
| Push Alerts Enabled | Booléen | 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 | Booléen | SDK | Indique si un utilisateur s’est désabonné de la réception d’e-mails de votre application |
C’est là que votre créativité entre en jeu pour atteindre vos objectifs commerciaux spécifiques. Des balises personnalisées peuvent être créées 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 balises personnalisées supplémentaires nécessaires pour vos campagnes.
Vous pouvez ajouter une nouvelle balise dans le Panneau de Contrôle Pushwoosh ou utiliser la méthode /addTag.
POST https://api.pushwoosh.com/json/1.3/addTag
Crée une balise dans votre compte.
| Nom | Type | Description |
|---|---|---|
| auth* | string | Jeton d’accès API depuis le Panneau de Contrôle Pushwoosh. |
| tag* | object | Paramètres de la balise. |
| tag.name* | string | Nom de la balise. |
| tag.type* | integer | Type de balise. Voir les valeurs possibles ci-dessous. |
| tag.application_specific | boolean | Définit si la valeur de la balise 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 de la balise 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 balises application_specific } }}Types de valeurs de balise possibles :
Une fois que vous avez ajouté et configuré une balise, elle est prête à commencer à collecter des informations auprès de vos utilisateurs. Suivez ces étapes pour la mettre en œuvre :
setTags pour attribuer des balises et collecter des données utilisateur.Vous trouverez ci-dessous des exemples d’implémentation pour différents frameworks utilisant la fonction setTags.
iOS Natif
NSDictionary *tags = @{ @"Alias" : aliasField.text, @"FavNumber" : @([favNumField.text intValue]), @"price" : [PWTags incrementalTagWithInteger:5], @"List" : @[ @"Item1", @"Item2", @"Item3" ]};
[[PushNotificationManager pushManager] setTags:tags];Android Natif
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 une balise de type Entier pour l’appareil.
public virtual void SetIntTag(string tagName, int tagValue)Définit une balise de type Chaîne de caractères pour l’appareil.
public virtual void SetStringTag(string tagName, string tagValue)Définit une balise de type Liste 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 balises contenant TagName et TagValue.
TagName doit toujours être de type Texte.TagValue peut être Texte, Entier, Booléen, Date, etc.Bien que dans la plupart des cas (99 %), les balises soient définies depuis l’application, vous pouvez également définir des balises via l’API Pushwoosh. Vous trouverez ci-dessous 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 de balise de type chaîne de caractères "IntegerTag": 42, // Exemple de balise de type entier "ListTag": ["string1", "string2"], // Exemple de balise de type liste "DateTag": "2024-10-02 22:11", // Remarque : 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 sur cet appareil pour la dernière fois. GeoIP soumet les données de localisation à Pushwoosh, et Pushwoosh enregistre la localisation reçue de GeoIP comme valeur de balise Ville 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 la balise Ville 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 couvrir cela avec un ensemble de valeurs de balise Ville, y compris « Munich » elle-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 balise) et plusieurs zones voisines.