Como transferir parâmetros e tags UTM

Plataformas como Instagram, Facebook, WhatsApp e Telegram implementam esse mecanismo por meio do visit_key parâmetro.

Suporte a deep link A maioria dos mensageiros (como Instagram, Facebook, Telegram) oferece suporte a deep links. No entanto, outros não.

Alternativa para o WhatsApp Embora o WhatsApp não ofereça deep linking nativo, você ainda pode passar parâmetros e tags UTM. Para isso, insira uma variável especial no texto da mensagem pré-preenchida que aparece para o usuário depois que ele clica no seu link. (Este método será abordado em detalhes mais adiante.)

Armazenamento de parâmetros Todos os parâmetros passados são salvos como variáveis do cliente dentro do sistema.

Estrutura e tipos de parâmetros Um parâmetro é um par nome-valor. Dependendo da origem, os parâmetros podem ser:

Estáticos: Você define o valor exato a ser transmitido.
- Exemplo: utm_term=webinar1 (onde utm_term é o nome e webinar1 é o valor estático).
Dinâmicos: A plataforma de anúncios (por exemplo, Google Ads, Facebook Ads) insere automaticamente os dados relevantes no momento do clique.
- Exemplo: term={palavra-chave} — aqui, o {palavra-chave} espaço reservado é substituído dinamicamente pelo termo de pesquisa real que acionou o anúncio.

Como usar esses parâmetros em um site

Todos os parâmetros enviados ao seu site serão convertidos em variáveis de negócio assim que o cliente iniciar o bot. Isso inclui tags UTM e outros rótulos.

Para obter o link do seu site, vá para a seção "Sites" seção.

Exemplo de adição de tags UTM a um link de site:

https://mavibot.ai/st/black_friday_mavibot?utm_source=test_wi_me&utm_medium=cpc&utm_campaign=id_campaign&utm_content=registration

Os parâmetros e rótulos serão enviados ao bot e salvos como variáveis do cliente.

Como usar esses parâmetros sem um site

Você pode usar links proxy para passar parâmetros diretamente. Assim que o bot for iniciado por meio de tal link, todos os dados transmitidos serão salvos como variáveis de negócio.

O formato do link com parâmetros deve ser o seguinte:

Estrutura do link proxy

Um link proxy parametrizado consiste em duas partes:

URL base (o próprio link proxy): https://mavibot.ai/r/mavibot_1
String de consulta (seus parâmetros): ?param1=value1&param2=value2

Exemplo: adicionando tags UTM a um link do Telegram

Aqui está um exemplo de um link direto de um site para o Telegram com parâmetros UTM:

https://mavibot.ai/r/mavibot_1?utm_medium=cpc&utm_source=yandex&utm_term=key_phrase&utm_content=HappyNY#ancor

Links diretos de mensageiros em "Sites"

Esta seção exibe links clicáveis para todos os mensageiros integrados ao seu sistema.

Recursos do WhatsApp

Como o WhatsApp não oferece suporte a deep links, você deve adicionar uma variável especial à mensagem de abertura do bot. O bot usará essa variável para identificar os parâmetros com os quais o WhatsApp foi iniciado.

A variável: #{visit_key}

Quando um usuário clica no seu link do WhatsApp, esse espaço reservado será substituído automaticamente por um código numérico único contendo os parâmetros enviados.

"Sites" → Site → Configurações da página do site → Mensageiros → Configurações do WhatsApp

Quando um usuário acessa o WhatsApp a partir do seu site (ou por meio de um link de mensageiro nas configurações do site), o #{visit_key} espaço reservado é substituído por um código numérico único.

Inscrição no Instagram

Evolução do rastreamento de parâmetros

Método anterior (#{visit_key}):
O #{visit_key} a variável era usada ao colocá-la na "Mensagem inicial do WhatsApp". Isso permitia rastrear os parâmetros de inicialização das interações no Instagram.
Método atual (deep links com parâmetros de referência):

Agora você pode passar parâmetros de referência diretamente por meio de deep links do Instagram, oferecendo maior flexibilidade e controle.

Benefícios de usar parâmetros de referência:

Com parâmetros de referência, você pode:

Rastrear campanhas ao vincular cliques a fontes ou canais específicos.
Atribuir usuários ao conectar um visitante do Instagram a uma sessão ou conta no seu aplicativo externo.
Personalizar jornadas ao direcionar os usuários para conteúdo segmentado ou recursos específicos dentro da sua conta do Instagram.