Rastreamento de conversões

Todo clique registrado recebe um ID de clique curto e único. Passe-o para o seu site, informe-o de volta quando alguém converter e o Letlink atribui o lead, a venda ou o cadastro ao link, à campanha, ao país e ao dispositivo exatos.

1. Envie o ID de clique para o seu site

Ative Adicionar ID de clique no link. Os visitantes passam a chegar com ?lk_click=… no destino. Você pode renomear o parâmetro nas configurações de conversão — muitas redes de afiliados esperam subid ou clickid.

Ou coloque você mesmo tokens na URL de destino. {click_id} é substituído pelo ID de clique (e nada é adicionado), e estes também funcionam: {slug}, {country}, {device}, {utm_source}, {utm_medium}, {utm_campaign}, {utm_term}, {utm_content}.

https://shop.example.com/offer?subid={click_id}&src={utm_source}&geo={country}

2a. Informe conversões pelo navegador

Adicione o snippet a todas as páginas do seu site. Ele guarda o ID de clique em um cookie próprio e no armazenamento local, e depois informa as conversões quando você chama letlink().

<script>window.letlink=window.letlink||function(){(letlink.q=letlink.q||[]).push(arguments)};</script>
<script async src="https://letl.ink/t.js" data-param="lk_click"></script>

<!-- on the thank-you page -->
<script>
  letlink('sale', { value: 49.90, currency: 'USD', order_id: 'ORDER-123' });
</script>

Os eventos são lead, sale, signup e custom (com event_name). Campos opcionais: value, currency (código ISO), order_id, email (usado pelas integrações SendGrid e Mailchimp) e metadata (um pequeno objeto com campos extras).

2b. Informe conversões de servidor para servidor

Lojas, CRMs e redes de afiliados podem chamar a URL de postback com GET ou POST:

https://letl.ink/postback?click_id={click_id}&event=sale&amount=49.90&currency=USD&txid=ORDER-123

• ID de clique: click_id, clickid, cid, subid, sub_id, aff_sub.
• Valor: amount, payout, value, revenue. Um valor negativo é um reembolso.
• Transação: txid, transaction_id, order_id.
• Status: approved (padrão), pending, declined ou refunded. Informe primeiro uma venda pendente e aprove-a depois com o mesmo ID de transação.
• Chave de postback: defina uma nas configurações de conversão e adicione key=… a cada postback; postbacks sem ela são recusados.

Ou chame POST /api/v1/conversions com o seu token de API (Growth e Ultimate).

Respostas

O postback e a API sempre respondem 200 com um cabeçalho X-Letlink-Result: created, updated (um novo status para uma transação conhecida), duplicate, unknown_click, bad_key, outside_window, not_allowed (plano) ou invalid. Tentar de novo nunca ajuda, então as redes não devem fazer isso.

Deduplicação e atribuição

• Uma conversão é contada uma única vez por ID de clique, evento e ID de transação, seja qual for o canal que a informe primeiro.
• A atribuição é de último clique: o snippet sempre guarda o ID de clique mais recente.
• Uma conversão só conta dentro da janela de atribuição após o clique — 30 dias por padrão, ajustável de 1 a 365 dias.

Envie conversões para suas plataformas de anúncios

No Growth e no Ultimate, ative Encaminhar conversões aprovadas para enviá-las como eventos de compra, lead e cadastro às Conversions APIs da Meta, TikTok, LinkedIn, Pinterest, Snapchat e Reddit e às suas integrações de análise, associadas ao clique original no anúncio. Google Tag Manager, Adobe Analytics, SendGrid e Mailchimp sempre as recebem.