Saltar al contenido principal
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 tutorial cubre la detección del opt-in, la aplicación de etiquetas, la creación de segmentos y la automatización de mensajes. Requisitos previos:

​
Configuración

​
1. Etiquetar usuarios con metadatos específicos de página

Cuando un usuario se suscribe a notificaciones push, usa el listener PushSubscription.addEventListener 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 (por ejemplo, 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

​
¿Persisten las etiquetas si el usuario borra los datos del navegador?

No. Borrar los datos del navegador crea una nueva Suscripción. Si el usuario vuelve a suscribirse (manualmente o mediante auto-resubscripción), el listener change se activa nuevamente y vuelve a aplicar las etiquetas según la página actual.

​
¿Puedo actualizar las etiquetas después de la suscripción inicial?

Sí. Puedes llamar a 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.

​
Páginas relacionadas

Etiquetas

Establece pares clave-valor personalizados en usuarios según eventos o propiedades.

Referencia del Web SDK

Referencia completa del OneSignal Web SDK, incluyendo listeners de suscripción y métodos de etiquetado.

Segmentos

Agrupa usuarios por propiedades, etiquetas y comportamiento para mensajería dirigida.

Journeys

Construye flujos de mensajería de múltiples pasos activados por entrada en segmentos o eventos personalizados.