Rastreamento de conversões em campanhas do Telegram Ads

Rastreamento de conversões para links dentro do Telegram em campanhas do Telegram Ads

Nas campanhas do Telegram Ads, as macros do AdsGram não são suportadas em links que levam a destinos dentro do Telegram e não são repassadas a esses links de anúncio. Por isso, a API de confirmação de conversão não pode ser usada para rastrear conversões de links que levam a Telegram Mini Apps (TMA), bots ou canais.

Para links dentro do Telegram em campanhas do Telegram Ads, os seguintes eventos-alvo são registrados automaticamente como Goal 1 por padrão:

• TMA — abertura da TMA;
• Bots — início do bot;
• Canais — inscrição no canal.

As conversões são registradas automaticamente, portanto nenhuma configuração adicional é necessária.

Configuração de postbacks de conversão para links web no Telegram Ads

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.

  

• 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 do Telegram Ads. Use uma campanha ativa existente ou crie uma nova.
2. Configure o link de rastreamento. 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&campaignid=72156&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 72156 pelo 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. Crie ou selecione uma campanha do Telegram Ads e configure o link de rastreamento de acordo com a documentação. Certifique-se de que a macro {campaign_id} está incluída no link.
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. Use um token válido e o ID da campanha de teste no parâmetro campaignid.
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, 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.