Notificaciones Push

Envía notificaciones Push segmentadas a tus usuarios en iOS (APNS), Android (FCM) y Web Push (navegadores).

Resumen

Las notificaciones Push te permiten:

• Reactivar a usuarios que no abrieron tu aplicación recientemente.
• Impulsar conversiones con ofertas urgentes.
• Entregar actualizaciones sobre pedidos, mensajes o eventos de la aplicación.
• Personalizar los mensajes según el comportamiento y los atributos del usuario.

Requisitos previos

Antes de crear campañas Push, asegúrate de tener:

1. Un SDK integrado:

   • SDK de iOS para usuarios de iPhone y iPad.
   • SDK de Android para usuarios de Android.
   • El SDK Web para notificaciones Push en navegador.

2. Las credenciales Push configuradas:

   • iOS: clave de autenticación APNS (.p8, recomendada) o certificado (.p12).
   • Android: JSON de cuenta de servicio de Firebase (FCM HTTP v1).
   • Web: un par de claves VAPID generado con un clic por cada aplicación web (consulta abajo).

3. Dispositivos registrados: los usuarios deben haber concedido el permiso Push en tu aplicación o navegador.

Configurar credenciales Push

iOS (APNS)

1. Ve a Configuración → Aplicaciones → [Tu aplicación].
2. Abre la configuración Push de la aplicación.
3. En la sección iOS (APNS), elige un método de autenticación:
   • Basado en token (recomendado): pega el contenido de tu clave de autenticación (.p8) e introduce el ID de clave y el ID de equipo.
   • Basado en certificado: sube el archivo de certificado .p12 e introduce la contraseña.
4. Selecciona el entorno:
   • Desarrollo: para probar compilaciones de desarrollo.
   • Producción: para compilaciones de App Store.
5. Guarda la configuración.

Obtener credenciales APNS

Genera certificados APNS y claves de autenticación en tu cuenta de Apple Developer.

Android (FCM)

1. Ve a Configuración → Aplicaciones → [Tu aplicación].
2. Abre la configuración Push de la aplicación.
3. En la sección Android (FCM), haz clic en Subir JSON de cuenta de servicio y proporciona el archivo de tu cuenta de servicio de Firebase. Joryio envía mediante la API FCM HTTP v1.
   • Genéralo en Firebase Console → Configuración del proyecto → Cuentas de servicio → Generar nueva clave privada.
4. Introduce tu ID de remitente (Firebase Console → Configuración del proyecto → Cloud Messaging).
5. Guarda la configuración.

Configuración de Firebase

Sigue la guía de configuración de Firebase para crear un proyecto de Firebase. No se usan las antiguas «claves de servidor»; solo el JSON de cuenta de servicio.

Web (Push en navegador)

Web Push se configura por aplicación web (cada aplicación web es una marca o sitio con su propio par de claves), junto a la configuración móvil:

1. Ve a Configuración → Aplicaciones → [Tu aplicación web].
2. Abre la pestaña Push.
3. En la sección Web Push (navegador), haz clic en Activar Web Push.
   • Se genera un par de claves VAPID almacenado en esa aplicación web; no hay claves que copiar ni pegar.
4. Aloja el service worker en tu sitio y activa el opt-in a partir de un gesto del usuario. La sección muestra el fragmento y la llamada exactos de una línea.

Un par de claves por aplicación web

Como cada aplicación web tiene su propio par de claves VAPID, dos sitios web - en espacios de trabajo distintos o como dos aplicaciones web en un mismo espacio - tienen sus propios suscriptores de navegador. Al regenerar las claves se invalidan las suscripciones existentes de esa aplicación, por lo que los usuarios deben volver a aceptar.

Crear una campaña Push

1. Ve a Campañas

Ve a Campañas → Crear campaña y selecciona Notificación Push.

2. Detalles de la campaña

Nombre: asigna a la campaña un nombre descriptivo.

Ejemplo: «Oferta de fin de semana: 20 % de descuento»

Descripción (opcional): añade notas internas sobre la campaña.

Aplicación de destino: elige la aplicación móvil (APNS/FCM) a la que llegará la notificación Push. Si el espacio de trabajo tiene dos o más aplicaciones web con Web Push activado, también aparece un selector de aplicación web: elige un sitio o deja Todas las aplicaciones web para llegar a los suscriptores de navegador de todos los sitios. Con una sola aplicación web se selecciona automáticamente y el selector no se muestra.

3. Audiencia objetivo

Selecciona qué usuarios recibirán la notificación Push:

Por segmento

Elige un segmento predefinido:

