Skip to main content
A Atribuição decide, no momento da Conversão, qual Afiliado (ou Afiliados) recebe o crédito por um Clique, e, em modelos multi-touch, em que proporção a Comissão é dividida entre eles. Cada Programa escolhe um modelo; a decisão é congelada num snapshot na própria Conversão, garantindo auditabilidade total.

​
Como a atribuição acontece

Quando uma Conversão é criada, a Repass monta a lista de cliques candidatos e aplica o modelo do Programa para produzir os vencedores (winners), cada um com um peso em basis points que soma exatamente 10000.
1

Vincular a Conversão a um visitante

A identidade do convertido é resolvida na ordem click_id (S2S) → visitor_id (cookie) → email_hash (cross-device) → fingerprint (probabilístico). O método usado fica registrado em matchMethod.
2

Selecionar os cliques candidatos

Entram apenas Cliques não expirados, não-bot e do mesmo visitante, em qualquer Link de qualquer Afiliado do Programa. A expiração segue a janela de atribuição do Programa, contada a partir do occurredAt do Clique.
3

Aplicar o modelo do Programa

O modelo (first_click, last_click, linear, time_decay ou position_based) transforma os candidatos em vencedores com pesos em basis points.
4

Snapshotar a decisão

A Conversão guarda a lista de candidatos avaliados, o modelo aplicado, os vencedores e seus pesos. Esse snapshot é a fonte de verdade para a geração de Comissões e para reprocessamento.
Janelas de atribuição usam o occurredAt (quando o fato aconteceu), nunca o recordedAt (quando a Repass registrou). Um Clique fora da janela simplesmente não entra como candidato: não há atribuição “tardia”.

​
Os cinco modelos

last_click é o padrão de um Programa novo. Os três modelos multi-touch (linear, time_decay, position_based) distribuem o crédito entre todos os candidatos dentro da janela.
Crédito integral (10000 bps) ao Clique mais antigo dentro da janela. Premia a descoberta: o Afiliado que originou a jornada leva tudo.
Crédito integral (10000 bps) ao Clique mais recente dentro da janela. É o modelo padrão e o mais comum no mercado: o Afiliado que estava mais perto da Conversão leva tudo.
Divide o crédito igualmente entre todos os candidatos. Com 4 cliques, cada um recebe 2500 bps. Bom quando todos os toques têm valor comparável.
O peso bruto de cada Clique é 2^(−Δt/7d): cai pela metade a cada 7 dias de distância em relação ao Clique mais recente. Cliques recentes pesam mais que os antigos, sem zerar a contribuição dos primeiros toques.
40% ao primeiro Clique, 40% ao último e 20% dividido igualmente entre os do meio. Casos de borda: 1 candidato → 100%; 2 candidatos → 50/50 (não há “meio”).

​
Tabela comparativa

​
Multi-touch: divisão de peso em basis points

Nos modelos multi-touch, os pesos brutos do modelo são convertidos em basis points que somam exatamente 10000, distribuindo o crédito de forma proporcional entre os cliques. Cliques que normalizam para 0 bps são descartados: não recebem Comissão nem marcação de convertido.
winners (exemplo: position_based, 4 cliques)
Os vencedores são snapshotados por Clique (para auditabilidade). Na hora de gerar Comissões, os pesos do mesmo Afiliado são agregados: uma cobrança gera no máximo uma Comissão standard por Afiliado. No exemplo acima, aff_...01 aparece em dois cliques (4000 + 1000) e recebe uma Comissão com peso agregado de 5000 bps. A divisão do dinheiro funciona assim: cada parte é arredondada para baixo ao centavo e a sobra do arredondamento vai ao Afiliado de maior peso.
Trocar o modelo de atribuição de um Programa não altera Conversões já criadas: elas mantêm o snapshot original. Para recalcular o histórico sob um novo modelo, use Reprocessamento. O passo a passo de uma divisão multi-touch está em Multi-touch e atribuição.
Quando uma Conversão chega com um Cupom de Afiliado E também há um Clique atribuível de outro Afiliado, vale a política configurável do Programa, snapshotada na Conversão:
Se o dono do Cupom for o mesmo Afiliado de um Clique vencedor, não há conflito: em modelos multi-touch ele apenas aparece como mais um vencedor, e os pesos do mesmo Afiliado são agregados na geração da Comissão.
O Afiliado é identificado pelo próprio Cupom (couponCode). Você não envia um affiliateId ao criar uma Conversão.
Conversão com cupom de afiliado
Veja como Cupons se relacionam com Links em Links e cupons.

​
Autorreferência (self-referral)

Uma Conversão cujo e-mail do cliente pertence ao próprio Afiliado é marcada como self_referral e não gera Comissão. A Conversão é registrada normalmente (para auditoria e antifraude), mas com commissionSkippedReason: "self_referral" e sem snapshot de regra de Comissão.
Autorreferência é um sinal forte de fraude. A partir de 3 tentativas de um mesmo Afiliado, o status dele muda para paused automaticamente e um Evento affiliate.paused é emitido. Detalhes em Conversões e fraude.

​
Próximos passos

Multi-touch e atribuição

Passo a passo de uma divisão multi-touch, com os pesos calculados.

Comissões

Como os pesos da atribuição viram dinheiro, por cobrança.

Conversões e fraude

Estados da Conversão, score de fraude e autorreferência.

Reprocessamento

Recalcular o histórico ao mudar o modelo de atribuição.