Saltar al contenido principal
Esta página forma parte de App de ejemplo: una integración completa de OneSignal, que sigue una app real de principio a fin. La app es Clean Beans, un turno de limpieza para hogares compartidos, creada con Expo (React Native) y un backend de Supabase. Los mensajes in-app aparecen mientras alguien usa la app. Su contenido, su audiencia y su programación están en el panel de OneSignal, así que pueden cambiar sin una nueva versión. Clean Beans los usa para cinco tareas.

Disparadores: deja que la app decida el momento \

Un disparador es una clave y un valor que establece la app. Se muestra cualquier mensaje in-app configurado para coincidir con él. Cada pantalla de Clean Beans tiene un botón de ayuda en su cabecera que establece un disparador, con el nombre de la pantalla como valor.
src/components/HelpButton.tsx
app/(tabs)/_layout.tsx
Una sola clave de disparador sirve para trece pantallas. Añadir ayuda para una pantalla nueva consiste en añadir un botón con un valor nuevo y crear un mensaje en el panel.
Un mensaje in-app de superposición de ayuda mostrado sobre el panel

Al tocar el botón de ayuda en el panel se muestra una superposición de ayuda.

Configuración del panel. En Mensajes > In-App, crea un mensaje cuyo disparador sea help_topic is dashboard y repítelo para cada pantalla. Los recorridos guiados de varios pasos usan el mismo disparador con un diseño de carrusel.
Un mensaje in-app de recorrido guiado formado por tarjetas deslizables

Un recorrido guiado de varios pasos creado como un carrusel de tarjetas.

Mensajes con HTML personalizado \

Las superposiciones de ayuda están escritas en HTML, así que coinciden exactamente con el diseño de la app. Un mensaje in-app HTML se comunica con el SDK a través del objeto OneSignalIamApi. Se aplican dos reglas a cada elemento pulsable:
  • Dale un data-onesignal-unique-label único, para que los clics se registren correctamente.
  • Asígnale un listener que llame a un método de OneSignalIamApi. Los enlaces simples no se registran.
docs/iam-html/help-dashboard.html

Aviso previo de permiso de push \

El diálogo de permiso del sistema solo se puede mostrar una vez. Un mensaje in-app mostrado antes puede explicar lo que recibirá el usuario, y solo quienes tocan Enable notifications ven el diálogo del sistema.
Un mensaje in-app que explica las ventajas de activar las notificaciones

Un aviso previo explica la ventaja antes de que aparezca el diálogo del sistema.

docs/iam-html/push-permission-prompt.html
Si usas un aviso previo, elimina la llamada a requestPermission() del inicio de la app. De lo contrario, el diálogo del sistema aparece primero y al aviso previo ya no le queda nada que pedir.

Aviso de actualización de la app \

Cuando se publica una nueva versión, quienes tienen la antigua ven un aviso para actualizar. Este mensaje no necesita ningún código en la app. Su audiencia es un segmento de usuarios con una versión antigua de la app.
Un mensaje in-app que pide al usuario que actualice la app

El aviso de actualización, que solo se muestra a quienes tienen una versión antigua.

Un solo mensaje sirve para ambas plataformas. El script elige la tienda según el dispositivo, y openUrl registra el clic, abre la tienda y cierra el mensaje.
docs/iam-html/app-update-prompt.html
El saludo usa una etiqueta, con un valor alternativo para los usuarios que no la tienen.
docs/iam-html/app-update-prompt.html
Configuración del panel. Crea un segmento con el filtro App version menor que tu versión actual y úsalo como audiencia del mensaje. Actualiza el filtro cada vez que publiques una versión.
La sustitución de etiquetas funciona en el texto y los atributos de un mensaje in-app HTML, pero no dentro de las etiquetas script.

Solicitud de reseña: devolver un clic a la app \

Un buen momento para pedir una valoración en la tienda de apps es justo después de que algo haya ido bien. Clean Beans la pide cuando una sesión de limpieza lleva una racha a un múltiplo de siete días. Este es el único mensaje in-app en el que un toque tiene que ejecutar código en la app, porque la hoja de valoración nativa solo la puede abrir la propia app.
1

La app establece un disparador en un hito de racha

Espera a que se cierre la pantalla de sesión, para que el aviso nunca interrumpa la limpieza, y recuerda el último hito en el que lo pidió.
src/lib/reviewPrompt.ts
2

El mensaje devuelve un nombre de clic a la app

addClickName pasa un nombre al listener de clics de la app. No cierra el mensaje, así que el script lo cierra después.
docs/iam-html/review-prompt.html
3

La app abre la hoja de valoración nativa

El listener de clics comprueba el nombre y pide al sistema que muestre la hoja.
src/lib/reviewPrompt.ts
app/_layout.tsx
Un mensaje in-app de solicitud de reseña

El mensaje in-app de solicitud de reseña.

Configuración del panel. Crea un mensaje in-app HTML con el disparador ask_for_review is show. Prográmalo para que se muestre como máximo una vez cada 17 semanas.
Apple muestra su hoja de valoración como máximo tres veces por usuario al año, y Google tiene su propio límite, así que tocar el botón no garantiza que se muestre nada. La hoja nunca aparece en las compilaciones de TestFlight. Prueba este flujo con una compilación de la App Store.

Disparadores in-app

Tipos de disparadores y cómo se combinan.

Mensajes in-app HTML

Diseña mensajes con tu propio HTML.

API de JavaScript in-app

Todos los métodos de OneSignalIamApi.