Os postbacks são um mecanismo de transferência automática de eventos da tua plataforma (como um sistema de afiliados ou um tracker) para o sistema do Projeto MVP. Permitem-te acompanhar as principais actividades dos utilizadores, como o registo, a primeira compra (depósito) e as compras repetidas.
Com a sua ajuda, poderás ligar a tua fonte de tráfego a acções reais, medir a eficácia das campanhas e contabilizar com precisão as conversões.
Para criar objectivos personalizados, vai à secção “Objectivos”..
Princípios básicos
– Todos os postbacks funcionam utilizando o método de pedido GET.
– Os parâmetros são passados através do URL.
– Quando o evento necessário (registo, depósito, etc.) ocorre, o teu sistema deve enviar automaticamente o pedido adequado para o servidor do Projeto MVP.
– Os dados no interior do URL têm de ser substituídos dinamicamente a partir do teu sistema.
Postback #1 – Registo do utilizador
Quando invocar:
👉 Imediatamente após o registo do utilizador do teu lado.
Formato da consulta:
https://thedinator.com/api/v1/api_send_postback/?clickid={sub_id1}&goal=reg&playerid={playerid}&ow=0
Explicação dos parâmetros:
– clickid – um identificador único de um clique de um rastreador ou afiliado. É necessário para ligar a ação à fonte de tráfego.
– goal=reg – fixa o tipo de evento. Neste caso, é o registo.
– playerid – o ID único do utilizador na tua plataforma.
– ow – o teu ID de conta no sistema MVP Project. Normalmente, este valor é fixo.
O que é importante:
– O clickid deve ser guardado no momento da primeira visita do utilizador à aterragem/pré-aterragem.
– Todas as variáveis entre chavetas {} têm de ser substituídas por dados reais da tua plataforma ou CRM ao enviar.
Postback #2 – Primeiro pagamento (depósito)
Quando deves telefonar:
👉 Após o primeiro depósito bem sucedido do utilizador (primeiro pagamento).
Formato da consulta:
https://thedinator.com/api/v1/api_send_postback/?clickid={sub_id1}&goal=dep&sum={sum}&playerid={playerid}&ow=0
Explicação dos parâmetros:
– clickid – o mesmo ID de clique utilizado durante o registo.
– goal=dep – indica que o evento está relacionado com o primeiro depósito.
– soma – o montante do primeiro pagamento.
– playerid – ID de utilizador único (o mesmo ou o mesmo que durante o registo).
– ow – o teu ID de conta no sistema MVP Project.
Postback #3 – Repetição de depósitos (segundo pagamento e pagamentos subsequentes)
Quando telefonar:
👉 Com cada depósito de utilizador subsequente ao primeiro.
Formato da consulta:
https://thedinator.com/api/v1/api_send_postback/?clickid={sub_id1}&goal=redep&sum={revenue}&sumrd={sumrd}&playerid={custom1}&ow=0
Explicação dos parâmetros:
– clickid – o mesmo ID de clique que foi utilizado na primeira visita.
– goal=redep – identificador do evento: pagamento repetido.
– sum={revenue} – montante do pagamento repetido.
– sumrd – pode duplicar sum se for utilizado em relatórios.
– playerid={custom1} – ID do utilizador (se for diferente do playerid dos postbacks anteriores).
– ow é o teu ID no sistema do Projeto MVP.
Como ligar corretamente os postbuckets
1. Guarda o ID do clique quando o utilizador o visita pela primeira vez
Quando um utilizador chega à tua página pela primeira vez através de um link de afiliado, o sistema deve guardar o valor do clickid ({sub_id1}) para que possa ser utilizado mais tarde ao passar eventos.
2. Configura a chamada do postback necessário para cada evento
– Após o registo → o postback #1 é chamado
– Depois do primeiro depósito → invoca o postback #2
– No caso de depósitos repetidos → invoca o postback #3
3. Verifica se os dados foram substituídos corretamente
Todas as variáveis (entre parênteses rectos) devem ser substituídas por valores reais do teu sistema.
Exemplo:
https://thedinator.com/api/v1/api_send_postback/?clickid=1234567890&goal=reg&playerid=user987&ow=0
Não deve haver {sub_id1} na produção – apenas valores reais.
🛠 Acompanhamento e verificação
Todos os postbacks recebidos são registados no sistema MVP Project. Tu podes:
– Vê a história dos postbucks enviados
– Assegura que são aceites com êxito pelo sistema
– Diagnostica possíveis erros
Se ainda tiveres dúvidas ou precisares de ajuda com a integração, escreve para o apoio técnico do Projeto MVP: @onboarding_mvpproject
Não comenta! Sê o primeiro.