• «Usuarios activos (últimos 7 días)».
• «Suscriptores premium».
• «Personas que abandonaron el carrito».

Más información sobre cómo crear segmentos

Por comportamiento

Segmenta usuarios según acciones concretas:

• Evento: «Carrito abandonado».
• Filtro: valor del carrito > 50 $.
• Ventana de tiempo: últimas 24 horas.

4. Contenido del mensaje

Título de la notificación

Ejemplo: «¡Tu carrito te está esperando!»

Prácticas recomendadas para el título

• Mantenlo por debajo de 50 caracteres.
• Usa emojis con moderación (1 o 2 como máximo).
• Crea urgencia cuando corresponda.
• Personalízalo con datos del usuario.

Cuerpo de la notificación

Ejemplo: «Completa ahora tu compra y ahorra un 20 % con el código SAVE20. ¡La oferta termina esta noche!»

Prácticas recomendadas para el cuerpo

• Mantenlo por debajo de 120 caracteres: es el punto de truncamiento de Chrome y el valor más seguro entre plataformas (iOS permite 178 y Android 240, pero con menos de 120 se ve correctamente en todas).
• Incluye una llamada a la acción clara.
• Añade información urgente cuando corresponda.
• Personaliza con plantillas Liquid.

Longitud del título

Mantén los títulos por debajo de 50 caracteres. El paso de composición muestra un contador en directo con los límites por plataforma en una ayuda contextual (iOS 50, Android 65 y Chrome aproximadamente 50).

Vista previa en directo (iOS / Android / Web)

El editor de campañas tiene una vista previa en directo fija junto al formulario de composición. Alterna entre la pantalla bloqueada de iOS, el aviso emergente de Android y una notificación de escritorio de Chrome. La vista previa se actualiza mientras escribes, para que veas cómo se ajustan título y cuerpo en cada plataforma antes de enviar.

URL o esquema (opcional)

Indica dónde llega el usuario al tocar la notificación:

Formato	Funciona en
https://acme.com/product/12345	Todas las plataformas (Web, iOS, Android). Valor predeterminado recomendado.
acme://product/12345	Solo aplicaciones iOS y Android; requiere gestionar el esquema de URL en la aplicación.

Línea de ayuda en el editor: «https:// funciona en todas las plataformas. Los esquemas acme:// solo se resuelven dentro de las aplicaciones iOS / Android».

Imagen (opcional)

Adjunta una imagen (jpeg / png) que se mostrará junto a la notificación. Explora la biblioteca multimedia o pega una URL.

Botones de acción (multiplataforma)

