Saltar al contenido principal
Puedes etiquetar usuarios en OneSignal según las páginas con las que interactúan en tu sitio o aplicación, y luego segmentar esas etiquetas para mensajería dirigida. Esta página cubre dos patrones distintos — elige el que coincida con tu objetivo, o ejecuta ambos en paralelo.

Elige tu patrón

PatrónCuándo se ejecuta el códigoQué establecePlataformas
Etiquetar por tema de páginaEn cada visita a página o pantallaUna etiqueta contadora por tema (gaming = 5)Web, Android, iOS
Etiquetar en la suscripciónUna vez, cuando un usuario opta por pushUna etiqueta de atribución (subscription_page = gaming)Solo web
Etiquetar por tema de página construye un perfil de interés conductual que crece con el engagement — útil para recomendaciones de contenido, campañas de reactivación y segmentación basada en categorías, incluso para usuarios que nunca optan explícitamente por un tema. Etiquetar en la suscripción captura una señal única en el momento del opt-in — útil para mensajería de bienvenida consciente del origen y campañas de goteo donde la página desde la que un usuario se suscribió predice lo que quiere leer a continuación.

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, finance o entertainment
  • Tipos de productos como laptops, accessories o premium
  • 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.
const topics = ["sports", "entertainment"]; // One or many

if (typeof localStorage !== "undefined" && Array.isArray(topics)) {
  topics.forEach(topic => {
    let count = parseInt(localStorage.getItem(topic), 10);
    count = isNaN(count) ? 1 : count + 1;
    localStorage.setItem(topic, count);
    OneSignal.User.addTag(topic, count.toString());
  });
}

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.
Casos de uso de ejemplo:
  • 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.
Evitar:
  • 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 listener PushSubscription change para detectar el opt-in y aplicar etiquetas con datos contextuales sobre la página que estaban viendo.
function pushSubscriptionChangeListener(event) {
  if (event.current.optedIn && !event.previous.optedIn) {
    // User just opted in — tag with subscription context
    var pathSegment = window.location.pathname.split('/')[1] || 'home';
    var pageTopic = document.querySelector('meta[name="article-topic"]')?.content || 'general';

    OneSignal.User.addTags({
      subscription_page: pathSegment,
      subscription_page_topic: pageTopic,
    });
  }
}

OneSignalDeferred.push(function(OneSignal) {
  OneSignal.User.PushSubscription.addEventListener("change", pushSubscriptionChangeListener);
});
Cómo funciona esto:
  • El evento change se activa cuando cambia el estado de suscripción push del usuario (opt-in, opt-out, actualización de token).
  • event.current.optedIn es true cuando el usuario tiene una suscripción activa. Verificar !event.previous.optedIn asegura 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 es https://example.com/gaming/article-123, la etiqueta subscription_page se establece en gaming.
  • pageTopic se 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_page es gaming.
  • 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 segmentoFiltrosDescripción
Gaming 1subscription_page = gaming AND First Session > 2h AND < 24hContactar 2–24 horas después de la suscripción.
Gaming 2subscription_page = gaming AND First Session > 24h AND < 48hSeguimiento 1 día después.
Gaming 3subscription_page = gaming AND First Session > 72h AND < 96hVerificació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.
Ideas de mensajes de ejemplo:
  • 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.optedIn para evitar re-etiquetar en cada cambio de estado.
No incluyas información de identificación personal (PII) como nombres o direcciones de correo electrónico en los valores de etiquetas. Evita codificar valores de etiquetas en todo tu sitio — extráelos dinámicamente del contexto de la página.

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 en localStorage 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 a OneSignal.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 API PushSubscription.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.