UTM Parameters
Os UTM params (Urchin Tracking Module) são parâmetros adicionados na URL que identificam de qual campanha, anúncio ou canal o cliente veio. O Rise Bots captura esses parâmetros automaticamente através do sistema de redirecionadores e os envia para o UTMify — sem necessidade de ferramentas externas.
Os 5 parâmetros UTM
Cada parâmetro serve para identificar um nível diferente da campanha. Quanto mais parâmetros você preencher, mais detalhada será a atribuição no UTMify.
| Parâmetro | O que identifica | Obrigatório? | Exemplo |
|---|---|---|---|
utm_source | Plataforma de onde o tráfego vem | Recomendado | facebook, tiktok, google |
utm_campaign | Campanha específica | Recomendado | blackfriday, lancamento_curso |
utm_medium | Tipo de mídia ou posicionamento | Opcional | cpc, stories, reels, infeed |
utm_content | Criativo ou variação do anúncio | Opcional | video_depoimento, imagem_a |
utm_term | Palavra-chave ou segmentação | Opcional | curso_marketing, instagram_feed |
💡 Mínimo recomendado
Para um rastreamento eficaz, use pelo menos utm_source e utm_campaign. Os demais parâmetros adicionam detalhes mas não são obrigatórios.
Como gerar links com UTMs
O Rise Bots oferece um gerador automático de links na aba UTM Generator de cada bot. Ele gera links prontos com as macros corretas para cada plataforma de anúncio.
Acessando o UTM Generator
- Vá em Bots e selecione o bot desejado
- Clique na aba UTM Generator (ou UTMify)
- Escolha a plataforma de anúncio (Meta, TikTok, Google ou Personalizado)
- Copie o link gerado — Bot (Telegram) ou Loja (Browser)
Dois tipos de link
Para cada plataforma, o gerador cria dois links:
| Tipo | URL | Quando usar |
|---|---|---|
| Bot (Telegram) | /go/{short_id}?utm_source=... | Quando o destino é o bot no Telegram (Mini App) |
| Loja (Browser) | /app/{short_id}?utm_source=... | Quando o destino é a loja no navegador |
Ambos capturam os UTMs da mesma forma. A diferença é para onde o cliente é direcionado.
Método 1: UTMify + Meta Ads
O UTM Generator gera links com as macros oficiais do Meta Ads (Facebook/Instagram). As macros são substituídas automaticamente pelos valores reais quando o anúncio é exibido.
Macros do Meta Ads
| Parâmetro | Macro | O que retorna |
|---|---|---|
utm_source | facebook | Valor fixo (identifica a plataforma) |
utm_campaign | {{campaign.name}}|{{campaign.id}} | Nome e ID da campanha |
utm_medium | {{adset.name}}|{{adset.id}} | Nome e ID do conjunto de anúncios |
utm_content | {{ad.name}}|{{ad.id}} | Nome e ID do anúncio |
utm_term | {{placement}} | Posicionamento (feed, stories, reels) |
Link gerado (exemplo)
https://seusite.com/go/a1b2c3d4?utm_source=facebook&utm_campaign={{campaign.name}}|{{campaign.id}}&utm_medium={{adset.name}}|{{adset.id}}&utm_content={{ad.name}}|{{ad.id}}&utm_term={{placement}}
Onde colar no Meta Ads
Abra o Gerenciador de Anúncios do Meta
Acesse o Meta Ads Manager e selecione (ou crie) a campanha desejada.
Vá no nível do anúncio
Navegue até o nível de Anúncio (Ad), não campanha ou conjunto.
Cole a URL no campo de destino
No campo "URL do site" (Website URL), cole o link completo gerado pelo UTM Generator. As macros {{campaign.name}}, {{ad.name}}, etc. serão substituídas automaticamente pelo Meta.
ℹ️ Macros automáticas
Você não precisa substituir as macros manualmente. O Meta Ads faz isso automaticamente quando exibe o anúncio. Por exemplo, {{campaign.name}} será substituído por "BlackFriday2024" se esse for o nome da sua campanha.
Método 2: UTMify + TikTok Ads
O TikTok Ads usa macros no formato __NOME_DA_MACRO__. O UTM Generator do Rise Bots já gera links com essas macros.
Macros do TikTok Ads
| Parâmetro | Macro | O que retorna |
|---|---|---|
utm_source | tiktok | Valor fixo (identifica a plataforma) |
utm_campaign | __CAMPAIGN_NAME__|__CAMPAIGN_ID__ | Nome e ID da campanha |
utm_medium | __AID_NAME__|__AID_ID__ | Nome e ID do grupo de anúncios |
utm_content | __CID_NAME__|__CID_ID__ | Nome e ID do criativo |
utm_term | __PLACEMENT__ | Posicionamento do anúncio |
Link gerado (exemplo)
https://seusite.com/go/a1b2c3d4?utm_source=tiktok&utm_campaign=__CAMPAIGN_NAME__|__CAMPAIGN_ID__&utm_medium=__AID_NAME__|__AID_ID__&utm_content=__CID_NAME__|__CID_ID__&utm_term=__PLACEMENT__
Onde colar no TikTok Ads
Abra o TikTok Ads Manager
Acesse o painel do TikTok Ads e selecione a campanha.
Vá nas configurações do anúncio
No nível de anúncio, localize o campo de URL de destino.
Cole a URL completa
Cole o link gerado pelo UTM Generator no campo "URL de destino" (Destination URL). As macros __CAMPAIGN_NAME__, __CID_NAME__, etc. serão substituídas automaticamente pelo TikTok.
Método 3: UTMify + Google Ads
O Google Ads usa macros no formato {nome_da_macro}. Funciona de forma semelhante às outras plataformas.
Macros do Google Ads
| Parâmetro | Macro | O que retorna |
|---|---|---|
utm_source | google | Valor fixo (identifica a plataforma) |
utm_campaign | {campaignid} | ID da campanha |
utm_medium | {adgroupid} | ID do grupo de anúncios |
utm_content | {creative} | ID do criativo |
utm_term | {keyword} | Palavra-chave que acionou o anúncio |
Link gerado (exemplo)
https://seusite.com/go/a1b2c3d4?utm_source=google&utm_campaign={campaignid}&utm_medium={adgroupid}&utm_content={creative}&utm_term={keyword}
Onde colar no Google Ads
Abra o Google Ads
Acesse o painel do Google Ads e selecione a campanha.
Edite a URL final do anúncio
No nível de anúncio, localize o campo "URL final" (Final URL).
Cole a URL completa
Cole o link gerado. Alternativamente, use o campo "Modelo de acompanhamento" (Tracking Template) para adicionar os parâmetros UTM. As macros {campaignid}, {keyword}, etc. são substituídas automaticamente pelo Google.
💡 Google Ads retorna IDs numéricos
Diferentemente do Meta e TikTok, o Google Ads retorna IDs numéricos para campanha, grupo e criativo (ex: campaignid=12345678). O nome da campanha não é passado diretamente na URL — o UTMify faz a correspondência internamente.
Método 4: Personalizado (UTMs manuais)
Para canais que não são plataformas de anúncio (email marketing, links em bio, posts orgânicos, WhatsApp, etc.), use o modo Personalizado do UTM Generator.
Como configurar
- Na aba UTM Generator, role até a seção Personalizado
- Preencha os campos UTM com os valores desejados
- Copie o link gerado
Exemplos de uso
Email marketing
https://seusite.com/go/a1b2c3d4?utm_source=email&utm_campaign=newsletter_marco&utm_medium=email&utm_content=banner_topo
Link na bio do Instagram
https://seusite.com/go/a1b2c3d4?utm_source=instagram&utm_campaign=bio_link&utm_medium=organico
https://seusite.com/go/a1b2c3d4?utm_source=whatsapp&utm_campaign=grupo_vip&utm_medium=mensagem_direta
YouTube (descrição do vídeo)
https://seusite.com/go/a1b2c3d4?utm_source=youtube&utm_campaign=tutorial_bot&utm_medium=descricao_video&utm_content=link_1
ℹ️ Valores livres
No modo personalizado, os valores UTM são livres — você define o que quiser. O importante é manter um padrão consistente para que os relatórios no UTMify fiquem organizados. Use sempre minúsculas, sem espaços (substitua por _).
Combinando UTMs com Deep Links
Os UTMs e os deep links do Telegram são sistemas complementares que podem funcionar juntos:
| Sistema | O que rastreia | Onde aparece |
|---|---|---|
Deep Link (?start=codigo) | Origem do clique no bot | Dashboard do Rise Bots |
| UTM params | Campanha de anúncio detalhada | Painel do UTMify |
Como funciona na prática
Quando o cliente acessa pelo redirecionador (/go/{short_id}?utm_source=...):
- O redirecionador gera automaticamente um
salesCodeque funciona como deep link - Os UTMs ficam salvos em
redirect_clicks, vinculados a essesalesCode - O cliente é redirecionado para
t.me/SeuBot?start={salesCode}
Ou seja, ao usar o redirecionador, você não precisa configurar deep links manualmente — o sistema faz isso automaticamente. O salesCode gerado serve tanto como deep link (visível no Rise Bots) quanto como chave para recuperar os UTMs no checkout.
💡 Quando usar deep links sem UTMs
Se você não usa anúncios pagos e quer apenas rastrear canais (Instagram, YouTube, email), os deep links diretos (t.me/SeuBot?start=instagram_bio) já resolvem. Os UTMs são mais úteis quando você precisa medir o ROI de campanhas pagas no UTMify com nível de detalhe por criativo e público.
Referência rápida: macros por plataforma
| Dado | Meta Ads | TikTok Ads | Google Ads |
|---|---|---|---|
| Nome da campanha | {{campaign.name}} | __CAMPAIGN_NAME__ | — |
| ID da campanha | {{campaign.id}} | __CAMPAIGN_ID__ | {campaignid} |
| Nome do conjunto | {{adset.name}} | __AID_NAME__ | — |
| ID do conjunto | {{adset.id}} | __AID_ID__ | {adgroupid} |
| Nome do criativo | {{ad.name}} | __CID_NAME__ | — |
| ID do criativo | {{ad.id}} | __CID_ID__ | {creative} |
| Posicionamento | {{placement}} | __PLACEMENT__ | — |
| Palavra-chave | — | — | {keyword} |