Tags

Les tags sont l’un des outils les plus utiles que Pushwoosh propose, permettant un éventail 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 favorites, des catégories d’actualités préférées, ou toute autre information pertinente sur vos utilisateurs.

Commencez par identifier vos besoins commerciaux 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 presque illimité de valeurs. Fondamentalement, cela signifie qu’un seul tag suffirait pour enregistrer un type d’information spécifique 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 quantité énorme d’informations sur vos utilisateurs et mettre en place des schémas de ciblage très complexes.

• Entier — utilisé pour les données de type entier (montant de la monnaie virtuelle acquise, niveau atteint, âge).
• Chaîne de caractères — utilisé pour les valeurs de type chaîne de caractères (nom d’utilisateur, e-mail, identifiants).
• Liste — identique au type Chaîne de caractères, mais chaque utilisateur peut avoir plusieurs valeurs définies simultanément (préférences musicales, catégories d’actualités, préférences culinaires).
• Booléen — tag de type vrai / faux.
• Date — utilisé pour les dates calendaires. Il s’agit essentiellement d’un tag de type entier qui stocke les horodatages Unix Epoch (automatiquement convertis depuis/vers la date grégorienne).
• Prix — permet de définir des valeurs selon la devise spécifiée au format « *.XX » En savoir plus.
• Version — utilisé pour le versioning. L’exemple de format autorisé est w.x.y.z (Majeur.Mineur.Patch.Build). La valeur maximale pour chaque partie de la version est 9999, donc le numéro de version maximal ne peut pas être supérieur à 9999.9999.9999.9999.

Chaque type de Tag dispose d’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.

• Opérateurs de Tag Entier : est, n'est pas, sont, n'est pas dans, non défini, n'importe lequel
• Opérateurs de Tag Chaîne de caractères : est, n'est pas, sont, n'est pas dans, non défini, n'importe lequel
• Opérateurs de Tag Liste : dans, n'est pas dans, non défini, n'importe lequel
• Opérateurs de Tag Booléen : est (vrai/faux), non défini, n'importe lequel
• Opérateurs de Tag Date : exactement le, le ou après le, le ou avant le, entre, non défini, n'importe lequel
• Opérateurs de Tag Prix : est, n'est pas, supérieur ou égal à, inférieur ou égal à, entre, dans, n'est pas dans, non défini, n'importe lequel
• Opérateurs de Tag Version : est, n'est pas, supérieur ou égal à, inférieur ou égal à, entre, dans, n'est pas dans, non défini, n'importe lequel

Ce paramètre décrit le comportement des tags par rapport aux différentes applications d’un même compte. Les tags spécifiques à une application peuvent avoir des ensembles de valeurs différents pour chaque application sur le même compte. Les tags non spécifiques à une application, au contraire, stockent la même valeur pour toutes les applications qui utilisent ce Tag.

Supposons que vous ayez deux applications, une application d’actualités et un jeu, et que vous souhaitiez 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 vos notifications push, et "false" pour ceux qui ne le souhaitent pas.

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 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, ce qui pourrait ruiner votre ciblage et causer de la frustration.

D’un autre côté, les tags non spécifiques à une application peuvent s’avérer 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'identifiant d'un utilisateur spécifique",
      "tags": {
           "UserSpecificStringTag": "valeur de chaîne",
           "UserSpecificIntegerTag": 42
      }
   }
}

Ces tags sont disponibles d’office avec Pushwoosh, vous n’avez donc pas à (et, en fait, ne devriez pas) les définir manuellement. La plupart sont définis depuis l’application et envoyés à notre serveur via les appels API registerDevice et autres, et certains sont définis par le serveur lui-même.

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 schéma 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 configuration Pushwoosh ou utiliser la méthode /addTag.

POST https://api.pushwoosh.com/json/1.3/addTag

Crée un tag dans votre compte.

{
    "status_code": 200,
    "status_message": "OK",
    "response": {
        "result": true
    }
}

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // requis, jeton d'accès API du Panneau de configuration Pushwoosh
    "tag": {
      "name": "TAG_NAME", // requis
      "type": 1, // requis, voir les valeurs possibles ci-dessous
      "application_specific": true, // ou 'false', facultatif. Définit si la valeur du tag doit être différente pour plusieurs applications ou identique pour toutes.
      "user_specific": true // ou 'false', facultatif, utilisé pour les tags application_specific
    }
  }
}

Types de valeurs de tag possibles :

• 1 - Entier
• 2 - Chaîne de caractères
• 3 - Liste
• 4 - Date
• 5 - Booléen
• 6 - Décimal. Ex : 19.95
• 7 - Version. Ex : “1.0.0.0”

Une fois que vous avez ajouté et configuré un tag, il est prêt à collecter des informations auprès de vos utilisateurs. Suivez ces étapes pour l’implémenter :

1. Intégrez le SDK Pushwoosh dans votre projet en suivant le guide d’intégration approprié.
2. Utilisez la fonction setTags pour assigner des tags et collecter les données utilisateur.

Vous trouverez ci-dessous des exemples d’implémentation pour différents frameworks utilisant la fonction setTags.

NSDictionary *tags = @{
    @"Alias" : aliasField.text,
    @"FavNumber" : @([favNumField.text intValue]),
    @"price" : [PWTags incrementalTagWithInteger:5],
    @"List" : @[ @"Item1", @"Item2", @"Item3" ]
};

[[PushNotificationManager pushManager] setTags:tags];

pushwoosh.setTags(Tags.intTag("intTag", 42));

PushNotification.prototype.setTags = function(  config, success, fail  )

Future<void> setTags(Map tags) async {
  await _channel.invokeMethod("setTags", {"tags" : tags});
}

pushNotification.setTags({
    "string_tag" : "Hello world",
    "int_tag" : 42,
    "list_tag":["hello", "world"]
});

public virtual void SetIntTag(string tagName, int tagValue)

public virtual void SetStringTag(string tagName, string tagValue)

public virtual void SetListTag(string tagName, List<object> tagValues)

FPushwooshModule& pushwoosh = FPushwooshModule::Get();
pushwoosh.SetTags("{ \"intTag\" : 1, \"stringTag\" : \"example\", \"listTag\" : [ \"a\", \"b\", \"c\" ] }");

Pushwoosh.setTags({ "key": keyValue, "value": inputValue });

NSDictionary *tags = @{
    @"Alias" : aliasField.text,
    @"FavNumber" : @([favNumField.text intValue]),
    @"price" : [PWTags incrementalTagWithInteger:5],
    @"List" : @[ @"Item1", @"Item2", @"Item3" ]
};
[[PushNotificationManager pushManager] setTags:tags];

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 l’endpoint /setTags :

POST https://go.pushwoosh.com/json/1.3/setTags

{
   "request": {
      "application": "XXXXX-XXXXX", // requis, code d'application Pushwoosh
      "hwid": "8f65bXXXf378eXXXbeceXXX4e153XXX2", // requis, ID matériel de l'appareil (HWID) utilisé dans l'API /registerDevice
      "tags": { // requis
           "StringTag": "valeur de chaîne", // 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 d’un 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 bonnes valeurs.

Par exemple, si vous prévoyez de cibler les utilisateurs de Munich, vous devez couvrir cela avec un ensemble de valeurs pour le 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.