Criando uma fonte

Uma fonte descreve a plataforma de onde vem o tráfego: quais parâmetros pegar do link do anúncio e para onde devolver o postback sobre os eventos. O botão + Adicionar fonte abre uma página de criação separada (não um diálogo pop-up).

Como criar uma fonte

1. Abra Fontes e clique em + Adicionar fonte.

2. (Opcional) Escolha um modelo pronto no campo A partir do modelo — ele preencherá o nome, o postback e o conjunto de parâmetros.

3. Preencha o Nome — como a fonte será chamada nas listas e nas estatísticas.

4. Configure a passagem de eventos: para uma plataforma comum — o campo Postback S2S; para o Facebook — o mapeamento de eventos no bloco Conversions API (preenchido automaticamente quando o modelo facebook é selecionado).

5. Na tabela Parâmetros, verifique quais dados a fonte coloca no link (por padrão — Ad ID, Pixel ID, FB Click ID).

6. Escolha o Status (Ativo / Pausado) e, se desejar, adicione Notas.

7. Clique em Criar. Para sair sem salvar — Cancelar.

observação

O botão Criar fica inativo até que o Nome seja preenchido. Se você não tiver o direito de gerenciar fontes, o formulário abre apenas para visualização.

Análise dos campos

A partir do modelo

Uma predefinição de fonte pronta. Escolher um modelo preenche para você o nome, o postback e o conjunto de parâmetros — depois eles podem ser editados. O campo é opcional: uma fonte também pode ser montada manualmente.

Nome

O nome da fonte na interface. Especifique um nome claro, por exemplo Facebook Ads ou Push network.

Postback S2S

O link pelo qual a Qubix notificará a plataforma sobre um evento (registro, depósito, etc.). Macros são inseridas no link — a Qubix substituirá valores reais por elas ao enviar. Macros disponíveis:

{external_id}, {status}, {revenue}, {payout}, {currency}, {sub_id_N}, {tid}

Exemplo:

https://source.com/postback?subid={external_id}&status={status}&payout={revenue}

Mais sobre as macros e como os parâmetros vão e voltam — Passagem de parâmetros e postback.

Facebook em vez de um postback

Se o modelo facebook for selecionado, o campo Postback S2S é substituído por um bloco Conversions API: os eventos são enviados ao Facebook automaticamente, e você configura apenas o mapeamento "evento Qubix → evento Facebook" (por exemplo, depósito → Purchase). O pixel é retirado do link do clique, o token — do registro de pixels. Mais — Facebook Conversions API e Pixels.

Parâmetros

A tabela descreve quais valores a fonte passa no link do anúncio. Cada linha é um parâmetro com três campos:

• Nome — como o parâmetro é chamado nos formulários e nas estatísticas (por exemplo, Ad ID).
• Chave da URL — sob qual chave o valor chega no link (o que fica antes de =).
• Placeholder — o que a fonte substitui no valor: uma macro da plataforma (por exemplo, {{ad.id}} para o Facebook) ou um valor fixo.

Parâmetros integrados disponíveis:

• Ad ID — o identificador do anúncio. Necessário para vincular os cliques aos anúncios e ver as estatísticas por eles.
• Pixel ID — o identificador do pixel do Facebook. Usado para enviar eventos à Conversions API.
• FB Click ID — a marca de clique do Facebook (fbclid). O Facebook a adiciona sozinho; não há necessidade de configurá-la, mas se ela chegar — a Qubix a salvará.

Para adicionar um parâmetro, selecione-o na lista + Adicionar um parâmetro padrão… abaixo da tabela. Para remover um — clique na cruz na linha.

Ao lado da tabela, a Qubix mostra o bloco Exemplo de URL para um anúncio — um link pronto que pode ser copiado e colado no campo de URL do anúncio na plataforma. No exemplo você pode escolher o seu domínio e um Pixel ID de uma lista.

Dica

Desmarque a caixa Aceitar parâmetros da URL se não quiser que a Qubix salve os parâmetros dos links desta fonte. Por padrão, a caixa está ativada.

Estado

Ativo — a fonte está em uso. Pausado — desativada.

Notas

Texto livre para você e sua equipe. Mostrado sob o nome da fonte na lista geral.

O que vem a seguir

Passagem de parâmetros e postback

Fontes: a lista e o cartão