Passagem de parâmetros e postback
Uma fonte conecta a plataforma e o Qubix nas duas direções:
- Do link para o Qubix — quando um visitante clica em um anúncio, o Qubix pega do link os parâmetros necessários (o identificador do anúncio, o pixel, etc.) e os vincula à visita.
- Do Qubix para a plataforma — quando um evento acontece (registro, depósito), o Qubix envia um postback para a plataforma para que ela saiba o resultado.
As configurações de ambas as direções são definidas na fonte — veja Criar uma fonte.
Parâmetros no link do anúncio
Quais valores pegar do link é definido pela tabela Parâmetros da fonte. Para cada parâmetro você especifica:
- Chave da URL — sob qual chave o valor chega no link;
- Placeholder — o que a plataforma vai substituir no valor (uma macro própria ou um valor fixo).
Exemplo de um link para um anúncio do Facebook:
https://your-domain/?pixel=123456789&ad_id={{ad.id}}
Aqui {{ad.id}} é uma macro do Facebook: ao exibir o anúncio, a própria plataforma a substitui pelo identificador real. O link pronto para a sua fonte é montado pelo Qubix no bloco Exemplo de URL para um anúncio no formulário da fonte — ele pode ser copiado e colado no campo de URL do anúncio na plataforma.
O parâmetro Ad ID é necessário para vincular cliques a anúncios e ver as estatísticas por eles. Sem ele a fonte continua funcionando, mas o detalhamento por anúncio fica indisponível.
Sobre os parâmetros no lado do link de campanha — Link de campanha e parâmetros.
Postback S2S: notificando a plataforma
Um postback (server-to-server, S2S) é uma requisição que o Qubix envia à plataforma quando um evento ocorre. O template da requisição é definido no campo Postback S2S da fonte. Macros são inseridas no template — o Qubix substituirá nelas os valores reais antes de enviar:
| Macro | Valor |
|---|---|
{external_id} | O identificador da visita/lead no lado da plataforma. |
{status} | O status do evento (por exemplo, registro, depósito, rejeição). |
{revenue} | A receita do evento. |
{payout} | O pagamento do evento. |
{currency} | A moeda. |
{sub_id_N} | Marcas adicionais (sub_id_1, sub_id_2, etc.). |
{tid} | O identificador da transação. |
Exemplo de template de postback:
https://source.com/postback?subid={external_id}&status={status}&payout={revenue}
Facebook: Conversions API em vez de um postback
Para uma fonte no template facebook, o postback comum não é usado. Em vez disso, o Qubix envia os eventos diretamente para a Facebook Conversions API. Você configura apenas o mapeamento de eventos: qual evento do Qubix corresponde a qual evento do Facebook (por exemplo, depósito → Purchase). O identificador do pixel é pego do link de clique, e o token de acesso — do registro de pixels.
Mais — Facebook Conversions API e Pixels.