Sub-afiliados: relay de postback, comissões e regras por merchant
Como cadastrar parceiros que recebem repasse automático de conversão, os tipos de comissão, as macros do Relay URL, as regras por merchant e evento, e como vincular à campanha.
Um sub-afiliado é um parceiro que divulga os seus links e recebe, automaticamente, um postback de saída a cada conversão — com o valor da comissão dele calculado pela regra que você definiu. Menu Sub-afiliados (seção Portal de parceiros).
Cadastrar
+ Novo sub-afiliado:
| Campo | Valor |
|---|---|
| Nome | Identificação do parceiro. |
| E-mail (opcional) | Contato. |
| Comissão padrão | Fixo (valor por conversão), % sobre o recebido (percentual do payout), CPA (valor fixo por conversão, semântica de aquisição) ou Revshare (percentual, semântica de participação). |
| Valor padrão | O valor ou o percentual. |
| Relay URL (postback de saída) | A URL do tracker do parceiro, com as macros abaixo. Em branco, o sub-afiliado fica só no controle interno — sem disparo. |
| Notas | Livre. |
Vincular à campanha
Em Rastreio de anúncios › + Nova campanha (ou editar), o campo Sub-afiliado. O padrão é uma campanha por parceiro, clonada da campanha-mãe, para que cada um tenha o seu link. Dentro da campanha, use a rota curta /r/SLUG/variacao para sub-IDs do próprio parceiro. Veja Sub-IDs.
O que acontece na conversão
Quando um clique de uma campanha com sub-afiliado gera uma conversão (created), o Affilitrack dispara em segundo plano uma requisição GET para o Relay URL, substituindo as macros:
| Macro | Valor |
|---|---|
{click_id} | O click_id da conversão |
{valor} | O valor repassado — calculado pela regra de comissão, não o payout bruto |
{evento} | O tipo/evento da conversão (SALE, LEAD, ou o slug) |
{txid} | O ID da transação |
Exemplo de Relay URL para um parceiro que usa outro tracker:
https://tracker-do-parceiro.com/postback?cid={click_id}&payout={valor}&event={evento}&tx={txid}O disparo não bloqueia nem falha a conversão. Se o parceiro estiver fora do ar, a conversão fica gravada normalmente.
Regras por merchant e evento
A comissão padrão vale para tudo. Para exceções — "na Betano, o FTD paga 50 fixo; o depósito paga 10%" — use as regras do sub-afiliado: cada regra é merchant + evento → tipo e valor de comissão. Pela API: PUT /api/affiliates/{id}/terms com merchant_id, event_type, commission_type, commission_value. A regra que casa merchant e evento vence a comissão padrão.
Controle sem relay
Sem Relay URL, o sub-afiliado é apenas um rótulo na campanha e nas conversões, para você fechar o acerto no fim do mês pelo relatório por campanha. É útil quando o parceiro não tem tracker.
Boas práticas
- Peça ao parceiro a URL de postback dele com as macros dele, e traduza para as quatro macros acima.
- Teste com o Simulador: dispare uma conversão na campanha do parceiro e confira, no tracker dele, a chegada.
- Comissão sobre o recebido calcula sobre o payout do postback — garanta que o
payoutque chega é a base correta (comissão ou valor bruto).