O que você precisa do Voluum
Duas coisas: o token que o Voluum substitui pelo click ID dele, que é {clickid}, 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 Voluum | Preenchido por | Significado |
|---|---|---|
cid | {sub1} | sub1 do clique: o click ID que o seu tracker colocou no link. |
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. |
txid | {event_id} | Um ID diferente para cada evento e igual em todos os reenvios. |
et | {event} | O nome do evento: registration, ftd, commission_approved, commission_rejected, commission_paid ou chargeback. |
O endereço de postback do Voluum fica no seu próprio domínio do Voluum, com o caminho /postback. Copie-o do Voluum e mantenha o domínio. cid recebe o click ID; payout, currency e txid, o ID de transação, são opcionais. currency substitui a moeda definida na oferta no Voluum.
O Voluum não tem parâmetro de status. O tipo de conversão viaja em et, o tipo de evento, que o preset preenche com o nome do evento.
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 Voluum no sub1
Acrescente ao link sub1= com o token de click ID do Voluum e use o resultado como URL da oferta no Voluum:
https://track.revrake.com/c/a8Kq2Zx?sub1={clickid} O Voluum substitui {clickid} 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?cid={sub1}&payout={commission}¤cy={currency}&txid={event_id}&et={event} A RevRake traz este template como o preset Voluum: escolha Voluum na lista e ele é preenchido para você.
Substitua YOUR-TRACKER-DOMAIN pelo endereço do seu próprio postback do Voluum, como o Voluum 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 Voluum 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 Voluum usa o que combina com a forma como o Voluum 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 Voluum 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 Voluum 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 Voluum, 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 Voluum, e no Voluum.
Como {status} é mapeado no Voluum
A RevRake dá um nome a cada evento e também uma palavra de status. Um destino criado a partir do preset Voluum envia em {status} as palavras que o Voluum 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 | – | Um jogador foi atribuído ao afiliado. |
ftd | – | Um primeiro depósito rendeu ao afiliado uma comissão CPA. |
commission_approved | – | Uma comissão foi aprovada ao fim do período de retenção. |
commission_rejected | – | Uma comissão em retenção foi rejeitada após uma análise. |
commission_paid | – | Uma comissão foi paga em um lote de pagamento. |
chargeback | – | Um chargeback retirou uma comissão. |
O preset do Voluum envia {event} em et e não envia {status}. Para distinguir os eventos no Voluum, configure no Voluum uma conversão personalizada para cada evento que você marcar, com o nome do evento exatamente como a RevRake envia, por exemplo registration e ftd. Os valores diferenciam maiúsculas de minúsculas.
O Voluum conta uma única vez o mesmo click ID com o mesmo ID de transação, e descarta um postback que os repete. Por isso o preset envia {event_id}, que é diferente para cada evento, em txid, para que os eventos posteriores não sejam descartados. Cada evento que você marcar chega com o payout dele: se você marcar ftd, commission_approved e commission_paid, o Voluum soma a comissão três vezes. Marque aquele que você quer como receita.
Solução de problemas
- O Voluum 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 Voluum respondeu.
- O click ID chega vazio. O clique não tinha
sub1. Verifique se a URL da oferta no Voluum termina comsub1=e{clickid}, e se o clique passou pelo Voluum: 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 Voluum 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.
- Todas as conversões parecem iguais no Voluum. Os nomes dos eventos não foram configurados como conversões personalizadas no Voluum, ou diferem em maiúsculas e minúsculas.
- O payout no Voluum não é o que foi enviado. Verifique a configuração de payout da oferta no Voluum: um payout fixado na oferta é usado no lugar do valor do postback.
O Voluum é um produto do seu próprio fornecedor (https://voluum.com/) 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 Voluum?
- 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 Voluum?
{clickid}. O Voluum 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 Voluum?
- 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 Voluum tiver um parâmetro para eles. - Posso enviar conversões ao Voluum 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 Voluum 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 Voluum vem da documentação do próprio Voluum, 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.
- Track Conversions Using S2S Postback URL - Voluum Documentation https://doc.voluum.com/article/track-conversions-using-s2s-postback-url lido em 4 de outubro de 2026
- Parameters in Postback URLs - Voluum Documentation https://doc.voluum.com/article/parameters-in-postback-urls lido em 4 de outubro de 2026
- Custom conversions - Voluum Documentation https://doc.voluum.com/article/custom-conversions lido em 4 de outubro de 2026
- Upselling: Tracking subsequent conversions - Voluum Documentation https://doc.voluum.com/article/upselling-tracking-subsequent-conversions lido em 4 de outubro de 2026