Les tags sont l’un des outils les plus utiles que Pushwoosh propose, permettant une gamme de fonctionnalités sophistiquées. En utilisant des 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’informations sur chaque utilisateur final de 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 (vrai/faux), 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": "l'id d'un utilisateur spécifique", "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, ne devriez pas le faire). 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 | Où il est défini | 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 l’heure à laquelle 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 depuis les 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 | Chaîne de caractères | 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 | Chaîne de caractères | 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 | Booléen | 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 | 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 |
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 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.user_specific | boolean | Si 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. Si 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": "NOM_DU_TAG", // 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 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 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 définir des tags 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 d'un tag de type chaîne de caractères "IntegerTag": 42, // Exemple d'un tag de type entier "ListTag": ["chaîne1", "chaîne2"], // Exemple d'un tag 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 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 se réfère à 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 bonnes valeurs.
Par exemple, si vous prévoyez de cibler les utilisateurs de Munich, vous devez couvrir cela 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 voisines.