Rastreamento no Telegram Ads

Para um rastreamento mais detalhado do desempenho das campanhas do Telegram Ads e uma atribuição correta das fontes de ações de destino, recomenda-se usar um sistema de analítica.

Macros compatíveis com links web no Telegram Ads

Para um rastreamento detalhado, use macros. O AdsGram as substituirá automaticamente por dados reais no seu link de rastreamento.

• {campaign_id}
• {banner_id}
• {publisher_id}
• {useragent}
• {click_id}
• {ip}
• {campaign} — nome da campanha

IMPORTANTE

Este suporte se aplica apenas a links web no Telegram Ads. As macros do AdsGram continuam sem suporte para links que levam a Telegram Mini Apps (TMA), bots ou canais do Telegram em campanhas do Telegram Ads.

ATENÇÃO

Para que a API de confirmação de conversão funcione corretamente com links web em campanhas do Telegram Ads, a URL da campanha deve incluir a macro {campaign_id}. Se a macro obrigatória estiver ausente, o rastreamento de conversões não funcionará.

Em campanhas do Telegram Ads, as macros do AdsGram não são compatíveis com links que levam a Telegram Mini Apps (TMA), bots ou canais. Por isso, a API de confirmação de conversão não pode ser usada para rastrear conversões desses links em campanhas do Telegram Ads. Para mais informações, veja abaixo Rastreamento de conversões para links dentro do Telegram em campanhas do Telegram Ads.

IMPORTANTE

A macro {publisher_id} é revelada apenas como um identificador exclusivo do editor, sem especificar seu nome ou outras informações de identificação.

Exemplo de URL de campanha:

https://your-tracker.com/?campaign={campaign_id}&banner={banner_id}&pub={publisher_id}&clickid={click_id}

O painel destaca as macros adicionadas ao link e as que estão faltando .

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 substitui o valor da macro quando o 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.

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.