Configuração de postbacks de conversão para links de destino do ecossistema do Telegram

ATENÇÃO

As instruções desta seção não se aplicam a campanhas do Telegram Ads. Para mais informações sobre o rastreamento de conversões para links dentro do Telegram em campanhas do 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.

  

• tgid — o ID do Telegram do usuário que clicou no link do anúncio.

• campaignid — o ID da campanha publicitária do AdsGram à qual a conversão pertence. Corresponde ao valor da macro {campaign_id} passada no link do anúncio. O AdsGram insere o valor da macro quando um usuário clica no link.

• 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 do anúncio. Certifique-se de que ele contém a macro {campaign_id}.
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&tgid=98110997&goaltype=2&campaignid=72156

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

Substitua os valores do exemplo pelos seus dados reais:

• YOUR_UNIQUE_TOKEN — o token da sua conta do AdsGram;
• 98110997 — o ID do Telegram do usuário que clicou no link do anúncio;
• 72156 — o ID da sua campanha publicitária.

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 do anúncio de acordo com a documentação e certifique-se de que ele contém a macro {campaign_id}.
2. Aguarde os cliques. Aguarde até que os usuários tenham clicado algumas vezes no link do anúncio.
3. Obtenha o ID do Telegram do usuário. Obtenha o tgid de um usuário que clicou no link da campanha selecionada.
4. Envie manualmente um postback de teste. Defina goaltype=1 e informe um token válido, o ID do Telegram do usuário no parâmetro tgid e o ID da campanha de teste no parâmetro campaignid.
5. 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, tgid, campaignid 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.