Marcar usuários por tópico de página e origem da assinatura

​

Escolha seu padrão

​

Pré-requisitos

• OneSignal Web SDK e/ou SDK móvel instalado e inicializado.
• Familiaridade com Tags e Segmentos.

​

Marcar por tópico de página (a cada visita)

• Em um site de moda, um usuário está interessado apenas em sapatos masculinos — não em vestidos femininos.
• Em um aplicativo de notícias, um usuário visita consistentemente artigos de finanças e esportes — mas nunca entretenimento ou política.

​

1. Definir sua taxonomia de tópicos

• Verticais amplas como sports, finance ou entertainment
• Tipos de produtos como laptops, accessories ou premium
• Autores ou marcas

​

2. Adicionar código para rastrear visitas a tópicos

• Rastrear um ou mais tópicos por página ou tela.
• Incrementar a contagem de visitas toda vez que o tópico é visualizado.
• Marcar o usuário com a contagem atualizada em cada visualização.

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 e enviar mensagens personalizadas

• Segmentos para construir grupos baseados em regras (por exemplo, usuários com gaming >= 3).
• Filtros de API para incluir dinamicamente usuários em uma única campanha.

• Enviar mensagens a usuários sobre tópicos específicos somente quando visitaram páginas relacionadas 5 ou mais vezes.
• Promover posts para usuários que leram mais de 3 posts de um autor específico.
• Oferecer descontos a compradores que continuam retornando a uma categoria de produto específica.

​

Melhores práticas

• Teste sua lógica de tags usando console.log() (web) ou o logger da sua plataforma antes de lançar campanhas.
• Use convenções consistentes de nomenclatura de tópicos entre páginas.
• Mantenha a lista de tópicos em um local central (arquivo de configuração ou configuração remota) para que você possa ajustar sem tocar em cada página.

• Chaves de tag longas ou excessivamente específicas (títulos completos de artigos, URLs longas).
• Exceder os limites de tags do OneSignal.
• Marcar com informações pessoalmente identificáveis (PII).

​

Marcar na assinatura (única vez, apenas web)

​

1. Marcar usuários no opt-in

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);
});

• O evento change é acionado quando o estado de assinatura push do usuário muda (opt-in, opt-out, atualização de token).
• event.current.optedIn é true quando o usuário tem uma assinatura ativa. Verificar !event.previous.optedIn garante que as tags sejam aplicadas apenas no opt-in inicial, não a cada mudança de estado.
• window.location.pathname.split('/')[1] captura o primeiro segmento de caminho como o contexto de assinatura. Por exemplo, se a URL for https://example.com/gaming/article-123, a tag subscription_page é definida como gaming.
• pageTopic é extraído de uma tag <meta>, com fallback para 'general'. Ajuste para corresponder à estrutura de metadados do seu site.

​

2. Segmentar usuários por tag

• Enviar uma campanha para usuários onde subscription_page é gaming.
• Criar segmentos dinâmicos baseados em valores de tag e tempo (por exemplo, horas desde a primeira sessão).

​

3. Automatizar mensagens de acompanhamento

​

4. Combinar segmentos com modelos de mensagem

• Construa Templates para cada estágio da campanha (introdução, lembrete, promoção).
• Use Journeys para enviar essas mensagens quando os usuários entrarem no segmento apropriado.

• Convite para uma comunidade ou grupo social de gaming.
• Recomendar artigos em alta relacionados ao tópico deles.
• Enviar uma oferta exclusiva ou código de desconto.

​

Melhores práticas

• Use nomes e valores de tag significativos que reflitam a intenção real do usuário.
• Extraia valores de tag dinamicamente a partir de metadados de página quando possível.
• Marque apenas no opt-in inicial — o exemplo do listener acima verifica !event.previous.optedIn para evitar remarcar a cada mudança de estado.

​

Perguntas frequentes

​

Qual padrão devo usar?

​

As tags persistem se o usuário limpar os dados do navegador?

​

Posso atualizar as tags após a assinatura inicial?

​

Devo usar esses padrões em vez de filtros de evento de mensagem?

​

O padrão de origem da assinatura funciona em dispositivos móveis?

​

Páginas relacionadas