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 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 vos besoins métier 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 de tag peuvent vous aider à rendre vos campagnes push plus intelligentes. Chaque tag est capable de stocker un nombre de valeurs presque illimité. Fondamentalement, cela signifie qu’un seul tag suffirait pour enregistrer un type d’information spécifique sur chaque utilisateur final dans votre base de données.
Chaque type de Tag a un ensemble spécifique d’opérateurs applicables. Les opérateurs de tag 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, anyLors de la création d’un tag, vous choisissez comment ses valeurs sont stockées :
user_specific: false) : la valeur du tag est stockée par appareil (HWID). Chaque appareil du même utilisateur peut contenir une valeur différente indépendamment.user_specific: true) : la valeur du tag est stockée par utilisateur (UserID). Lorsqu’elle est définie via UserID, la valeur est appliquée à tous les appareils de l’utilisateur en une seule fois. Utile pour les attributs qui appartiennent à la personne, et non à un appareil particulier : niveau d’abonnement, points de fidélité, langue préférée.Un utilisateur a installé les versions iOS et Android de votre application. Définir un tag subscription_tier sur "premium" via son UserID l’applique immédiatement aux deux appareils. Avec un tag Général, vous devriez le définir séparément pour chaque appareil.
{ "request":{ "application": "XXXXX-XXXXX", "userId": "the id of a specific user", "tags": { "subscription_tier": "premium", "loyalty_points": 350 } }}Ces tags sont disponibles d’office 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 l’heure à laquelle 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 |
| Last Email Open | Date | Serveur | La date à laquelle l’adresse e-mail de l’appareil a enregistré pour la dernière fois un événement d’ouverture d’e-mail |
| Last Email Open Message Code | String | Serveur | Code de message de l’e-mail le plus récemment ouvert (format XXXX-XXXXXXXX-XXXXXXXX). Mis à jour à chaque événement PW_EmailOpen. Utilisez-le pour segmenter les destinataires d’une campagne e-mail spécifique par ceux qui l’ont ouvert |
| Last Email Click | Date | Serveur | La date à laquelle l’adresse e-mail de l’appareil a enregistré pour la dernière fois un clic sur un lien d’e-mail |
| Last Email Click Message Code | String | Serveur | Code de message de l’e-mail le plus récent dans lequel un lien a été cliqué (format XXXX-XXXXXXXX-XXXXXXXX). Mis à jour à chaque événement PW_EmailLinkClicked. Utilisez-le pour segmenter les destinataires d’une campagne e-mail spécifique par ceux qui ont cliqué |
| Last Email Confirm | Date | Serveur | La date de la plus récente confirmation d’abonnement Double Opt-In pour l’adresse e-mail de l’appareil |
| Bounced Email | Date | Serveur | La date à laquelle un hard bounce s’est produit pour cette adresse e-mail. Stockée en tant que Date pour permettre une segmentation temporelle, par exemple, pour exclure les utilisateurs avec des bounces récents |
| Unsubscribed Emails | Boolean | SDK | Indique si un utilisateur s’est désabonné de la réception d’e-mails de votre application |
| 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 |
C’est ici que votre créativité entre en jeu pour atteindre vos objectifs commerciaux spécifiques. Les tags personnalisés peuvent être créés en fonction de la logique de segmentation ou du modèle de ciblage approprié à vos besoins 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.user_specific | boolean | Lorsque true, la valeur du tag est stockée au niveau de l’utilisateur et partagée entre tous les appareils d’un utilisateur lorsqu’elle est définie par UserID. Lorsque false (par défaut), le tag est au niveau de l’appareil et défini par HWID. |
{ "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 "user_specific": false // optionnel. true = niveau utilisateur ; false = niveau appareil (par défaut) } }}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 attribuer 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 Entier pour l’appareil.
public virtual void SetIntTag(string tagName, int tagValue)Définit un Tag Chaîne de caractères pour l’appareil.
public virtual void SetStringTag(string tagName, string tagValue)Définit un Tag 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 tags 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 tags soient définis depuis l’application, vous pouvez également les définir 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": "string value", // Exemple de tag de type chaîne de caractères "IntegerTag": 42, // Exemple de tag de type entier "ListTag": ["string1", "string2"], // Exemple de 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 couvrir cette zone avec un ensemble de valeurs de tag City, y compris « Munich » lui-même (avec toutes les valeurs correspondantes, telles que les différentes variantes d’orthographe qui pourraient être renvoyées par GeoIP et enregistrées comme valeurs de tag) et plusieurs zones avoisinantes.