How to Use Aliases and Tags

I. Explication du concept clé

1. Alias : lier l'ID métier à l'ID push

Les alias servent à établir une correspondance un-à-un entre l'identifiant unique utilisateur (par exemple : userID, numéro de téléphone, e-mail, etc.) dans le système métier et l'ID d'enregistrement (registrationID / UID) dans le système de notification push EngageLab.

ID d'enregistrement : identifiant unique généré par le SDK WebPush ou AppPush pour chaque utilisateur, utilisé pour l'identification des messages push. Il est généralement dénué de sens pour le côté métier et n'est pas fortement lié à l'appareil.

Caractéristiques principales :

🧩 Liaison un-à-un : chaque ID d'enregistrement ne peut être lié qu'à un seul alias.
🧠 Reconnaissance métier : utilise l'ID utilisateur d'origine du système métier, ce qui facilite la logique métier.
🔒 Validité persistante : la relation de liaison reste valide sauf en cas de dissociation explicite.

Exemples d'application :

Notifications de changement de statut de commande (ex. : la commande de user123 a été expédiée)
Notifications de sécurité de compte (ex. : le mot de passe de user456 a été modifié)

2. Tag : segmentation dynamique basée sur les attributs

Les tags servent à étiqueter les attributs, comportements ou statuts des utilisateurs, permettant ainsi une segmentation dynamique et des notifications push par groupe.

Caractéristiques principales :

🔁 Relation plusieurs-à-plusieurs : un ID d'enregistrement peut avoir plusieurs tags, et un tag peut correspondre à plusieurs utilisateurs.
📈 Mises à jour en temps réel : prise en charge de l'ajout et de la suppression dynamiques de tags pour répondre aux changements de comportement utilisateur.
🧱 Prise en charge multi-dimensions : par exemple, « membre VIP », « inactif depuis 30 jours », « utilisateur iOS ».

Exemples d'application :

Envoyer des récompenses d'activation aux « utilisateurs VIP inactifs depuis 3 jours consécutifs ».
Envoyer des rappels à durée limitée aux utilisateurs ayant des articles dans leur panier sans finaliser l'achat.

II. Pourquoi utiliser les alias et les tags ?

🎯 Problèmes résolus

L'ID d'enregistrement push d'EngageLab est généré automatiquement par le SDK et n'est pas directement lié aux utilisateurs du système métier. Pour atteindre une notification push précise au niveau métier, les développeurs doivent :

✅ Établir une liaison entre ID utilisateur → ID d'enregistrement dans le système métier (via les alias).
✅ Segmenter les utilisateurs en différents groupes selon les besoins métier (via les tags).

✨ Résumé de la valeur clé

Fonction	Valeur métier	Valeur technique
Alias	Notification push individuelle précise pour les commandes, alertes de compte	Évite d'avoir à maintenir une correspondance entre ID d'enregistrement et ID métier
Tag	Opérations de groupe (VIP, inactifs, actifs)	Évite de devoir développer un système de segmentation utilisateur indépendant
Utilisation combinée	Construire des audiences précises en combinant région + comportement + attributs	Réduit grandement la complexité de la logique push, rendant la maintenance plus efficace

III. Instructions détaillées d'utilisation

1. Définir des alias et des tags

✅ Configuration côté serveur via API

Lien vers la documentation : Définir un alias et des tags
Exemple de requête :

POST /v4/devices/{registration_id} { "tags": { "add": [ "VIP", "utilisateur iOS" ] }, "alias": "user_5678" }

              
              POST /v4/devices/{registration_id}
{
    "tags": {
        "add": [
            "VIP",
            "utilisateur iOS"
        ]
    },
    "alias": "user_5678"
}

Afficher ce bloc de code dans la fenêtre flottante

✅ Configuration côté client via SDK

Web SDK : setTagsAlias
SDK Android : API Tags et Alias
SDK iOS : API Tags et Alias

2. Initier des notifications push

✅ Opération via la console

Sélectionnez les groupes d'utilisateurs par tag ou alias sur la page de création de notification push.

✅ Méthode API

Lien vers la documentation : Créer une API de notification push
Exemple de requête :

POST v4/push { "from": "push", "to": { "tag": [ "VIP" ], "tag_and": [ "Inactif depuis 30 jours" ] }, "body": { "platform": "all", "notification": { "alert": "Bonjour, MTPush !", "android": { "alert": "Cadeau de retour", "title": "Cher utilisateur VIP, bon retour ! Profitez de votre offre exclusive dès maintenant." }, "ios": { "alert": { "title": "Cadeau de retour", "body": "Cher utilisateur VIP, bon retour ! Profitez de votre offre exclusive dès maintenant." } } } } }

              
              POST v4/push
{
    "from": "push",
    "to": {
        "tag": [
            "VIP"
        ],
        "tag_and": [
            "Inactif depuis 30 jours"
        ]
    },
    "body": {
        "platform": "all",
        "notification": {
            "alert": "Bonjour, MTPush !",
            "android": {
                "alert": "Cadeau de retour",
                "title": "Cher utilisateur VIP, bon retour ! Profitez de votre offre exclusive dès maintenant."
            },
            "ios": {
                "alert": {
                    "title": "Cadeau de retour",
                    "body": "Cher utilisateur VIP, bon retour ! Profitez de votre offre exclusive dès maintenant."
                }
            }
        }
    }
}