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 haz logout al 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 la sk_ solo en tu servidor. Usa llaves test mientras integras.
  • Idempotencia: envía Idempotency-Key en 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 deepLink que 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_time y 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.