Plan de Push + mejores prácticas de Smart Push
1. Descripción general de las funciones
EngageLab presenta dos funciones clave para ayudar a los desarrolladores a lograr una gestión de entrega de mensajes más inteligente y eficiente:
Plan de Push:
- Se utiliza para identificar y gestionar una serie de tareas de push relacionadas, lo que permite una atribución y un análisis unificados a nivel de estadísticas y operaciones. El uso en la consola se puede consultar en la Guía de Plan de Push, y los detalles de integración de la API están disponibles en la API de Plan de Push.
Smart Push:
- Smart Push es una función exclusiva de EngageLab diseñada para optimizar la tasa de clics de las notificaciones. Cada vez que un usuario visita su servicio a través de un sitio web o una aplicación móvil integrados con el SDK de EngageLab, se realiza un seguimiento de su hora de actividad más reciente. El sistema registra estos datos y envía notificaciones en el momento adecuado en función de la zona horaria del dispositivo de cada usuario y de sus patrones históricos de uso. Para usuarios sin datos históricos de actividad (p. ej., usuarios recién registrados), se puede optar por enviar de inmediato o programar una hora específica (en función de la zona horaria del usuario) para garantizar que cada usuario objetivo tenga una hora de entrega definida.

- Para la integración de la API de Smart Push, consultar la API de tareas programadas y utilizar el desencadenador
intelligent. Este desencadenador envía automáticamente las notificaciones en el momento óptimo según la zona horaria local del usuario, basándose en su hora de actividad más reciente, mejorando la tasa de clics.
2. Casos de uso típicos y prácticas recomendadas
✅ Escenario 1: Gran evento promocional de comercio electrónico (p. ej., rebajas de fin de año)
Objetivo: Enviar múltiples recordatorios de venta flash y notificaciones de descuentos en un plazo de 5 días, con una temporización personalizada para cada usuario.
Pasos de implementación:
- Crear un Plan de Push mediante
POST /v4/push_plan, por ejemplo,plan_id=promo_year_end_2025; - Para cada mensaje promocional, crear tareas programadas mediante
POST /v4/schedulesusando la API de tareas programadas, habilitar el modotrigger.intelligenty configurarbackup_time; - Establecer
plan_iden el campooptions.plan_idpara la atribución y el análisis estadísticos posteriores; - Utilizar la API de estadísticas de Plan de Push para consultar por lotes los datos del ciclo de vida en múltiples planes, incluidas métricas segmentadas por plataforma, proveedor y tipo de mensaje.
✅ Escenario 2: Aplicación social multilingüe en expansión global
Objetivo: Entregar “recordatorios de reactivación” y “anuncios de nuevas funciones” personalizados en función de la ubicación geográfica y la zona horaria de los usuarios.
Práctica recomendada:
- Utilizar etiquetas o
registration_idpara segmentar con precisión a los usuarios de distintas regiones (p. ej., US, IN, PH); - En una única tarea de push, utilizar
options.multi_languagepara configurar contenido multilingüe. El sistema muestra automáticamente el mensaje correspondiente en función del idioma del dispositivo del usuario. Habilitar el programadorintelligentpara obtener una temporización de entrega óptima; - Incluir
plan_iden el campooptions.plan_idpara la atribución de campañas y el análisis del rendimiento.
3. Flujo de uso detallado de la API
1. Crear un Plan de Push
POST /v4/push_plan
Authorization: Basic base64(appKey:masterSecret)
Content-Type: application/json
{
"plan_id": "promo_year_end_2025",
"plan_description": "Year-End Appreciation Sale Push Plan"
}
POST /v4/push_plan
Authorization: Basic base64(appKey:masterSecret)
Content-Type: application/json
{
"plan_id": "promo_year_end_2025",
"plan_description": "Year-End Appreciation Sale Push Plan"
}
Este bloque de código se muestra en una ventana flotante
2. Crear una tarea de Smart Push (vincular al plan)
POST /v4/schedules
Authorization: Basic base64(appKey:masterSecret)
Content-Type: application/json
{
"name": "promo_year_end_reminder_01",
"enabled": true,
"trigger": {
"intelligent": {
"backup_time": "2025-12-28 09:00:00"
}
},
"push": {
"from": "push",
"to": {
"registration_id": [
"regId_userA", "regId_userB"
]
},
"body": {
"platform": "android",
"notification": {
"alert": "Flash Sale is live! Grab it now!",
"android": {
"title": "Hot Deals Incoming",
"extras": {
"promo": "year_end_sale"
}
}
},
"options": {
"plan_id": "promo_year_end_2025",
"time_to_live": 86400
}
},
"request_id": "req_year_end_01",
"custom_args": {
"task": "reminder_01"
}
}
}
POST /v4/schedules
Authorization: Basic base64(appKey:masterSecret)
Content-Type: application/json
{
"name": "promo_year_end_reminder_01",
"enabled": true,
"trigger": {
"intelligent": {
"backup_time": "2025-12-28 09:00:00"
}
},
"push": {
"from": "push",
"to": {
"registration_id": [
"regId_userA", "regId_userB"
]
},
"body": {
"platform": "android",
"notification": {
"alert": "Flash Sale is live! Grab it now!",
"android": {
"title": "Hot Deals Incoming",
"extras": {
"promo": "year_end_sale"
}
}
},
"options": {
"plan_id": "promo_year_end_2025",
"time_to_live": 86400
}
},
"request_id": "req_year_end_01",
"custom_args": {
"task": "reminder_01"
}
}
}
Este bloque de código se muestra en una ventana flotante
3. Consultar estadísticas de push por plan_id

4. Resumen de mejores prácticas
| Paso | Práctica recomendada |
|---|---|
| Configuración de campaña | Usar la API push_plan para crear un plan de campaña |
| Entrega inteligente | Usar la API schedules combinada con trigger.intelligent |
| Personalización | Utilizar etiquetas y registration_id para segmentación precisa |
| Atribución del rendimiento | Usar options.plan_id para etiquetar campañas para estadísticas y análisis |
Para más información sobre la integración, consultar la documentación oficial de EngageLab o ponerse en contacto con el equipo de soporte en support@engagelab.com.
