--- title: "Rastreamento no Telegram Ads: macros e postbacks de conversão" description: "Como rastrear campanhas do Telegram Ads no AdsGram: macros para links web, postbacks de conversão pela API de confirmação de conversão e eventos automáticos no Goal 1 para Mini Apps, bots e canais." outline: [2,4] --- # 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 > [!IMPORTANT] 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. ::: warning 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](#rastreamento-de-conversoes-para-links-dentro-do-telegram-em-campanhas-do-telegram-ads). ::: > [!IMPORTANT] 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 Added macros e as que estão faltando Missed macros. ![Macros selecionadas](../../advertiser/images/selected_macroses.webp =500x) ## 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. 1. Clique no seu perfil no canto superior direito. 1. Encontre o parâmetro `token` e clique no botão de copiar Copy para copiá-lo. ![Copiar macros](../../advertiser/images/copy_macros.webp =200x) - `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. 1. Atribua as etapas aos valores de goaltype: - 1. Registro - 2. Primeiro depósito/compra - 3. Depósito/compra repetido 1. Configure o rastreamento de conversões para as etapas relevantes da jornada do usuário. 1. Adicione o parâmetro goaltype à sua solicitação de API ao enviar dados de conversão. 1. 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. 1. **Configure o link de rastreamento.** Certifique-se de que ele contém a macro `{campaign_id}`. 1. **Obtenha seu token.** Copie seu token exclusivo no painel do AdsGram. 1. **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. 1. **Especifique o tipo de conversão.** Defina o valor de `goaltype` adequado se quiser distinguir entre as etapas do funil. 1. **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. 1. **Aguarde os cliques.** Aguarde até que os usuários tenham clicado algumas vezes no link de rastreamento. 1. **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`. 1. **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.