Añade hasta dos botones de acción multiplataforma. Cada botón tiene una etiqueta y un valor (URL https://… o action:dismiss para controladores in-app):

• Botón 1: «Seguir pedido» → https://acme.com/track/{{ event.order_id }}.
• Botón 2: «Hablar con soporte» → action:dismiss.

Máximo por plataforma: Web 2 · iOS 4 · Android 3. La interfaz de campaña muestra 2 de 2 botones usados. Web muestra hasta 2 · iOS hasta 4 · Android hasta 3.

Clave de grupo

Una clave que permite que las nuevas notificaciones Push sustituyan a la anterior, en vez de acumularse, si comparten la misma clave. El mismo concepto existe con nombres distintos: tag en Web, collapse_key en Android y apns-collapse-id en iOS. El campo se asigna a los tres. Es útil, por ejemplo, para mostrar una sola notificación «en reparto» por usuario en vez de cinco.

Comportamiento en aplicaciones móviles (solo iOS y Android)

Ajuste	Descripción
Sonido	Predeterminado o silencioso. Solo para aplicaciones.
Incremento de distintivo	Número que se añadirá al distintivo del icono de la aplicación iOS.

Comportamiento en Web (solo Web)

Ajuste	Descripción
Mantener en pantalla hasta descartarla	Establece requireInteraction: true en la API Web Push. De forma predeterminada, las notificaciones del navegador se descartan solas tras unos segundos. Las notificaciones Push móviles ya permanecen hasta tocarlas.
Nombre del sitio web	Se muestra en el encabezado de la notificación de Chrome junto al favicon del sitio.

5. Personalización con Liquid

Usa plantillas Liquid para personalizar los mensajes:

Hola, {{user.firstName}}:

¡Tus {{cart.itemCount}} artículos te están esperando!
Total del carrito: ${{cart.total}}

Completa ahora tu compra y ahorra un 20 %.

Variables disponibles:

• {{user.firstName}}, {{user.lastName}}.
• {{user.email}}.
• Atributos personalizados: {{user.plan}}, {{user.city}}.
• Propiedades del evento que activa el recorrido.

Más información sobre plantillas Liquid

6. Programación

Elige cuándo enviar la notificación Push:

Enviar inmediatamente

Se envía en cuanto se activa la campaña.

Envío programado

Se envía en una fecha y hora concretas:

• Fecha: 2024-01-20.
• Hora: 10:00.
• Zona horaria: America/New_York.

Activada por comportamiento

Se envía cuando los usuarios realizan acciones específicas:

• Disparador: «Carrito abandonado».
• Control de reentrada: cada vez / una vez por usuario / período de espera entre envíos.
• Ventana activa: fechas opcionales de inicio y fin del disparador.

Los límites por hora («no enviar Push a las 3:00») se configuran a nivel de espacio de trabajo. Define las ventanas de silencio por canal en Configuración → Horas de silencio.

Mejores horas de envío

• Mañana (8:00-10:00): tasas de apertura altas.
• Hora de comer (12:00-13:00): buena interacción.
• Noche (19:00-21:00): máximo uso de móvil.
• Evita: la madrugada (23:00-6:00).

7. Límite de frecuencia

La frecuencia con la que los usuarios pueden recibir notificaciones Push se rige por las Reglas de contacto del espacio de trabajo (Configuración → Reglas de contacto), no por cada campaña:

• Una regla por canal para Push: máximo de mensajes por día / semana / mes (10 al día de forma predeterminada), que opcionalmente puede limitarse por etiquetas.
• Un tope entre canales opcional que se aplica a todos los canales.

Para envíos realmente críticos, una campaña puede activar omitir límites de frecuencia en las opciones avanzadas del paso Entrega.

Respeta la experiencia de usuario

Enviar demasiadas notificaciones Push puede provocar:

• Que los usuarios desactiven las notificaciones.
• Desinstalaciones de la aplicación.
• Una percepción negativa de la marca.

Sigue las directrices de cada plataforma:

• iOS: sé respetuoso y relevante.
• Android: respeta las preferencias de los usuarios.

8. Pruebas A/B

Prueba distintas variaciones del mensaje:

Variante A (50 %)

• Título: «¡Tu carrito te está esperando!»
• Cuerpo: «Completa tu compra y ahorra un 20 %».

Variante B (50 %)

• Título: «¡No te lo pierdas! Oferta por tiempo limitado».
• Cuerpo: «20 % de descuento en el carrito; caduca en 6 horas».

Joryio asigna automáticamente usuarios a las variantes y mide el rendimiento.

9. Seguimiento de conversiones

Define qué cuenta como conversión en el paso Conversión:

• Conversión principal: por ejemplo, «Pedido completado» (eventos habituales seleccionados, incluido «Notificación Push tocada», además de tus eventos personalizados).
• Ventana de atribución: 24 h / 72 h / 7 días (predeterminada) / 14 días / 30 días.
• Modelo de atribución: primer contacto / último contacto (predeterminado) / lineal.

Con los valores predeterminados, se mide cuántos usuarios completan una compra dentro de los siete días siguientes a recibir la notificación Push.

Funciones específicas de cada plataforma

Así se aplican los campos de composición compartidos en cada plataforma:

iOS

• Imagen: se entrega como un adjunto enriquecido de notificación (se muestra cuando el usuario expande la notificación).
• Incremento de distintivo: añade el número definido al distintivo del icono de la aplicación.
• Sonido: predeterminado o silencioso.
• Clave de grupo: se asigna a apns-collapse-id; una nueva notificación Push sustituye a la anterior con la misma clave.

Android

• Imagen: se muestra como una imagen expandida de estilo big-picture.
• Clave de grupo: se asigna a collapse_key.
• Botones de acción: se muestran hasta 3.

Web

• Mantener en pantalla hasta descartarla: establece requireInteraction para que la notificación no se descarte automáticamente.
• Nombre del sitio web: se muestra en el encabezado de la notificación del navegador.
• Clave de grupo: se asigna al tag de Web Notification.
• Botones de acción: se muestran hasta 2.

Probar la campaña

1. Modo de prueba

Antes de activar la campaña, pruébala:

1. Haz clic en Enviar Push de prueba en tu variante.
2. Elige un usuario aleatorio o busca un usuario existente. La prueba llega a los dispositivos registrados de ese usuario y la personalización se resuelve con sus datos. Los usuarios personalizados no están disponibles porque no tienen un dispositivo registrado.
3. Envía la prueba.

2. Verificar la entrega

Comprueba que la notificación:

• Aparece en el dispositivo.
• Muestra el título y cuerpo correctos.
• Abre la pantalla correcta al tocarla.
• Muestra las imágenes y medios correctamente.
• Tiene botones de acción que funcionan.

3. Revisar la analítica

Después de enviar pruebas, verifica que:

• El dispositivo se registró correctamente.
• El token es válido y está activo.
• No hay errores de entrega.

Supervisar el rendimiento

Métricas en tiempo real

Supervisa el rendimiento de la campaña en tiempo real:

Métrica	Descripción
Enviadas	Total de notificaciones enviadas
Entregadas	Entregadas correctamente a los dispositivos
Abiertas	Usuarios que tocaron la notificación
Conversiones	Usuarios que completaron el evento de conversión
Fallos	Errores de entrega (tokens no válidos, etc.)

Estadísticas de entrega

• Tasa de entrega: entregadas / enviadas.
• Tasa de apertura: abiertas / entregadas.
• Tasa de conversión: conversiones / abiertas.

Rendimiento por plataforma

Compara el rendimiento de iOS y Android:

• Tasas de apertura.
• Tasas de conversión.
• Variantes con mejor rendimiento.

Rendimiento por variante

En las pruebas A/B, consulta qué variante rindió mejor:

• Variante A: tasa de apertura del 12,5 %, conversión del 3,2 %.
• Variante B: tasa de apertura del 15,8 %, conversión del 4,1 %: ganadora.

Prácticas recomendadas

1. Pide permiso con criterio

Solicita permiso para Push en el momento adecuado:

• Después de que el usuario perciba valor en la aplicación.
• Con contexto: «Recibe una notificación cuando se envíe tu pedido».
• No inmediatamente en el primer inicio.

2. Segmenta la audiencia

No envíes mensajes masivos a todo el mundo:

• Segmenta según el comportamiento.
• Personaliza según las preferencias.
• Respeta las bajas de los usuarios.

3. Escribe mensajes persuasivos

• Valor claro: ¿qué obtiene el usuario?
• Crea urgencia: «Quedan 24 horas».
• Personaliza: usa su nombre o sus datos.
• CTA claro: «Comprar ahora» o «Aprovechar oferta».

4. El momento importa

Envía en las mejores horas:

• Ten en cuenta la zona horaria del usuario.
• Respeta las horas de silencio.
• Prueba distintas horas de envío.

5. No envíes en exceso

Respeta los límites de frecuencia:

• Máximo de 3 a 5 mensajes por semana.
• Al menos 4 horas entre mensajes.
• Permite que los usuarios controlen la frecuencia.

6. Prueba todo

Antes de lanzar:

• Prueba en dispositivos reales.
• Verifica que los enlaces profundos funcionen.
• Comprueba diferentes versiones del sistema operativo.
• Prueba todas las variantes A/B.

7. Supervisa y optimiza

Mejora de forma continua:

• Mide las tasas de apertura y conversión.
• Prueba A/B variaciones del mensaje.
• Elimina tokens no válidos.
• Aprende de quienes tienen mejor rendimiento.

Solución de problemas

Las notificaciones no se envían

Comprueba:

1. Que las credenciales Push estén configuradas correctamente.
2. Que los usuarios hayan concedido permiso Push.
3. Que los tokens de dispositivo se hayan registrado correctamente.
4. Que la campaña esté activada y no en borrador.

Tasas de entrega bajas

Causas habituales:

• Tokens de dispositivo no válidos o caducados.
• Usuarios que desinstalaron la aplicación.
• Usuarios que desactivaron el permiso Push.
• Certificado caducado (iOS).

Solución:

• Limpia periódicamente los tokens no válidos.
• Vuelve a solicitar permiso a los usuarios que desactivaron las notificaciones.
• Supervisa las fechas de caducidad de certificados.

Tasas de apertura bajas

Posibles problemas:

• Mensaje poco convincente.
• No es relevante para la audiencia.
• Se envió a una hora incorrecta.
• Exceso de envíos (fatiga por notificaciones).

Soluciones:

• Mejora el texto y la personalización.
• Segmenta mejor la audiencia.
• Optimiza las horas de envío.
• Implementa límites de frecuencia.

Límites de notificaciones Push

Límites de plataforma establecidos por Apple y Google:

iOS (APNS)

• Tamaño de carga: 4 KB como máximo.

Android (FCM)

• Tamaño de carga: 4 KB como máximo.
• TTL: 4 semanas como máximo.

Próximos pasos

• Campañas in-app: crea mensajes in-app.
• Configuración del SDK de iOS: integra Push de iOS.
• Configuración del SDK de Android: integra Push de Android.
• Pruebas A/B: optimiza tus campañas.