Visão geral
O Singular Web SDK permite-lhe rastrear visitas de utilizadores, 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. Contacte 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 utilizadores pelo seu browser e seguir o seu percurso no seu site. Quando um utilizador 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 utilizadores
- Registo de eventos de conversão (compras, inscrições, subscrições)
- 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 subscrição 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 actualizada se ativar o rastreio 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: Equipas com acesso direto ao código do website, programadores que se sentem confortáveis com JavaScript, ou situações em que pretende o máximo controlo 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
- Controlo direto sobre a implementação
- Suporte de banners
Desvantagens:
- Requer alterações de código no seu sítio Web
- As actualizações requerem o envolvimento do programador
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: Equipas que já utilizam o Google Tag Manager, equipas de marketing que precisam de fazer alterações sem a assistência de um programador.
Vantagens:
- Não são necessárias alterações diretas ao código
- Gestão mais fácil para equipas 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 sítio Web: (www.acme.com,shop.acme.com,store.acme.com), deve utilizar o mesmo ID de produto com.acme para todos eles. Os sítios 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 aplicações separadas.
Sessões e reengajamento
O que é uma sessão?
Uma sessão no Singular tracking representa um período distinto de envolvimento do utilizador 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 utilizador faz uma visita com novos parâmetros de campanha (fonte de anúncio diferente)
- Um utilizador 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
- Predefiniçã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 utilizador
- 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 aplicação em Definições > Aplicações
- Determina o tempo mínimo que um utilizador 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 utilizador 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 ocorreatribuição de reengajamento (o utilizador não esteve inativo durante 7 dias)
- A visita é monitorizada como uma sessão normal associada à fonte de atribuição anterior
Se o mesmo utilizador 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 é registado 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.
Eventos: Conversão vs. Padrão
O Singular faz distinção entre dois tipos de eventos:
Eventos de conversão: Ações críticas para o negócio que indicam sucesso (compras, assinaturas, inscrições, downloads). Eles aparecem em relatórios de atribuição e cálculos de ROI.
Eventos padrão: Acções de apoio que ajudam a compreender o comportamento do utilizador (visualizações de página, adicionar ao carrinho, reproduções de vídeo). Aparecem nos relatórios de dados brutos e ajudam a analisar as jornadas do utilizador.
DICA! Configure quais eventos são classificados como "eventos de conversão" nas configurações da sua conta do Singular. Isso garante que eles apareçam nos relatórios corretos.
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 utilizadores para acompanhar as suas actividades e interações nas sessões sem recolher 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 rastreio entre subdomínios, actualize a política de privacidade do seu sítio 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