Código de otimização (Postback URL de afiliado)

  • Atualizado

Se você usa seu próprio sistema de relatórios de vendas e leads trabalhando com a Admitad, pode adicionar o postback URL do seu servidor ao nosso sistema e receber instantaneamente todas as informações sobre as conversões concluídas.

Chamamos essa ferramenta de Código de otimização, pois ela ajuda a criar um sistema de relatórios personalizado capaz de otimizar seu trabalho.

O sistema de relatórios personalizado é conveniente porque permite obter todos os dados iniciais sobre as ações e convertê-los a seu critério em tabelas, gráficos e diagramas ou usá-los em seus aplicativos. Isso também facilita o trabalho com múltiplas redes de afiliação, já que reúne todos os relatórios em um só lugar. Os dados são transmitidos do servidor Admitad Affiliate para o seu servidor através dos métodos de requisição GET e POST HTTP.

A seu dispor estão mais de 20 parâmetros contendo todas as informações sobre uma ação, desde o primeiro clique em seu link de afiliado até o status de seus ganhos. Analisados ​​adequadamente, todos esses dados podem ajudar a melhorar significativamente a taxa de conversão de seus anúncios.

Adicionando um código de otimização (Postback URL)

Clique na seção Ferramentas e selecione Postback URL.

Clique em Adicionar um Postback URL.

Você pode adicionar vários postbacks URL e personalizá-los.

pstbckpt_1.png


No campo Tipo de evento, selecione que tipo de informação será transmitido para o postback URL indicado:

  • Ação: os dados serão enviados cada vez que uma ação for realizada (lead ou venda).
  • Status de programa: os dados serão enviados cada vez que o status de um programa afiliado a que você estiver aderido for alterado (quando o programa for suspenso ou voltar a funcionar).
    Selecione um programa e um espaço publicitário abaixo.
  • Um indicado juntou-se: os dados serão enviados cada vez que um novo afiliado fizer um cadastro no Admitad Affiliate por meio do seu link de referência.

pstbckpt_2.png

Selecione um espaço publicitário que servirá de fonte para os relatórios.

Você também pode selecionar a opção Todos os espaços publicitários e, depois, filtrar todas as ações pelos parâmetros Nome do espaço publicitário e ID do espaço publicitário em seu sistema. Leia mais sobre os parâmetros disponíveis logo abaixo.

pstbckpt_3.png

Selecione um programa afiliado que servirá de fonte para os relatórios.

Você também pode selecionar a opção Catálogo de programas.

pstbckpt_4.png

Se você selecionar um dos programas afiliados da lista suspensa, o campo Taxa será exibido em seguida.

Você pode deixar esse campo vazio para que os dados enviados incluam as informações sobre todas as taxas.

pstbckpt_5.png

Se uma taxa específica não for selecionada, você pode especificar o tipo de ação: Sale, Lead ou Todas.

  • Sale é uma ação de um usuário que confirmou seu pedido no site de uma loja virtual. No entanto, esse pedido ainda pode ser alterado ou cancelado.
  • Lead é uma ação de um usuário que fez um cadastro, se inscreveu em uma newsletter, instalou um aplicativo ou atingiu certo nível em um jogo online.

pstbckpt_6.png

Selecione um método de requisição que você gostaria de usar para receber informações.

A principal diferença entre os métodos GET e POST é a forma de transmissão de dados:

  • o método GET envia para você todas as informações coletadas como parte da URL, adicionando os parâmetros e seus valores ao final do link;
  • o método POST envia os dados no corpo da requisição em vez da URL.

Leia mais sobre cada um dos métodos aqui.

9. Selecione um status de ação que servirá de fonte para os relatórios.

  • Criado: um visitante que você direcionou para o site do anunciante realizou uma ação: fez uma compra, instalou um aplicativo, atingiu o nível necessário em um jogo online, entre outras. O status permanecerá assim até o anunciante confirmar ou rejeitar a ação.
  • Confirmado: o anunciante processou e confirmou a ação.
  • Rejeitado: o anunciante processou e rejeitou a ação.
  • À espera: a ação foi confirmada, mas depois voltou a ser processada. Diferentemente desse status, o status Criado é atribuído aos pagamentos que caíram no sistema pela primeira vez.

pstbckpt_7.png

Insira o link de seu servidor que será usado para receber a requisição HTTP.

pstbckpt_8.png

