How to Use Aliases and Tags

I. Explicación de conceptos clave

1. Alias: vinculación del ID de negocio con el ID de push

Los alias se utilizan para establecer una asignación uno a uno entre el identificador único del usuario (p. ej., userID, número de teléfono, correo electrónico, etc.) en el sistema de negocio y el registration ID (registrationID / UID) del sistema de push de EngageLab.

El registration ID es un identificador único generado por el SDK de WebPush o AppPush para cada usuario, utilizado para la identificación de mensajes push. Por lo general, no tiene significado para el sistema de negocio y no está fuertemente vinculado al dispositivo.

Características principales:

🧩 Vinculación uno a uno: cada registration ID solo puede vincularse a un alias.
🧠 Reconocimiento a nivel de negocio: utiliza el ID de usuario original del sistema de negocio, lo que facilita la lógica de negocio.
🔒 Validez persistente: la relación de vinculación permanece válida salvo que se desvincule explícitamente.

Ejemplos de aplicación:

Notificaciones de cambio de estado del pedido (p. ej., el pedido de user123 se ha enviado)
Notificaciones de seguridad de la cuenta (p. ej., la contraseña de user456 se ha cambiado)

2. Etiqueta: agrupación dinámica basada en atributos

Las etiquetas se utilizan para marcar atributos, comportamientos o estados de los usuarios, lo que permite la segmentación dinámica y las notificaciones push por grupos.

Características principales:

🔁 Relación muchos a muchos: un registration ID puede tener varias etiquetas y una etiqueta puede corresponder a varios usuarios.
📈 Actualizaciones en tiempo real: admite la adición y eliminación dinámicas de etiquetas para responder a cambios en el comportamiento del usuario.
🧱 Compatibilidad con múltiples dimensiones: por ejemplo, «miembro VIP», «inactivo durante 30 días», «usuario de iOS».

Ejemplos de aplicación:

Enviar recompensas por activación mediante push a «usuarios VIP inactivos durante 3 días consecutivos».
Enviar recordatorios de tiempo limitado a usuarios con artículos en el carrito sin haber finalizado la compra.

II. ¿Por qué usar alias y etiquetas?

🎯 Problemas que se resuelven

El registration ID de push de EngageLab se genera automáticamente mediante el SDK y no está directamente relacionado con los usuarios del sistema de negocio. Para lograr un push de precisión a nivel de negocio, los desarrolladores deben:

✅ Establecer una vinculación ID de usuario → registration ID en el sistema de negocio (mediante alias).
✅ Segmentar usuarios en distintos grupos según las necesidades del negocio (mediante etiquetas).

✨ Resumen del valor principal

Función	Valor de negocio	Valor técnico
Alias	Push preciso a un solo usuario para notificaciones de pedidos y alertas de cuenta	Elimina la necesidad de mantener una asignación entre registration ID e ID de negocio
Etiqueta	Operaciones por grupos (VIP, inactivos, usuarios activos)	Evita la necesidad de desarrollar un sistema independiente de segmentación de usuarios
Uso combinado	Crear audiencias precisas combinando región + comportamiento + atributos	Reduce en gran medida la complejidad de la lógica de push, haciendo más eficiente el mantenimiento

III. Instrucciones de uso detalladas

1. Configuración de alias y etiquetas

✅ Configuración de la API del lado del servidor

Enlace a la documentación: Configurar alias y etiquetas
Solicitud de ejemplo:

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

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

Este bloque de código se muestra en una ventana flotante

✅ Configuración mediante el SDK del lado del cliente

2. Envío de notificaciones push

✅ Operación en la consola

Seleccionar grupos de usuarios por etiqueta o alias en la página de creación del push.

✅ Método de API

Enlace a la documentación: API de creación de push
Solicitud de ejemplo:

POST v4/push { "from": "push", "to": { "tag": [ "VIP" ], "tag_and": [ "Inactive for 30 days" ] }, "body": { "platform": "all", "notification": { "alert": "Hi, MTPush!", "android": { "alert": "Welcome Back Gift", "title": "Dear VIP user, welcome back! Claim your exclusive offer now." }, "ios": { "alert": { "title": "Welcome Back Gift", "body": "Dear VIP user, welcome back! Claim your exclusive offer now." } } } } }

              
              POST v4/push
{
    "from": "push",
    "to": {
        "tag": [
            "VIP"
        ],
        "tag_and": [
            "Inactive for 30 days"
        ]
    },
    "body": {
        "platform": "all",
        "notification": {
            "alert": "Hi, MTPush!",
            "android": {
                "alert": "Welcome Back Gift",
                "title": "Dear VIP user, welcome back! Claim your exclusive offer now."
            },
            "ios": {
                "alert": {
                    "title": "Welcome Back Gift",
                    "body": "Dear VIP user, welcome back! Claim your exclusive offer now."
                }
            }
        }
    }
}