Guias

Como usar a RevRake com o Voluum.

Para afiliados que rodam campanhas no Voluum e promovem um programa que roda na RevRake. Duas coisas ligam os dois: o seu link de rastreamento leva o click ID do Voluum, e a RevRake envia cada conversão de volta ao Voluum. As duas são configuradas no seu portal do afiliado e não exigem chave.

Última atualização: 5 de outubro de 2026 ← Todos os guias

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 VoluumPreenchido porSignificado
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

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}&currency={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 com sub1= 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. É 0 para 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 2xx em 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_paid e chargeback. 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.

  1. 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
  2. Parameters in Postback URLs - Voluum Documentation https://doc.voluum.com/article/parameters-in-postback-urls lido em 4 de outubro de 2026
  3. Custom conversions - Voluum Documentation https://doc.voluum.com/article/custom-conversions lido em 4 de outubro de 2026
  4. Upselling: Tracking subsequent conversions - Voluum Documentation https://doc.voluum.com/article/upselling-tracking-subsequent-conversions lido em 4 de outubro de 2026

Tem um programa de cassino ou casa de apostas? Crie-o na RevRake, grátis.

Você mesmo cria o seu programa: cadastre-se, confirme seu e-mail e em poucos minutos você está dentro. Gratuito para operadores, para sempre. Sem cartão.

Dúvidas? Escreva para hello@revrake.com