O acompanhamento de conversões está disponível nos planos pagos. Se o plano do seu espaço de trabalho não inclui esse recurso, o snippet de acompanhamento não registra nada.
Peça a um agente de IA para configurar
Você não precisa fazer essa integração manualmente. Se usa um assistente de programação com IA (como Claude Code, Cursor ou um agente semelhante no seu editor), cole um prompt como este, com seu próprio ID de acompanhamento de eventos e as conversões que interessam a você:Como funciona
- Um destinatário clica em um link de uma das suas assinaturas de e-mail.
- A Scribe redireciona essa pessoa para o seu site e adiciona um parâmetro
scribe_click_idà URL de destino. - O SDK da Scribe na sua landing page lê esse
scribe_click_id, armazena em first-party e anexa a cada evento registrado. - Quando o visitante converte, você chama
scribe.track('signup'). A Scribe conecta o evento ao clique de origem.
scribe_click_id que o SDK capturou da URL da landing, ou por um visitante já identificado (um scribe.identify anterior ou um evento atribuído liga esse visitante ao clique original). Um evento sem nenhum dos dois, ou seja, tráfego genuinamente direto, um link expirado ou um parâmetro removido, não é registrado. Isso mantém sua análise de conversões limitada ao tráfego que suas assinaturas realmente geraram.
Antes de começar
Você precisa de três coisas:- Um plano pago que inclua acompanhamento de conversões.
- Acompanhamento ativado no seu espaço de trabalho. É a mesma configuração que alimenta a análise de visualizações e cliques de assinatura. Ative apenas quando tiver o consentimento necessário (consulte Privacidade e consentimento).
- Seu Event Tracking ID. Este é um identificador público e não secreto do seu espaço de trabalho. É seguro incluí-lo no HTML do seu site.
1
Copie seu Event Tracking ID
No Scribe, abra Configurações, vá até a aba Espaço de trabalho e copie o valor em Event Tracking ID. Já que está lá, confirme que o Acompanhamento está ativado.
2
Adicione o SDK ao seu site
Use o snippet de script para um site comum ou o pacote npm para um app ou single-page app. Ambos expõem a mesma API Opção B. npm ou yarn. Instale o pacote e inicialize-o uma vez na inicialização do app.Importar o módulo não tem efeitos colaterais (é seguro para renderização no servidor). Nada é enviado até você chamar
scribe.track(...).Opção A. Snippet de script. Adicione a cada página que deseja acompanhar, logo antes da tag </head> de fechamento. O snippet se inicializa automaticamente a partir de data-workspace, portanto não é necessário chamar init().init().3
Registre sua primeira conversão
Chame O SDK captura para você a atribuição de clique do Scribe a partir da URL de destino, agrupa os eventos em lotes e os envia de forma confiável, inclusive quando o visitante sai da página.
scribe.track sempre que uma conversão acontecer, por exemplo no handler de sucesso do cadastro.4
Verifique se está funcionando
Teste da mesma forma que um visitante real chega: clique em um link em um dos seus próprios e-mails de assinatura, deixe o Scribe redirecionar você para o seu site (a URL de destino agora carrega um
scribe_click_id) e, em seguida, dispare a conversão nessa página. Abra Analytics no Scribe e ela aparece ao lado das visualizações e cliques, segmentada por assinatura, membro da equipe, campanha e país.Referência do SDK
scribe.track(name, metadata)
Registra um evento. name é obrigatório, por exemplo, signup, demo_booked ou purchase.
value,currencyeevent_idsão campos de nível superior reconhecidos.- Todas as outras chaves passam a integrar o campo
propertiesdo evento. Use apenas valores escalares simples nas propriedades (strings, números, booleanos). Não inclua dados pessoais, como e-mails ou números de telefone, nas propriedades: a Scribe descarta automaticamente as chaves que parecem conter dados pessoais. - Informe seu próprio
event_idpara que um envio possa ser repetido com segurança. O mesmoevent_idrecebido duas vezes em 24 horas é registrado apenas uma vez. - A Scribe contabiliza o mesmo evento uma vez por visitante e por dia. Um evento sem
value, ou comvalueigual a 0, que repita onamee opropertiesde um evento já registrado para esse visitante no mesmo dia (UTC) não é registrado novamente: alguém que envia seu formulário de cadastro cinco vezes em um dia conta como um únicosignupnaquele dia. Um evento comvalueé sempre registrado, então duas compras em um dia contam como duas compras. Esse controle é feito com base no melhor esforço e não é uma garantia exata: eventos idênticos que chegam no mesmo instante podem, ocasionalmente, ser registrados os dois.
scribe.identify(userId, traits)
Associa o visitante a um dos seus próprios usuários, para que você veja quais assinaturas trazem quais clientes. Útil em contextos B2B e em estratégias account-based.
identify, as chamadas track seguintes ficam vinculadas a esse usuário. Chame scribe.reset() no logout para limpar a identidade.
scribe.flush()
Os eventos são agrupados em lotes e enviados automaticamente — e sempre que a página é ocultada. Chame flush() apenas se precisar forçar o envio imediato do lote atual.
Atributos do snippet
Ao usar o snippet de script, configure-o com atributosdata-*:
Política de segurança de conteúdo (CSP)
Se o seu site define uma política de segurança de conteúdo (CSP), adicione os hosts da Scribe à lista de permissões:Casos de uso: transforme conversões em crescimento
O acompanhamento de conversões transforma suas assinaturas de e-mail em um canal de aquisição mensurável. Veja como as equipes colocam os dados em prática, inclusive para alimentar campanhas de remarketing pagas.Crie campanhas de remarketing no Google Ads e no Meta Ads
Dispare os pixels de conversão das plataformas de anúncios no mesmo lugar em que você chamascribe.track, para que uma única conversão chegue à Scribe, ao Google Ads e à Meta ao mesmo tempo. A Scribe informa que a conversão veio de uma assinatura de e-mail; o Google e a Meta usam o mesmo sinal para lances e públicos.
Crie públicos de retargeting com alta intenção
Pessoas que clicaram na sua assinatura e chegaram ao seu site, mas não converteram, já estão aquecidas. Use a Scribe para confirmar o tráfego gerado pelas assinaturas e, em seguida, faça retargeting desses visitantes com uma oferta personalizada no Google e no Meta. Como o tráfego vem dos seus próprios e-mails, esses públicos costumam converter melhor do que a prospecção a frio.Alimente públicos semelhantes a partir de quem já converteu
Seu melhor público de origem são as pessoas que já converteram por um canal confiável. Extraia os visitantes adquiridos pelas assinaturas (filtre por assinatura, membro da equipe ou campanha), faça upload deles como Público personalizado no Meta ou como lista de Customer Match no Google Ads e crie públicos semelhantes (Lookalike ou Similar) a partir dessa base de alta qualidade.Exclua clientes atuais dos investimentos em aquisição
Pare de pagar para adquirir pessoas que já se cadastraram ou compraram. Exporte quem já converteu e adicione essas pessoas como lista de exclusão nas suas campanhas de prospecção, para que o orçamento vá para prospects realmente novos.Otimize pela receita, não apenas pelos cliques
Envie valores reais devalue e currency em cada conversão. Com a receita associada, mude o Google e o Meta para lances baseados em valor e, na Scribe, classifique assinaturas, membros da equipe e campanhas pela receita que geram, e não apenas pelos cliques.
Comprove o canal e realoque o orçamento
O acompanhamento de conversões permite comparar, nos mesmos termos, a receita gerada por assinaturas de e-mail com a dos seus canais pagos. Quando uma campanha de assinatura supera uma campanha paga, você tem os números para direcionar o orçamento para o que funciona.Privacidade e consentimento
O acompanhamento de conversões foi criado para respeitar seus visitantes e suas obrigações:- Os endereços IP são anonimizados. A Scribe aplica hash ao IP antes de armazená-lo. IPs brutos nunca são mantidos.
- Nenhum dado pessoal nas propriedades. Chaves que parecem dados pessoais (e-mail, telefone, senha, tokens, números de cartão e similares) são removidas automaticamente das propriedades dos eventos. Use
identifyquando quiser associar um usuário de forma intencional. - Armazenamento condicionado ao consentimento. Defina
data-consent="denied"(snippet) ouconsent: false(npminit) para impedir que o SDK armazene o identificador de clique até que o visitante dê consentimento. - Obtenha o consentimento antes de ativar o rastreamento. A configuração de rastreamento do espaço de trabalho implica a mesma responsabilidade que qualquer pixel de analytics. Garanta que você tem o consentimento exigido na sua região antes de ativá-la.
Artigos relacionados
- Visão geral de analytics: visualizações, cliques, alcance e CTR em todo o seu espaço de trabalho.
- Dashboard de analytics: veja as conversões ao lado das visualizações e dos cliques em todas as abas.
- Analytics de assinatura: desempenho de uma assinatura individual.
- Campanhas de marketing: execute e meça campanhas de banner dentro das assinaturas.
- Personalize links com Smartfields: envie parâmetros UTM e dados dos membros da equipe para suas próprias ferramentas, um conjunto de dados separado do rastreamento da Scribe.
- Scribe para agentes de IA: permita que um assistente configure o rastreamento e gere relatórios sobre as conversões.