Buenas prácticas
Recomendaciones para enviar mejor y mantener una integración sana.
Integración
- Registra el token en cada arranque de la app y cuando cambie. Es un upsert: no duplica nada.
- Identifica al usuario (
externalUserId) al iniciar sesión y hazlogoutal cerrarla, para no enviar datos de una cuenta al teléfono de otra persona. - Reporta los eventos (
opened,clicked, permisos): sin ellos la analítica solo ve lo que aceptó Google o Apple. - Llaves: la
pk_va en la app y lask_solo en tu servidor. Usa llavestestmientras integras. - Idempotencia: envía
Idempotency-Keyen los envíos que tu sistema podría repetir.
Contenido
- Títulos cortos: unos 40 caracteres se ven completos en casi todos los teléfonos.
- Contenido en el idioma de cada usuario (
content.es,content.en…). - Un
deepLinkque lleve directo a lo que anuncias. - Usa
category: "marketing"para promociones, así nunca retrasan a las transaccionales. - No pongas datos sensibles en el texto: se ve en la pantalla bloqueada.
Frecuencia
- Respeta la hora del usuario: programa con
local_timey configura horas de silencio en la app para el marketing. - Fija un máximo de marketing por dispositivo y día: PushHub omite lo que pase de ese número.
- No satures: muchas notificaciones hacen que el usuario desactive el permiso (
permission_denied) o desinstale la app (device.invalidated). - Segmenta: un mensaje relevante para pocos funciona mejor que uno genérico para todos.
Android
- Crea canales con nombres claros (Pedidos, Ofertas…): el usuario puede silenciar uno sin silenciar los demás.
- Icono pequeño monocromo.
iOS
- Pide el permiso en un momento con contexto (después de una acción del usuario), no al abrir la app por primera vez.
- Agrega la extensión de imágenes si envías multimedia.