# Rastreamento de origem com UTM

Source: https://docs.rooquiz.com/pt-BR/publish/tracking

> O rastreamento de origem com UTM identifica de onde veio cada resposta para você comparar canais. Entenda os parâmetros, como montar um link com tags para cada canal e onde os números aparecem.

Quando você distribui o mesmo quiz em vários canais, o **rastreamento de origem com UTM** ajuda a saber de onde veio cada resposta, para que você possa avaliar a eficácia de cada canal.

## O que é UTM

UTM é um conjunto de parâmetros adicionados a um link para identificar a origem do tráfego. Os mais comuns são:

* **Source** (origem): por exemplo `facebook`, `linkedin`, `x`, `newsletter`.
* **Medium** (mídia): por exemplo `post`, `bio`, `email`, `cpc`.
* **Campaign** (campanha): o nome desta campanha, por exemplo `spring-launch`.

## Como usar

No quiz desejado, abra **Compartilhar** → **Plano de divulgação**. Cada cartão de canal incluído já tem o seu próprio link com tags UTM. Para qualquer outro canal, clique em **Adicionar canal** e preencha **utm\_source** (obrigatório), **utm\_medium** e **utm\_campaign** (ambos opcionais); o novo cartão recebe o seu próprio link rastreado. Veja [Plano de divulgação](https://docs.rooquiz.com/pt-BR/publish/promotion).

Os valores UTM só podem conter letras, números, sublinhados e hifens.

Incorporações em sites também podem levar tags UTM — veja os atributos `data-rooquiz-utm-*` em [Incorporar](https://docs.rooquiz.com/pt-BR/publish/embed#atributos-disponíveis).

## Ver os dados de origem

Quando os respondentes enviam respostas por um link com tags UTM, a origem é registrada junto com a resposta. Os parâmetros UTM de qualquer link (`utm_source`, `utm_medium`, `utm_campaign`) são salvos dessa forma, quer o link tenha vindo do Plano de divulgação, quer você o tenha montado manualmente. Você pode distinguir e analisar por origem em [Registros de respostas](https://docs.rooquiz.com/pt-BR/results/records) e em [Insights](https://docs.rooquiz.com/pt-BR/results/insights).

<Callout type="info">
  Usar uma **nomenclatura clara e consistente** para cada canal (por exemplo, tudo em minúsculas, separado por hífens) mantém a sua análise posterior organizada.
</Callout>

## Parâmetros de URL (campos ocultos)

As tags UTM cobrem os canais. Para registrar outras informações do link — qual **parceiro**, qual **ID de campanha** ou qual **página de destino** trouxe o respondente —, declare seus próprios parâmetros de URL.

Os valores costumam vir de fora: a tag de mesclagem da sua ferramenta de e-mail, como `?crm_id={{contact.id}}`, a página onde o quiz está incorporado ou um link próprio para cada parceiro. Se você só quer distinguir canais, use o [Plano de divulgação](https://docs.rooquiz.com/pt-BR/publish/promotion): ele adiciona as tags UTM para você e mostra os números de cada canal.

<Steps>
  ### Declare os parâmetros

  No quiz, abra **Compartilhar** → **Parâmetros de URL** e adicione os nomes, por exemplo `partner` e `campaign_id`. Use letras minúsculas, dígitos e sublinhados, até 10 por quiz. `utm_*` e nomes do sistema como `email`, `name`, `lang` e `ref` são reservados.

  ### Adicione ao link

  Acrescente os valores ao link do quiz: `https://YOUR_QUIZ_LINK?partner=acme&campaign_id=spring`.
</Steps>

Os valores são salvos com cada resposta e aparecem nos detalhes de [Respostas](https://docs.rooquiz.com/pt-BR/results/records), nas exportações (uma coluna por parâmetro) e nos envios de Webhook e Zapier em `metadata.params`. Só os parâmetros declarados são guardados; o resto do link é ignorado. Os valores são cortados em 256 caracteres. Disponível em todos os planos.

<Callout type="info">
  Links compartilhados a partir da página de resultados não levam esses parâmetros, então a resposta de um amigo não é atribuída ao parceiro ou à campanha original.
</Callout>

## Preencha o formulário de leads pelo link

Adicione `?email=` (e, se quiser, `?name=`) a um link do quiz — por exemplo, em uma newsletter — e o formulário de leads antes do relatório já aparece preenchido. Isso só poupa digitação: o respondente continua verificando o e-mail normalmente. Os valores saem da barra de endereço assim que a página carrega, antes que o Google Analytics ou qualquer pixel de anúncios possa vê-los.

<Callout type="warning">
  O endereço de e-mail vai dentro do próprio link, então pode acabar em logs do servidor, no histórico do navegador e em qualquer lugar para onde o link for encaminhado. Use esses links só em canais um a um, como um e-mail para a própria pessoa — nunca em uma página pública ou em um anúncio.
</Callout>