Selecione um dos dois modos de edição:

  • Modo simples é um modo que permite enviar uma requisição contendo todos os parâmetros e atribuir a eles nomes padrão adotados no sistema Admitad Affiliate.

    pstbckpt_9.png

  • Modo avançado é um modo que permite criar uma lista de parâmetros desejados e atribuir os nomes que você já está usando em seu sistema. Para isso, insira o nome de um parâmetro no campo homônimo e arraste o valor correspondente do bloco Conteúdo de parâmetro, à direita, para um dos campos homônimos:

    pstbckpt_10.png


Se você tinha a requisição GET selecionada, um URL com todos os parâmetros escolhidos e seus conteúdos, listados depois do símbolo "?", será exibido no campo Link gerado:

pstbckpt_11.png

Esse será o link para receber e enviar as requisições HTTP para o seu servidor. O marcador [[[...]]] será substituído por valores de parâmetros reais.
 

Depois que você adicionar todos os parâmetros desejados, teste o link clicando em Testar na parte inferior da página.

pstbckpt_12.png

Dependendo do método de requisição selecionado, você verá uma das seguintes janelas:

Requisição GET Requisição POST

pstbckpt_13.png

 

URL com os valores de parâmetros de teste que serão enviados para seu servidor. Você pode substituir esses valores pelos seus próprios, editando o código.

pstbckpt_14.png

No campo superior, você verá um URL que receberá a requisição; no inferior, os parâmetros e seus valores de teste do corpo da requisição. Nesse caso, você não pode colocar seus valores de teste.


Clique em Testar para enviar a requisição e verá a seguinte notificação: "A requisição foi enviada para seu endereço".

Confira seu sistema de relatórios para ver se os dados foram recebidos.

Se a requisição foi enviada, mas os dados não chegaram, entre em contato com o suporte técnico.

Se seu servidor não aceitar requisições POST, estiver indisponível ou o endereço especificado estiver incorreto, aparecerá a seguinte mensagem: "Ocorreu um erro durante a solicitação. Verifique o endereço".

Se todos os dados forem enviados corretamente para seu servidor, feche a janela de teste e salve o novo código de otimização:

pstbckpt_15.png

Ele aparecerá na tabela de códigos. Você pode editar e testar códigos a qualquer momento clicando em um dos ícones da coluna Configurações.



Tipos de parâmetros e seus valores válidos

Parâmetros para o tipo de evento "Ação"

Nome Formato de valor Descrição
offer_id número inteiro ID do programa afiliado
offer_name string Nome do programa afiliado
admitad_id número inteiro ID do pagamento
website_name string Nome do espaço publicitário
website_id número inteiro ID do espaço publicitário
subid string SubID
Válido para os valores subid, subaccount, source_id, affiliate_id, creative_id, adset_id
action string Nome da taxa
subid1 string SubID1
subid2 string SubID2
subid3 string SubID3
subid4 string SubID4
Válido para os valores click_id, transaction_id.
payment_sum número decimal Valor de seus ganhos
payment_status string, opções: Status do pagamento
new - um novo pagamento que não foi confirmado nem rejeitado
approved - pagamento confirmado
declined - pagamento rejeitado
pending - um pagamento confirmado voltou a ser colocado em espera
currency string (máx. 3 caracteres) Moeda do programa
order_id número inteiro ID do pedido
order_sum número decimal Valor do pedido
click_time Unix-time Hora do clique
time Unix-time Hora da ação
conversion_time número inteiro Tempo de conversão (s)
type string, opções: Tipo de ação
lead
sale
country_code string Código do país no formato RU / BR / US
user_agent string Agente de usuário
user_referer string Usuário de referência
action_id número inteiro ID da taxa

 

Parâmetros para o tipo de evento "Status de programa"

Nome Formato de valor Descrição
offer_id número inteiro ID do programa afiliado
offer_name string Nome do programa afiliado
offer_status string, opções: Nome do status do programa afiliado
active - o programa está ativo e coopera com você
denied - o programa rejeitou sua solicitação de cooperação
disabled - o programa está desativado, mas pode ser reativado em breve
dead - o programa foi excluído e não voltará mais a funcionar no Admitad Affiliate

 

Transferência dos parâmetros click_id e transaction_id

Se você deseja implementar seus parâmetros click_id e transaction_id em um link de afiliado, adicione o parâmetro subid4.

Exemplo de link:
https://ad.admitad.com/g/f469ae904cb7e16523942b59d5275c/?subid4={click_id}

O parâmetro entre as chaves {click_id} deve ser substituído pelo seu parâmetro click_id.

Esse artigo foi útil?