Programa de Afiliados – Como Funciona para Comerciantes e Afiliados

Visão Geral

Nossa plataforma possui um programa de afiliados para que parceiros ganhem ao indicar novos clientes ou fornecedores. Esta página explica como funciona o rastreamento tanto para afiliados (que compartilham links) quanto para comerciantes (operadores da plataforma que precisam explicar o programa aos afiliados).

Para Afiliados: Como Você Recebe Crédito

1. Rastreamento de cliques

Quando alguém clica no seu link de afiliado e acessa nosso site, esse clique é registrado. Nosso site carrega um pequeno script em todas as páginas para que possamos reconhecer que o visitante veio de você. Você não precisa fazer nada extra; basta compartilhar seu link (por exemplo, com seu código único na URL ou conforme definido pelo comerciante).

2. Rastreamento de cadastros

Rastreamos cadastros (novas contas) e os atribuímos a você quando a pessoa se registra após ter usado seu link.

• Novos clientes: Se alguém se cadastrar como cliente após clicar no seu link, registramos esse cadastro e o vinculamos ao seu código de afiliado.
• Novos fornecedores: Se alguém se cadastrar como fornecedor após clicar no seu link, registramos esse cadastro e o vinculamos ao seu código de afiliado.

O código de afiliado é armazenado na conta do usuário no momento do registro. Não o substituímos se o usuário já estava registrado antes de clicar no seu link.

3. Rastreamento de vendas (conversão)

Rastreamos vendas (pedidos concluídos e pagos) e as atribuímos a você das seguintes formas:

Atribuição por nível de pedido (mesma sessão ou cookie)

Se um visitante usar seu link e fizer um pedido na mesma sessão (ou enquanto o cookie de indicação ainda for válido), anexamos seu código de afiliado a esse pedido. Quando o pedido for concluído e pago, reportamos essa venda ao sistema de afiliados. Isso se aplica a:

• Checkouts como convidado (sem conta ainda): o código é armazenado no pedido.
• Clientes logados: se eles tinham seu link na sessão/cookie no momento do checkout, o pedido é vinculado a você.

Atribuição por nível de cliente (cadastrado via seu link)

Se um cliente se cadastrou via seu link, salvamos seu código na conta dele. Qualquer pedido futuro que ele fizer (enquanto estiver logado) pode ser atribuído a você usando esse código armazenado, mesmo que ele não use seu link novamente no checkout.

Atribuição por nível de fornecedor (cadastrado via seu link)

Se um fornecedor se cadastrou via seu link, salvamos seu código na conta dele. Quando esse fornecedor fizer uma venda (ou seja, o produto ou serviço dele for comprado), podemos atribuir essa venda a você usando o código armazenado na conta do fornecedor.

4. Como escolhemos qual afiliado recebe crédito por uma venda

Para cada pedido concluído, usamos um único código de afiliado, nesta ordem:

1. Código do pedido – se o pedido foi criado com um código de afiliado (por exemplo, do link/cookie no checkout), usamos esse.
2. Código do cliente – se o comprador tem uma conta e essa conta foi criada com um código de afiliado, usamos esse.
3. Código do fornecedor – se o pedido contém itens de um fornecedor cuja conta foi criada com um código de afiliado, usamos esse (por exemplo, o primeiro fornecedor nessa condição no pedido).

Portanto: um pedido é atribuído a no máximo um afiliado, e nunca reportamos o mesmo pedido duas vezes.

5. Comportamento importante para afiliados

• Novos cadastros: Apenas anexamos seu código a usuários no momento do cadastro. Se alguém já estiver registrado e depois clicar no seu link, não atualizamos a conta dessa pessoa com seu código. Ela precisaria usar seu link no checkout para que aquele pedido específico seja atribuído a você (nível de pedido).
• Uma conversão por pedido: Cada pedido é rastreado como conversão no máximo uma vez. Quando o reportamos ao sistema de afiliados, o marcamos para não ser enviado novamente.
• Concluído e pago: Apenas pedidos concluídos e pagos são reportados como vendas.

Para Comerciantes: Resumo Técnico

Se você opera a plataforma ou precisa explicar a configuração para a equipe técnica:

• Cliques: Gerenciados por um script no frontend (ex.: SDK de afiliados) em todas as páginas. O script gerencia o cookie/identificador de indicação.
• Cadastros: Quando um novo usuário (cliente ou fornecedor) é criado, enviamos um evento de cadastro para a API de afiliados com um ID de cadastro único, código de afiliado e, opcionalmente, e-mail e função. Isso é idempotente por ID de cadastro.
• Vendas: Quando um pedido atinge o status "concluído" e "pago", resolvemos o código de afiliado (pedido → cliente → fornecedor, conforme acima), enviamos um evento de conversão por pedido para a API de afiliados (idempotente por ID do pedido) e marcamos o pedido como rastreado para não enviá-lo novamente.
• Checkout como convidado: O código de afiliado da sessão/cookie atual é enviado com a solicitação de criação do pedido e armazenado no pedido para que a venda possa ser atribuída mesmo quando ainda não há uma conta de cliente.

Resumo

Os afiliados recebem crédito por cliques (via link/cookie), cadastros (quando um novo cliente ou fornecedor se registra pelo link deles) e vendas (quando um pedido é concluído e pago, usando código de nível de pedido, cliente ou fornecedor). Cada pedido é contado uma vez. Usuários existentes que clicarem em um link de afiliado posteriormente não recebem o código desse afiliado em sua conta; a atribuição para eles ocorre apenas quando têm o link/cookie do afiliado no checkout (nível de pedido). Isso mantém o programa claro e justo tanto para comerciantes quanto para afiliados.