Links

Pixel de conversão

Rastreie conversões em páginas de destino que não controla, atribuídas ao clique e à variante A/B de origem.

Os testes A/B de links curtos podem enviar visitantes para uma página de destino que não controla — uma loja online, um construtor de landing pages, o site de um parceiro. O Styrar mede o clique e em que variante o visitante entrou, mas não tem forma de saber se esse visitante converteu depois do redirecionamento.

O pixel de conversão fecha esse ciclo. É um pequeno script que incorpora na página de destino e que reporta conversões de volta ao Styrar, correlacionadas com o clique exato (e a variante A/B) que enviou o visitante até lá.

Como funciona

Quando um link curto redireciona um visitante, o Styrar adiciona um token único styrar_ck ao URL de destino.
O script do pixel nessa página lê o token a partir do URL (ou do localStorage, para sobreviver a navegação adicional no seu site) e mantém-o pronto para enviar com qualquer evento.
Você chama window.styrar.track(eventName, data) — ou adiciona um atributo data-styrar-track — quando um visitante faz algo que vale a pena contar (regista-se, finaliza a compra, inicia um teste).
O Styrar associa o token de volta ao link original e à variante A/B, e a conversão aparece no painel de experiência desse link.

Não há id de conta, id de site ou chave de API para configurar. O próprio token é a única coisa que liga um evento ao seu espaço de trabalho, e está limitado a um único clique.

Configurar um pixel de conversão

1. Encontre o seu snippet de incorporação

Abra o painel Avançado → Teste A/B do link curto no painel e inicie (ou configure) uma experiência. O painel mostra um cartão "Rastrear conversões na página de destino" com um snippet pronto a copiar:

HTML

<script src="https://api.styrar.com/v1/pixel/styrar.js" async></script>
<!-- mark a conversion -->
<button data-styrar-track="signup">Sign up</button>
<!-- or call it from your own code -->
<script>window.styrar && window.styrar.track('signup', { value: 19.99 })</script>

2. Adicione a tag de script à sua página de destino

Cole a tag <script src="…/v1/pixel/styrar.js"> na página onde os visitantes chegam depois do redirecionamento do link curto — no <head> ou imediatamente antes de </body>. Isto funciona em qualquer plataforma (Shopify, Webflow, um site estático, a sua própria app) porque o pixel e o seu endpoint de rastreio usam uma política CORS aberta e sem cookies.

3. Marque uma conversão

Escolha o que melhor se adapta à sua página:

Declarativo, sem necessidade de JavaScript próprio:

HTML

<button data-styrar-track="signup">Sign up</button>
<form data-styrar-track="checkout_complete">…</form>

Um click dispara o evento na maioria dos elementos; num <form> dispara em submit.

A partir do seu próprio código, depois de o script ter sido carregado:

HTML

<script>
  window.styrar && window.styrar.track('purchase', { value: 49.99 })
</script>

4. Confirme que está a funcionar

Acione a conversão na página de destino e depois abra o painel de teste A/B do link — a contagem e a taxa de conversão da variante atualizam-se quando o evento é recebido.

Valores de conversão personalizados

window.styrar.track(eventName, data) aceita qualquer nome de evento e um objeto data opcional:

HTML

<script>
  window.styrar.track('purchase', {
    value: 49.99,          // numeric — stored as the event's value
    plan: 'pro_annual',    // any other field is stored alongside the event
    currency: 'USD',
  })
</script>

Campo	Tipo	Comportamento
`eventName`	string	Obrigatório. Até 64 caracteres — use o que se adequar ao seu funil: `signup`, `add_to_cart`, `purchase`, etc.
`value`	number	Só é guardado se for um `number` do JS (por exemplo, receita do pedido). Qualquer outro tipo é ignorado.
qualquer outro campo em `data`	qualquer valor JSON	Guardado junto com o evento (até 4 KB serializados). Payloads maiores são descartados, não truncados.

Não há nenhum esquema para registar de antemão — chame track() com a estrutura que fizer sentido para a sua página, e ela é preservada junto com o evento.

Reportar conversões a partir do seu servidor

Se a conversão ocorrer no lado do servidor (um webhook do seu fornecedor de pagamentos, por exemplo) em vez de no navegador, leia o parâmetro styrar_ck a partir da requisição original e envie-o diretamente:

RequestPOST

Content-Type: application/json

{
  "clickToken": "the styrar_ck value",
  "eventName": "purchase",
  "value": 49.99
}

Response200 OK

{
  "ok": true
}

Esta é a mesma requisição não autenticada que o pixel do navegador faz. Não há chave de API — o clickToken está limitado a um único clique e não é enumerável, por isso funciona também como credencial.

Referência de API

Plain text

GET  /v1/pixel/styrar.js   # the embeddable script, no auth required
POST /v1/pixel/track        # records a conversion event, no auth required

Corpo de POST /v1/pixel/track:

Campo	Obrigatório	Descrição
`clickToken`	Sim	O valor `styrar_ck` do URL de destino ou do `localStorage`
`eventName`	Sim	Até 64 caracteres
`value`	Não	Número, por exemplo o valor do pedido
`eventData`	Não	Objeto JSON arbitrário, até 4 KB serializados
`pageUrl`	Não	Até 2048 caracteres; o script envia `window.location.href` automaticamente

O endpoint responde sempre 200 { "ok": true } — incluindo para um clickToken não reconhecido ou expirado — para que o pixel nunca mostre um erro numa página que não controla totalmente.

Privacidade e segurança

O pixel envia apenas o token de clique, o nome/valor/dados do evento que lhe passar, e o URL da página atual. Não estão envolvidos cookies, fingerprinting, ou identificadores entre sites.
O /v1/pixel/track tem limite de taxa por IP (120 requisições/minuto) para absorver abusos sem afetar o tráfego normal.
O clickToken é um identificador aleatório limitado a um único clique — não pode ser adivinhado a partir do código curto de um link ou de qualquer outro valor público.

Limites

O rastreio de conversões requer que um teste A/B esteja configurado no link; a conversão é atribuída à variante que foi mostrada ao visitante no momento do clique.
Não há rastreio automático de visualizações de página — o pixel só reporta eventos que aciona explicitamente, para manter o ruído e o volume de requisições baixos.
Ainda não existe endpoint de exportação ou eliminação em massa para eventos de conversão; contacte-nos se precisar de remover dados de um espaço de trabalho específico.

Relacionado

Webhooks — seja notificado quando um teste A/B é concluído através de link.experiment.completed
Links curtos e códigos QR no centro de ajuda
Rastreadores da página de bio — Google Analytics, Meta, GTM e mais na sua página de bio
Instalar este pixel por plataforma: Shopify · WordPress · Wix · Framer · Lado do servidor