Visão geral
O Singular Web SDK permite-lhe rastrear visitas de usuários, conversões e eventos no seu website. Quando implementado corretamente, o Singular atribui as conversões do website às campanhas de marketing que conduziram a essas visitas, dando-lhe uma visibilidade completa do desempenho do seu marketing web.
INFORMAÇÕES: A Atribuição Web é uma funcionalidade empresarial. Contate o seu Customer Success Manager para ativar esta funcionalidade na sua conta.
Como funciona a Atribuição Web
O Singular Web SDK utiliza JavaScript para identificar os usuários pelo seu navegador e seguir o seu percurso no seu site. Quando um usuário visita o seu site, o SDK determina se se trata de uma primeira visita ou de uma sessão de retorno após uma campanha web.
As principais capacidades incluem:
- Acompanhamento de visitas a páginas e sessões de usuários
- Registro de eventos de conversão (inscrições, testes gratuitos) e eventos de receita (compras, assinaturas)
- Medição de eventos personalizados específicos do seu negócio
- Atribuição de conversões a campanhas de marketing
- Atribuição entre dispositivos quando combinada com SDKs móveis (requer assinatura da funcionalidade entre dispositivos)
Antes de começar
Antes de implementar o Web SDK, certifique-se de que tem o seguinte:
| Requisito | Descrição |
|---|---|
| Chave SDK | Sua chave SDK da Singular. Encontre-a na sua conta Singular em Ferramentas de desenvolvimento > Integração de SDK > Chaves SDK. |
| Acesso ao site | Permissão para adicionar código JavaScript ao HTML do seu site, seja diretamente ou através de um sistema de gerenciamento de tags. |
| Planejamento de eventos | Uma lista documentada de eventos que deseja rastrear (por exemplo, Compra, Adicionar ao carrinho, Inscrição). |
| Política de privacidade | Política de privacidade atualizada se ativar o rastreamento entre subdomínios (que utiliza cookies). |
Escolhendo seu método de integração
O Singular oferece duas opções de integração. Escolha o método que melhor se adapta à sua configuração técnica:
Implementação nativa de JavaScript
Ideal para: Equipes com acesso direto ao código do website, desenvolvedores que se sentem confortáveis com JavaScript, ou situações em que pretende o máximo controle e o mínimo de dependências de terceiros.
Vantagens:
- Não é bloqueado por bloqueadores de anúncios comuns
- Desempenho de carregamento de página mais rápido
- Rastreamento mais fiável
- Controle direto sobre a implementação
- Suporte de banners
Desvantagens:
- Requer alterações de código no seu site Web
- As atualizações requerem o envolvimento do desenvolvedor
DICA! A Singular recomenda a implementação do JavaScript nativo para a maioria dos casos de uso, pois oferece maior confiabilidade e tem menos probabilidade de ser bloqueada por bloqueadores de anúncios.
Implementação do Gerenciador de tags do Google
Ideal para: Equipes que já utilizam o Google Tag Manager, equipes de marketing que precisam de fazer alterações sem a assistência de um desenvolvedor.
Vantagens:
- Não são necessárias alterações diretas ao código
- Gestão mais fácil para equipes não técnicas
- As alterações podem ser implementadas através da interface do GTM
Desvantagens:
- Muitas vezes bloqueado por bloqueadores de anúncios
- Depende do carregamento correto do GTM
- Complexidade adicional na depuração
- Sem suporte para banners
Ver Guia do Google Tag Manager
IMPORTANTE! Implemente apenas UM método. O uso simultâneo do JavaScript nativo e do Google Tag Manager causará rastreamento duplicado e métricas inflacionadas. O Singular não desduplica eventos automaticamente.
Entendendo os principais conceitos
ID do produto (ID do pacote de aplicativos)
O ID do produto identifica seu site para a Singular. Ele deve estar em notação DNS reversa, semelhante aos identificadores de pacote de aplicativos móveis.
Formato: com.website-name
Exemplos:
- Correto:
com.acme - Incorreto:
acme-store - Incorreto:
www.acme.com
DICA! Utilize o mesmo ID de Produto em todas as páginas do seu site. Se tiver vários subdomínios associados ao mesmo site Web: (www.acme.com,shop.acme.com,store.acme.com), deve utilizar o mesmo ID de produto com.acme para todos eles. Os sites web ou propriedades web com domínios diferentes: (www.site1.com,www.site2.com,www.site3.com), devem ser criados utilizando uma ID de produto separada para cada um na sua conta Singular e tratá-los como aplicativos separados.
Sessões e reengajamento
O que é uma sessão?
Uma sessão no Singular tracking representa um período distinto de envolvimento do usuário com o seu website. Ao contrário das sessões HTTP (que mantêm o estado técnico, como o status de login, nas solicitações de página), as sessões Singular são focadas em análises e medem os padrões de atividade do usuário para métricas de atribuição e engajamento.
Quando as sessões são criadas
Singular cria automaticamente uma nova sessão quando:
- Um usuário está inativo por 30 minutos ou mais (tempo limite de sessão padrão)
- Um usuário faz uma visita com novos parâmetros de campanha (fonte de anúncio diferente)
- Um usuário chega de um website de referência diferente
Tempo limite da sessão vs. Janela de inatividade de reengajamento
É importante compreender duas definições distintas baseadas no tempo:
Tempo limite da sessão (nível SDK)
- Controla o início de uma nova sessão
- Padrão: 30 minutos para WebSDK, 60 segundos para SDKs móveis
- Configurável através da inicialização do SDK
- Reinicia sempre que é detectada atividade do usuário
- Utilizado para métricas baseadas na sessão (contagem de sessões, duração da sessão, etc.)
Janela de inatividade de reengajamento (ao nível da plataforma)
- Controla quando a atribuição de reengajamento é elegível
- Padrão: 7 dias
- Configurado por aplicativo em Configurações > Aplicativos
- Determina o tempo mínimo que um usuário deve estar inativo antes de um clique na campanha de retargeting contar como um evento de reengajamento
- Não afecta a criação de sessões regulares
Cenário de exemplo
Considere um usuário que:
- Visita o seu site e sai após 5 minutos
- Regressa 45 minutos mais tarde através de um anúncio de retargeting
O que acontece?
- É criada uma nova sessão (excedeu o tempo limite da sessão de 30 minutos)
- Não ocorre atribuição de reengajamento (o usuário não esteve inativo durante 7 dias)
- A visita é monitorizada como uma sessão normal associada à fonte de atribuição anterior
Se o mesmo usuário regressou após 10 dias de inatividade através de um anúncio de retargeting:
- É criada uma nova sessão
- A atribuição de reengajamento é acionada (janela de inatividade de 7 dias excedida)
- O evento é registrado como um reengajamento com atribuição adequada à campanha de retargeting
Opções de configuração
Personalização do tempo limite da sessão:
O tempo limite da sessão pode ser ajustado durante a inicialização do SDK. Reveja as opções de inicialização do WebSDK na nossa documentação relevante para o seu método de implementação: JavaScript nativo ou Google Tag Manager
Personalização da janela de inatividade de reengajamento:
A janela de inatividade de reengajamento para atribuição de reengajamento pode ser personalizada por aplicativo navegando até Configurações > Aplicativos e expandindo as opções "Mostrar configurações avançadas" na plataforma Singular. Ajuste isso com base em seus padrões típicos de engajamento do usuário e estratégias de campanha de retargeting.
INFORMAÇÃO: O período de inatividade pode ser personalizado, se necessário. Leia mais sobre isso nas Perguntas frequentes sobre reengajamento.
Tipos de eventos: padrão, de conversão e de receita
O Singular faz distinção entre três tipos de eventos:
Eventos padrão (event()): Ações de apoio que ajudam a compreender o comportamento do usuário (adicionar ao carrinho, reproduções de vídeo, visualizações de conteúdo). Aparecem nos relatórios de dados brutos e ajudam a analisar as jornadas do usuário.
Eventos de conversão (conversionEvent()): Marcos importantes sem valor monetário (inscrições, inícios de teste gratuito, cadastros, envios de formulários de lead). Aparecem nos relatórios de atribuição.
Eventos de receita (revenue()): Ações com valor monetário (compras, assinaturas, renovações). Exigem uma moeda e um valor, e alimentam os relatórios de receita e ROAS.
DICA! O método que você chama define o tipo de evento. Rastreie uma compra com revenue(), não com conversionEvent(); caso contrário, o valor da receita não é registrado.
Privacidade e uso de cookies
Por padrão, o Singular não usa cookies. No entanto, se você ativar a persistência do identificador entre subdomínios, o Singular define um cookie de primeira parte para manter a identidade do usuário entre subdomínios.
Detalhes do cookie (quando ativado):
| Propriedade | Valor |
|---|---|
| Nome do cookie | singular_device_id |
| Finalidade | Atribui um ID único aos usuários para acompanhar as suas atividades e interações nas sessões sem coletar informações pessoais |
| Duração | 1 ano |
| Tipo de cookie | Cookie primário (definido no seu domínio) |
| Política de privacidade | https://www.singular.net/privacy-policy/ |
IMPORTANTE! Se ativar o rastreamento entre subdomínios, atualize a política de privacidade do seu site Web para divulgar a utilização do cookie singular_device_id.
Próximas etapas
- Escolha o seu método de integração (JavaScript nativo ou Google Tag Manager)
- Siga o guia de implementação passo a passo do método escolhido
- Teste sua implementação usando as etapas de validação fornecidas
- Reveja o guia de resolução de problemas para obter as melhores práticas