Pular para o conteúdo principal
Marque assinantes de web push com dados contextuais — como o tópico da página ou o caminho de URL a partir do qual se inscreveram — para entregar campanhas de acompanhamento direcionadas. Este tutorial cobre a detecção do opt-in, a aplicação de tags, a criação de segmentos e a automatização de mensagens. Pré-requisitos:

​
Configuração

​
1. Marcar usuários com metadados específicos da página

Quando um usuário se inscreve em notificações push, use o listener PushSubscription.addEventListener para detectar o opt-in e aplicar tags com dados contextuais sobre a página que estava visualizando. 
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);
});
Como isso funciona:
  • 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

Assim que as tags são aplicadas, use Segmentos ou Filtros de API para direcionar usuários com base nessas tags. Por exemplo:
  • 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

Construa campanhas estilo gotejamento que acionam mensagens com base em quando o usuário se inscreveu e sob qual conteúdo ele se inscreveu. Exemplo: Campanha de gotejamento para assinantes de gaming
Nome do segmentoFiltrosDescrição
Gaming 1subscription_page = gaming AND First Session > 2h AND < 24hAlcançar 2–24 horas após a assinatura
Gaming 2subscription_page = gaming AND First Session > 24h AND < 48hAcompanhamento 1 dia depois
Gaming 3subscription_page = gaming AND First Session > 72h AND < 96hVerificação final após 3 dias
Use limites de tempo superiores (<) para evitar que os usuários permaneçam em segmentos uma vez que a janela de mensagens tenha passado.

​
4. Combinar segmentos com modelos de mensagem

Assim que os segmentos são criados:
  • Construa Templates para cada estágio da campanha (por exemplo, introdução, lembrete, promoção).
  • Use Journeys para enviar essas mensagens quando os usuários entrarem no segmento apropriado.
Ideias de mensagens de exemplo:
  • 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.
Não inclua informações de identificação pessoal (PII) como nomes ou endereços de e-mail nos valores de tag. Evite codificar valores de tag em todo o seu site — extraia-os dinamicamente do contexto da página.

​
Perguntas frequentes

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

Não. Limpar os dados do navegador cria uma nova Assinatura. Se o usuário se re-inscrever (manualmente ou via re-inscrição automática), o listener change é acionado novamente e reaplicará as tags com base na página atual.

​
Posso atualizar as tags após a assinatura inicial?

Sim. Você pode chamar OneSignal.User.addTags() a qualquer momento para adicionar ou atualizar tags. O listener de assinatura é útil para o contexto inicial, mas você também pode marcar usuários com base no comportamento contínuo.

​
Páginas relacionadas

Tags

Defina pares chave-valor personalizados nos usuários com base em eventos ou propriedades.

Referência do Web SDK

Referência completa do OneSignal Web SDK incluindo listeners de assinatura e métodos de marcação.

Segmentos

Agrupe usuários por propriedades, tags e comportamento para mensagens direcionadas.

Journeys

Construa fluxos de mensagens em múltiplas etapas acionados por entrada em segmento ou eventos personalizados.