Elige tu patrón
| Patrón | Cuándo se ejecuta el código | Qué establece | Plataformas |
|---|---|---|---|
| Etiquetar por tema de página | En cada visita a página o pantalla | Una etiqueta contadora por tema (gaming = 5) | Web, Android, iOS |
| Etiquetar en la suscripción | Una vez, cuando un usuario opta por push | Una etiqueta de atribución (subscription_page = gaming) | Solo web |
Requisitos previos
Etiquetar por tema de página (en cada visita)
Etiqueta usuarios con los temas con los que más se involucran para que puedas entregar mensajes más personalizados — aumentando la relevancia, las tasas de clics y la satisfacción. Casos de uso de ejemplo:- En un sitio de moda, un usuario solo está interesado en zapatos de hombre — no en vestidos de mujer.
- En una aplicación de noticias, un usuario visita constantemente artículos de finanzas y deportes — pero nunca entretenimiento o política.
1. Definir tu taxonomía de temas
Comienza identificando las categorías de contenido o temas que deseas rastrear. Estos podrían ser:- Verticales amplios como
sports,financeoentertainment - Tipos de productos como
laptops,accessoriesopremium - Autores o marcas
- Comienza con 3–8 temas para mantener la gestión simple.
- Mantente por debajo de 20 temas en general para evitar saturación.
2. Agregar código para rastrear visitas a temas
Los ejemplos a continuación hacen tres cosas:- Rastrear uno o más temas por página o pantalla.
- Incrementar el recuento de visitas cada vez que se visualiza el tema.
- Etiquetar al usuario con el recuento actualizado en cada vista.
3. Segmentar y enviar mensajes personalizados
Una vez que se aplican etiquetas a los usuarios, puedes orientarlos usando:- Segmentos para construir grupos basados en reglas (por ejemplo, usuarios con
gaming >= 3). - Filtros de API para incluir dinámicamente usuarios en una sola campaña.
- Enviar mensajes a usuarios sobre temas específicos solo cuando hayan visitado páginas relacionadas 5 o más veces.
- Promocionar publicaciones a usuarios que han leído más de 3 publicaciones de un autor específico.
- Ofrecer descuentos a compradores que siguen regresando a una categoría de producto específica.
Mejores prácticas
Hacer:- Prueba tu lógica de etiquetas usando
console.log()(web) o el logger de tu plataforma antes de lanzar campañas. - Usa convenciones de nomenclatura de temas consistentes en todas las páginas.
- Mantén la lista de temas en un lugar central (archivo de configuración o configuración remota) para que puedas ajustar sin tocar cada página.
- Claves de etiquetas largas o demasiado específicas (títulos completos de artículos, URLs largas).
- Exceder los límites de etiquetas de OneSignal.
- Etiquetar con información de identificación personal (PII).
Etiquetar en la suscripción (única vez, solo web)
Etiqueta suscriptores de push web con datos contextuales — como el tema de la página o la ruta URL desde la que se suscribieron — para entregar campañas de seguimiento dirigidas. Este patrón detecta el opt-in, aplica etiquetas y alimenta segmentos para mensajería estilo goteo.1. Etiquetar usuarios en el opt-in
Cuando un usuario se suscribe a notificaciones push, usa el listenerPushSubscription change para detectar el opt-in y aplicar etiquetas con datos contextuales sobre la página que estaban viendo.
- El evento
changese activa cuando cambia el estado de suscripción push del usuario (opt-in, opt-out, actualización de token). event.current.optedInestruecuando el usuario tiene una suscripción activa. Verificar!event.previous.optedInasegura que las etiquetas solo se apliquen en el opt-in inicial, no en cada cambio de estado.window.location.pathname.split('/')[1]captura el primer segmento de ruta como contexto de suscripción. Por ejemplo, si la URL eshttps://example.com/gaming/article-123, la etiquetasubscription_pagese establece engaming.pageTopicse extrae de una etiqueta<meta>, con fallback a'general'. Ajústalo para que coincida con la estructura de metadatos de tu sitio.
2. Segmentar usuarios por etiqueta
Una vez que se aplican las etiquetas, usa Segmentos o Filtros de API para orientar usuarios según esas etiquetas. Por ejemplo:- Enviar una campaña a usuarios donde
subscription_pageesgaming. - Crear segmentos dinámicos basados en valores de etiquetas y tiempos (por ejemplo, horas desde la primera sesión).
3. Automatizar mensajería de seguimiento
Construye campañas de goteo que activen mensajes según cuándo se suscribió el usuario y bajo qué contenido se suscribió. Ejemplo: Campaña de goteo para suscriptores de gaming| Nombre del segmento | Filtros | Descripción |
|---|---|---|
| Gaming 1 | subscription_page = gaming AND First Session > 2h AND < 24h | Contactar 2–24 horas después de la suscripción. |
| Gaming 2 | subscription_page = gaming AND First Session > 24h AND < 48h | Seguimiento 1 día después. |
| Gaming 3 | subscription_page = gaming AND First Session > 72h AND < 96h | Verificación final después de 3 días. |
Usa límites de tiempo superiores (
<) para evitar que los usuarios permanezcan en segmentos una vez que ha pasado la ventana de mensajería.4. Combinar segmentos con plantillas de mensajes
Una vez que se crean los segmentos:- Construye plantillas para cada etapa de la campaña (introducción, recordatorio, promoción).
- Usa Journeys para enviar estos mensajes cuando los usuarios ingresen al segmento apropiado.
- Invitar a una comunidad de gaming o grupo social.
- Recomendar artículos populares relacionados con su tema.
- Enviar una oferta exclusiva o código de descuento.
Mejores prácticas
- Usa nombres y valores de etiquetas significativos que reflejen la intención real del usuario.
- Extrae valores de etiquetas dinámicamente desde metadatos de página cuando sea posible.
- Solo etiqueta en el opt-in inicial — el ejemplo del listener anterior verifica
!event.previous.optedInpara evitar re-etiquetar en cada cambio de estado.
Preguntas frecuentes
¿Qué patrón debo usar?
Usa Etiquetar por tema de página para construir un perfil de interés conductual a lo largo del tiempo. El contador crece con cada visita, por lo que los segmentos pueden ajustarse por la profundidad del engagement (gaming >= 5). Usa Etiquetar en la suscripción para capturar una sola atribución puntual en el opt-in, útil para mensajería de bienvenida consciente del origen donde quieres reaccionar a dónde se suscribió el usuario antes de que tenga un largo historial de visitas. Ambos patrones pueden ejecutarse en paralelo en el mismo sitio — establecen etiquetas diferentes y responden preguntas diferentes.
¿Persisten las etiquetas si el usuario borra los datos del navegador?
No. Borrar los datos del navegador en la web crea una nueva Suscripción, y los contadores por tema almacenados enlocalStorage se restablecen junto con ella. Si el usuario vuelve a suscribirse (manualmente o mediante auto-resubscripción), el listener change se activa nuevamente y vuelve a aplicar la etiqueta de suscripción según la página actual, pero los contadores de visita comienzan desde cero.
¿Puedo actualizar las etiquetas después de la suscripción inicial?
Sí. Puedes llamar aOneSignal.User.addTag() o OneSignal.User.addTags() en cualquier momento para agregar o actualizar etiquetas. El listener de suscripción es útil para el contexto inicial, pero también puedes etiquetar usuarios según el comportamiento continuo.
¿Debo usar estos patrones en lugar de los filtros de eventos de mensaje?
Sirven para propósitos diferentes. Usa los patrones de esta página cuando quieras segmentar por qué páginas un usuario ha visitado o desde dónde se ha suscrito — es decir, señal que se origina en tu sitio o aplicación. Usa Filtros de eventos de mensaje cuando quieras segmentar por con qué mensajes de OneSignal ha interactuado un usuario (entregado, hecho clic, etc.). Son complementarios, no redundantes.¿Funciona el patrón de origen de suscripción en móvil?
No directamente. La APIPushSubscription.addEventListener("change", ...) es específica de web. En iOS y Android, puedes lograr una atribución similar llamando a addTag desde dentro de tu flujo de opt-in — por ejemplo, inmediatamente después de que el usuario acepte un prompt de permiso, etiquétalo con la pantalla o función en la que estaba.
Páginas relacionadas
Etiquetas
Agrega propiedades personalizadas a los usuarios para personalización y segmentación.
Segmentos
Agrupa usuarios por propiedades, etiquetas y comportamiento para mensajería dirigida.
Referencia del Web SDK
Referencia completa del OneSignal Web SDK, incluyendo listeners de suscripción y métodos de etiquetado.
Referencia del SDK móvil
Referencia completa del OneSignal SDK móvil, incluyendo métodos de etiquetado.
Journeys
Construye flujos de mensajería de múltiples pasos activados por entrada en segmentos o eventos personalizados.