O que você precisa do Keitaro
Duas coisas: o token que o Keitaro substitui pelo click ID dele, que é {subid}, e o seu endereço de postback com os nomes dos parâmetros. A RevRake preenche cada parâmetro com uma macro:
| Parâmetro do Keitaro | Preenchido por | Significado |
|---|---|---|
subid | {sub1} | sub1 do clique: o click ID que o seu tracker colocou no link. |
status | {status} | A palavra que diz em que ponto a conversão está, nas palavras que o Keitaro conhece. Elas estão na tabela mais abaixo. |
payout | {commission} | A sua comissão como decimal (40.00). Vazia para um cadastro, 0 para uma comissão rejeitada, negativa para um chargeback. |
currency | {currency} | O código ISO da moeda da comissão. |
tid | {conversion_id} | Um ID igual para todos os eventos de uma mesma comissão: o primeiro depósito, a aprovação, a rejeição, o pagamento e o chargeback dela. Um cadastro tem o seu próprio. |
O Keitaro mostra o endereço de postback em Settings → Postback URL. Ele é formado pelo endereço do tracker, pela sua chave de postback e pelos parâmetros de conversão: no template, substitua YOUR-TRACKER-DOMAIN e POSTBACK-KEY pelas duas partes do seu próprio endereço.
subid e status são obrigatórios no Keitaro; payout, currency e tid são opcionais. tid é o ID de transação do Keitaro: um postback com um tid que o Keitaro ainda não viu é registrado como uma conversão separada, e um com um tid que ele conhece altera essa conversão. O preset coloca {conversion_id} ali.
Passo a passo na RevRake
1Crie um link de rastreamento
Abra a página Links de rastreamento do seu portal do afiliado e crie um link por campanha. Cada link tem seu próprio endereço curto em track.revrake.com e pode levar a uma página do site do programa que você escolhe.
2Coloque o click ID do Keitaro no sub1
Acrescente ao link sub1= com o token de click ID do Keitaro e use o resultado como URL da oferta no Keitaro:
https://track.revrake.com/c/a8Kq2Zx?sub1={subid}O Keitaro substitui {subid} pelo click ID dele a cada clique. A RevRake grava o valor com o clique, até 200 caracteres, e o devolve nos seus postbacks como {sub1}. sub2 a sub5 ficam livres para os seus próprios valores, e as tags UTM do link também são gravadas.
3Adicione um destino de postback
Abra a página Postbacks e clique em "Adicionar um destino". O endereço é um template: tudo entre chaves é uma macro que a RevRake preenche a cada conversão.
https://YOUR-TRACKER-DOMAIN/POSTBACK-KEY/postback?subid={sub1}&status={status}&payout={commission}¤cy={currency}&tid={conversion_id}A RevRake traz este template como o preset Keitaro: escolha Keitaro na lista e ele é preenchido para você.
Substitua YOUR-TRACKER-DOMAIN pelo endereço do seu próprio postback do Keitaro, como o Keitaro mostra a você. O portal recusa um template que ainda tem o host de exemplo. Se o seu endereço de postback tem um parâmetro com nome diferente do que está no template, troque o nome e mantenha a macro.
4Escolha os eventos
Marque os eventos sobre os quais este destino deve ser avisado. registration e ftd avisam o Keitaro de um novo jogador e do primeiro depósito dele poucos segundos depois de o operador informá-los. commission_approved, commission_rejected, commission_paid e chargeback acompanham o dinheiro depois.
A RevRake tem dois IDs para um postback. {conversion_id} é igual para todos os eventos de uma mesma comissão, então um tracker que atualiza uma conversão pelo ID dela mantém uma conversão por comissão. {event_id} é diferente para cada evento. O preset Keitaro usa o que combina com a forma como o Keitaro trata um ID repetido; as seções abaixo dizem qual. Uma conta pode ter até 10 destinos.
5Envie um teste e leia o log de entregas
Clique em "Enviar teste" no destino. A RevRake envia na hora uma conversão fictícia e mostra o que o Keitaro respondeu e em quanto tempo. O teste se parece com um primeiro depósito: leva o click ID TEST-CLICK-ID e uma comissão de 40.00. O Keitaro não conhece esse clique, então pode ignorar o teste ou responder com um erro: o que o teste prova é que o endereço está acessível e como fica o endereço preenchido.
Para um teste de ponta a ponta, abra o link da sua campanha pelo Keitaro, para que um click ID real viaje em sub1, e peça ao operador que cadastre um jogador de teste a partir dessa visita. A conversão aparece então no log de entregas, com cada tentativa e a resposta do Keitaro, e no Keitaro.
Como {status} é mapeado no Keitaro
A RevRake dá um nome a cada evento e também uma palavra de status. Um destino criado a partir do preset Keitaro envia em {status} as palavras que o Keitaro conhece; {event} sempre leva o nome do evento. Um destino criado com "Outro / personalizado" envia lead, sale, approved, rejected e paid.
| Evento | {status} | Quando |
|---|---|---|
registration | lead | Um jogador foi atribuído ao afiliado. |
ftd | sale | Um primeiro depósito rendeu ao afiliado uma comissão CPA. |
commission_approved | sale | Uma comissão foi aprovada ao fim do período de retenção. |
commission_rejected | rejected | Uma comissão em retenção foi rejeitada após uma análise. |
commission_paid | sale | Uma comissão foi paga em um lote de pagamento. |
chargeback | rejected | Um chargeback retirou uma comissão. |
O Keitaro conhece lead, sale e rejected, e ignora um postback com um status que ele não conhece. Por isso o preset envia sale também para uma comissão aprovada e para uma comissão paga. Elas levam o mesmo tid do primeiro depósito, então o Keitaro mantém uma venda por comissão e não a conta de novo.
Uma rejeição e um chargeback chegam como rejected com o tid da comissão, e passam essa venda para rejeitada. Quais mudanças de status o Keitaro permite é definido em "Next statuses" de cada tipo de conversão, em Settings → Conversion Types. Um cadastro é um lead com um tid próprio.
Solução de problemas
- O Keitaro não mostra conversões. Abra o log de entregas na página Postbacks. Se não há linha, o evento ainda não aconteceu, ou o destino não está marcado para ele. Se há uma linha, ela mostra o endereço que foi chamado e o que o Keitaro respondeu.
- O click ID chega vazio. O clique não tinha
sub1. Verifique se a URL da oferta no Keitaro termina comsub1=e{subid}, e se o clique passou pelo Keitaro: um link aberto diretamente não tem click ID para levar. - Uma macro chega como foi escrita, entre chaves. A RevRake envia sem alterar um nome que ela não conhece, então um erro de digitação aparece no log de entregas. Compare o nome com a lista de macros.
- O payout está vazio ou zerado. Um cadastro não traz dinheiro, então
{commission}fica vazia para ele. É0para uma comissão rejeitada e negativa para um chargeback. - Uma entrega falhou. O Keitaro precisa estar acessível em um endereço público e responder com um status
2xxem até 5 segundos. Uma entrega com falha é reenviada após 1 minuto, 5 minutos, 25 minutos, 2 horas, 10 horas e 24 horas, e depois marcada como desistida; você pode reenviá-la manualmente. - O destino foi desligado. Depois de 20 falhas seguidas, a RevRake desliga o destino, com um e-mail depois de 5 e depois de 15. Corrija o endereço e ligue-o de novo: todos os postbacks que entraram na fila nesse meio-tempo são enviados.
- O log do Keitaro diz "Conversion type not found". A palavra de status é uma que o Keitaro não conhece. Isso acontece com um destino criado com "Outro / personalizado", que envia
approvedepaid: escolha o preset Keitaro para ele. - O mesmo jogador é contado mais de uma vez no Keitaro. Um destino salvo com uma versão anterior do preset tem
tid={event_id}no endereço, que é diferente para cada evento. Edite o destino e escrevatid={conversion_id}.
O Keitaro é um produto do seu próprio fornecedor (https://keitaro.io/) e é citado aqui apenas para dizer a qual tracker o guia se refere. A RevRake não tem vínculo com ele.
Perguntas
- Preciso de uma chave de API para conectar o Keitaro?
- Não. Os links de rastreamento e os postbacks são configurados no seu portal do afiliado e não exigem chave. Uma chave só é necessária se você quiser ler seus relatórios e comissões por API.
- Qual token eu coloco no sub1 para o Keitaro?
{subid}. O Keitaro o substitui pelo click ID dele a cada clique, e a RevRake devolve o valor no postback como{sub1}.- Quais eventos a RevRake pode enviar ao Keitaro?
- Seis:
registration,ftd,commission_approved,commission_rejected,commission_paidechargeback. Você marca os que quer em cada destino. - O postback leva o valor do depósito?
- Os templates enviam a sua comissão em
{commission}. O depósito por trás dela está disponível como{amount}, com a moeda em{amount_currency}: acrescente-os ao template se o Keitaro tiver um parâmetro para eles. - Posso enviar conversões ao Keitaro e a outro tracker ao mesmo tempo?
- Sim. Uma conta pode ter até 10 destinos, cada um com seu próprio template e seus próprios eventos.
- O que acontece se o Keitaro estiver fora do ar quando ocorre uma conversão?
- O postback é reenviado seis vezes ao longo de cerca de um dia e meio. Cada tentativa fica no log de entregas, e uma entrega desistida pode ser reenviada manualmente.
Fontes
O que este guia diz sobre o Keitaro vem da documentação do próprio Keitaro, como ela estava no dia indicado. Os trackers mudam: se um nome na sua página de postback for diferente do que está neste guia, confie na sua página de postback. O que ele diz sobre a RevRake está no guia de integração e na referência da API.
- Postback | Keitaro https://docs.keitaro.io/en/conversions-and-postback/postback.html lido em 4 de outubro de 2026
- Affiliate network postback | Keitaro https://docs.keitaro.io/en/conversions-and-postback/affiliate-network-postback.html lido em 4 de outubro de 2026
- Conversion types | Keitaro https://docs.keitaro.io/en/settings/conversion-types.html lido em 4 de outubro de 2026
- Placeholders | Keitaro https://docs.keitaro.io/en/landing-pages-and-offers/placeholders.html lido em 4 de outubro de 2026
- Postback Troubleshooting | Keitaro https://docs.keitaro.io/en/conversions-and-postback/postback-troubleshooting.html lido em 4 de outubro de 2026