Saltar al contenido principal

Descripción general

Utiliza los activadores para mostrar mensajes en la aplicación a los usuarios dentro de la audiencia en el momento que elijas. A diferencia de las notificaciones push, los correos electrónicos y los SMS que simplemente envían el mensaje en un momento específico, los mensajes en la aplicación requieren un activador para determinar cuándo mostrar el mensaje a los usuarios mientras están en tu aplicación.
Los activadores determinan cuándo mostrar el mensaje. Para establecer con qué frecuencia se debe mostrar el mensaje, consulta Programación y frecuencia.

Establece un activador al crear un mensaje en la aplicación en el panel de OneSignal

Requisitos

  • Revisa la Descripción general de mensajes en la aplicación para conocer la configuración y los requisitos adicionales.
  • Algunos activadores (documentados a continuación) son programáticos y requieren que se agregue código a tu aplicación antes de que se pueda mostrar el mensaje.
  • Los usuarios deben estar dentro de la audiencia antes de que comience una nueva sesión para que el activador muestre el mensaje. Una nueva sesión comienza cuando la aplicación está fuera de foco durante al menos 30 segundos. Consulta Cómo se muestran los mensajes en la aplicación.

Tipos de activadores

Existen cuatro tipos de activadores. Cada uno se puede combinar con operadores AND y OR para mostrar solo bajo condiciones muy específicas.

Al abrir la aplicación

No se requiere código. Muestra el mensaje en la próxima apertura de la aplicación. Los usuarios dentro de la audiencia serán elegibles para recibir el mensaje cuando abran la aplicación.
  • Para segmentos de audiencia que requieren etiquetas o acciones específicas que un usuario realiza durante una sesión, necesitarán iniciar una nueva sesión para que el mensaje se muestre en la próxima apertura de la aplicación.
  • Para segmentos de audiencia que apuntan a todos los usuarios o filtros de versión de la aplicación, el mensaje se mostrará cuando el usuario abra la aplicación. Incluso si es un usuario completamente nuevo.

Activador en la aplicación

Se requiere código. Muestra el mensaje cuando el usuario realiza ciertas acciones. Requiere que se pasen una key y un value al método addTrigger dentro de tu aplicación.

Establece un activador programático en la aplicación.

El ejemplo mostrará el mensaje en la aplicación cuando tu aplicación llame al método addTrigger('trigger', '1'). Ten en cuenta que el usuario debe estar dentro de la audiencia antes de que comience una nueva sesión para que el activador muestre el mensaje. Consulta Requisitos más arriba para obtener más detalles.

Requisitos importantes del activador en la aplicación

  • Las keys y los values distinguen entre espacios y mayúsculas/minúsculas. Verifica que no haya espacios accidentales o diferencias de mayúsculas/minúsculas al configurar el activador.
  • Puedes requerir que estén presentes múltiples keys y values para que se muestre el mensaje.
    • Cada par clave-valor que utiliza una condición AND debe satisfacerse para que el activador muestre el mensaje.
    • Los pares clave-valor que utilizan una condición OR mostrarán el mensaje si se satisface cualquiera de los pares clave-valor.
  • Cuando requieras múltiples activadores, puedes usar el método removeTrigger para eliminar un activador si es necesario.
  • Las condiciones mayor que y menor que funcionan para valores numéricos aunque se establezcan como cadenas en el código.
    • Si quieres mostrar un mensaje cuando un usuario alcance el nivel 5. Configurarías la audiencia como todos los usuarios, pero establecerías tu activador como “level is 5”. Cada vez que un usuario suba de nivel, llamarías a addTrigger("level", "x") donde “x” es el nivel que alcanzó. Esto continúa incrementándose hasta que se llama a addTrigger("level", "5");, luego el mensaje en la aplicación se mostrará al usuario.

Duración de la sesión

No se requiere código. Muestra el mensaje después de un número específico de segundos dentro de la sesión actual de la aplicación. El usuario debe estar dentro de la audiencia antes de que comience una nueva sesión para que el activador muestre el mensaje. Consulta Requisitos más arriba para obtener más detalles.

Duración desde el último mensaje en la aplicación

No se requiere código. Muestra el mensaje después de un número específico de segundos desde el mensaje en la aplicación más reciente. El usuario debe estar dentro de la audiencia antes de que comience una nueva sesión para que el activador muestre el mensaje. Consulta Requisitos más arriba para obtener más detalles. Esto es útil para incluir en mensajes menos urgentes o de menor prioridad para que no se muestren demasiado cerca de mensajes más importantes.

¿Cuándo se debe descartar este mensaje?

Esta opción te permite controlar cuánto tiempo debe permanecer el mensaje en la pantalla.
  • Mostrar hasta que se descarte: El mensaje se mostrará hasta que se actúe físicamente sobre él. Ya sea haciendo clic en un botón de cerrar o deslizando el mensaje.
  • Descartar después de cierto tiempo: Establece el número de segundos en los que se mostrará el mensaje antes de que se elimine automáticamente de la pantalla. Esto es útil si el mensaje es informativo y no requiere acción del usuario.

¿Con qué frecuencia quieres mostrar este mensaje?

Mientras que los activadores determinan cuándo mostrar el mensaje, esta opción te permite controlar con qué frecuencia se debe mostrar el mensaje. Consulta Programación y frecuencia para obtener más detalles.

Imagen que muestra la capacidad de programar un mensaje en la aplicación

Establece cuándo y cuántas veces se muestra el mensaje

Solo una vez es el valor predeterminado. El mensaje en la aplicación solo se mostrará 1 vez a la suscripción. Cada vez que se satisfagan las condiciones del activador mostrará este mensaje cada vez que se cumplan las condiciones del activador.
  • Para activadores en la aplicación, esto puede ser varias veces en una sesión. Para otros activadores, es solo una vez por sesión.
Múltiples veces te permite establecer la cantidad específica de veces que se puede mostrar este mensaje y cuánto tiempo esperar entre cada visualización.
  • Si estableces: “2 veces con un intervalo de 1 hora entre cada una” - Se permitirá que el mensaje se active un total de 2 veces. La primera vez cuando se cumplan los activadores, luego la segunda vez cuando se cumplan los activadores y haya pasado 1 hora.
  • Si estableces “12 veces con un intervalo de 30 días entre cada una” - El mensaje se mostrará aproximadamente una vez al mes durante un año.

Preguntas frecuentes

¿Los activadores son etiquetas?

Los activadores no son etiquetas. Los activadores son pares clave-valor establecidos dentro de los métodos de activación de nuestro SDK. Las etiquetas son datos de usuario que puedes establecer y usar para dirigirte a usuarios en tu audiencia. Establece etiquetas para que los segmentos las usen en la audiencia y usa activadores para mostrar el mensaje.

¿Puedo usar múltiples activadores?

Sí, puedes usar múltiples activadores. Consulta Requisitos importantes del activador en la aplicación para obtener más detalles.