Atribuição e links
Como o clique do afiliado vira um jogador atribuído.
Formatos de link do redirector
| Formato | Exemplo | Uso |
|---|---|---|
| Padrão | /home/1234567 | /<target>/<deal_public_id> gerado no painel do afiliado |
| Customizado | /c/AbC123xYz9 | Link salvo pelo afiliado com UTMs fixas |
| Legado | /home/7654321/global | /<target>/<afiliado>/<deal>, aceita o deal global |
O target é o destino cadastrado pela marca (home, cadastro, landing de campanha) e define o parâmetro que carrega o clique. Por padrão ele se chama btag.
O que chega no site da marca
https://suamarca.com/?btag=66509f0e2b1c4d5e6f708192&utm_source=instagram&utm_campaign=setembro&_cb=20260929btag: id do clique. É o único valor que a marca precisa guardar.- Demais parâmetros: repassados do link. Se algum colidir com o nome do
btag, ele chega comor_<nome>. _cb: cache-buster do redirector, pode ser ignorado.
Regras da atribuição
Depois que um btag é usado num player.registered aceito, ele fica marcado como atribuído. Reusar o mesmo btag para outro jogador resulta em IGNORED com o motivo Tag já atribuída.
Um segundo player.registered para o mesmo external_player_id é ignorado, mesmo com outro btag. A primeira atribuição vale.
Uma tag gerada por um target de outra marca não é aceita. Isso evita que links de uma marca atribuam jogadores em outra.
Cliques não atribuídos são apagados após 180 dias. Um cadastro com btag mais antigo que isso é ignorado.
Consultar a atribuição
Para saber se um jogador é de afiliado (por exemplo, para exibir um selo no backoffice da marca):
GET /v1/integration/players/{external_player_id}/attributionDetalhes em Endpoints.