Configuração de postbacks de conversão para links de destino web

ATENÇÃO

As instruções desta seção não se aplicam a campanhas do Telegram Ads. Para configurar postbacks de conversão para links web no Telegram Ads, consulte esta seção.

Parâmetros:

• token — um token exclusivo associado à sua conta. Ele está disponível no painel do AdsGram e pode ser regenerado, se necessário.

  Como obter seu token:

  1. Abra o painel do AdsGram.
  2. Clique no seu perfil no canto superior direito.
  3. Encontre o parâmetro token e clique no botão de copiar para copiá-lo.

  

• record — um valor exclusivo para cada clique ou impressão, correspondente à macro {record_data}. O AdsGram insere esse valor automaticamente no link de rastreamento.

• goaltype — um parâmetro que especifica o tipo de conversão (etapa do funil), ajudando a segmentar várias ações do usuário. Aceita valores inteiros de 1 a 3.

  Uso de goaltype:

  1. Defina as etapas do funil no seu produto ou serviço.
  2. Atribua as etapas aos valores de goaltype:
     • 1. Registro
     • 2. Primeiro depósito/compra
     • 3. Depósito/compra repetido
  3. Configure o rastreamento de conversões para as etapas relevantes da jornada do usuário.
  4. Adicione o parâmetro goaltype à sua solicitação de API ao enviar dados de conversão.
  5. Use este parâmetro na sua analítica para realizar uma análise de desempenho detalhada por tipo de conversão.

Como configurar o rastreamento de conversões:

1. Selecione uma campanha. Use uma campanha ativa existente ou crie uma nova.
2. Configure o link de rastreamento. Certifique-se de que ele contém a macro {record_data}.
3. Obtenha seu token. Copie seu token exclusivo no painel do AdsGram.
4. Configure o envio de postbacks. Configure seu servidor para enviar uma solicitação de API ao AdsGram sempre que um usuário concluir uma ação-alvo.
5. Especifique o tipo de conversão. Defina o valor de goaltype adequado se quiser distinguir entre as etapas do funil.
6. Teste a integração. Siga os passos da seção Teste da integração abaixo e verifique se as conversões aparecem nas estatísticas do AdsGram.

Exemplo de solicitação de API ao registrar uma conversão:

GET
https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&record=7f3a1b6c5d2e4f8a&goaltype=2

Neste exemplo, goaltype=2 representa uma conversão como um primeiro depósito ou compra.

Substitua YOUR_UNIQUE_TOKEN pelo token da sua conta e 7f3a1b6c5d2e4f8a pelo valor real de {record_data} do link de rastreamento.

Resposta esperada: 200 OK — a conversão foi registrada com sucesso.

Teste da integração

Para testar o rastreamento de conversões, siga estes passos:

1. Crie ou selecione uma campanha. Configure o link de rastreamento de acordo com a documentação e certifique-se de que ele contém a macro {record_data}.
2. Aguarde os cliques. Aguarde até que os usuários tenham clicado algumas vezes no link de rastreamento.
3. Envie manualmente um postback de teste com o parâmetro goaltype=1. Informe um token válido no parâmetro token e, no parâmetro record, o valor real de {record_data} do link de rastreamento clicado.
4. Verifique o resultado. Confirme que a solicitação foi processada com sucesso e que a conversão aparece nas estatísticas do AdsGram para a campanha selecionada.

Solução de problemas

• A conversão aparece nas estatísticas: a integração está configurada corretamente e funciona no cenário testado.
• O servidor retorna um erro: verifique a URL da solicitação e os valores dos parâmetros token, record e goaltype.
• A solicitação é bem-sucedida, mas a conversão não aparece: as estatísticas são atualizadas uma vez por hora. Se a conversão ainda não aparecer após uma hora, entre em contato com o suporte do AdsGram ou com seu gerente de conta. Não deixe de anexar os logs da solicitação e da resposta.