Parâmetros e rastreamento
Anatomia da URL
| Parte | Exemplo | Descrição |
|---|---|---|
| Subdomínio | seudominio.com | Servidor/subdomínio vinculado à conta; é a base da URL curta. O seletor oferece os subdomínios da sua conta ("Seus Servidores") e os subdomínios globais da plataforma ("Servidores Globais"), entre eles tgsr.cc. |
| Prefixo | /l/ | Segmento fixo entre o subdomínio e o slug. Identifica os links curtos e não é configurável. |
| Slug | promo-verao | Parte final e única da URL curta, após /l/. Deixe o campo em branco para gerar um slug aleatório de 6 caracteres alfanuméricos (formato abc123). |
A URL curta é montada como https://{subdominio}/l/{slug} (exemplo: seudominio.com/l/promo-verao).
- Caracteres do slug: apenas letras, números, hífen e sublinhado (
^[a-zA-Z0-9_-]+$). Acentos, espaços, pontos e barras são rejeitados:promo-veraoé válido,promo-verãofalha. - Unicidade do slug: única dentro do mesmo subdomínio. No subdomínio global (
tgsr.cc) a unicidade vale em toda a plataforma, então um slug global colide com slugs de outras contas.
Parâmetros UTM
| Parâmetro | Obrigatório | Exemplo |
|---|---|---|
utm_source (Origem da Campanha) | Sim, quando o rastreamento UTM está ativo | google, facebook, newsletter |
utm_medium (Meio da Campanha) | Não | cpc, banner, email |
utm_campaign (Nome da Campanha) | Não | black_friday, promocao_verao |
Nota
Os UTMs e os parâmetros customizados só se aplicam com o interruptor "Rastreamento e atribuição" ligado. Com ele desligado, a interface de UTM/customizados nem é exibida e nada é anexado: o link é salvo com a URL de destino crua, e qualquer parâmetro digitado desaparece.
- Destino dos parâmetros: são anexados à URL de destino (não à URL curta); a URL curta redireciona para o destino carregando-os.
utm_termeutm_content: reconhecidos pelo construtor de URL, mas nenhuma tela exibe um campo para eles. Para defini-los pelo painel, adicione um parâmetro customizado com a chaveutm_termouutm_content.
Drawer "Criar Smart Link" com o interruptor "Rastreamento e atribuição" ligado, exibindo os campos Origem da Campanha (utm_source), Meio da Campanha (utm_medium) e Nome da Campanha (utm_campaign), cada um com exemplos, e o botão "Adicionar parâmetro"
Parâmetros customizados
- Onde: apenas dentro do bloco "Rastreamento e atribuição", adicionados como pares chave/valor por "Adicionar parâmetro".
- Formato no formulário de criação: uma linha por parâmetro, com o campo "Chave", o separador "/", o campo "Valor" e um botão de lixeira que remove a linha.
- Limite: não há limite fixo para o número de parâmetros customizados.
- Ativação: toda linha adicionada já entra ativa; o único interruptor do formulário é "Rastreamento e atribuição".
- Par vazio na criação: uma linha com chave ou valor vazio bloqueia o envio, com o erro "Parâmetros customizados habilitados devem ter chave e valor preenchidos". Para descartar um parâmetro, remova a linha pela lixeira.
- Anexação: os parâmetros customizados são anexados à URL de destino junto com os UTMs.
- Editor de detalhes ("Informações de UTM"): não tem o interruptor "Rastreamento e atribuição"; os pares se chamam "Parâmetro personalizado" / "Valor",
utm_sourcenão é obrigatório, os campos vêm preenchidos a partir da query string da URL de destino atual e, em "Salvar alterações", um par com chave ou valor vazio é descartado sem erro.
URL de destino
- A URL de destino é validada antes do envio; uma URL inválida é bloqueada.
- Se a URL de destino não incluir o protocolo,
https://é adicionado automaticamente.
Estatísticas rastreadas
A única métrica rastreada é o clique, registrado por link (sem visitantes únicos, geografia ou dispositivo).
| Item | Onde aparece | Descrição |
|---|---|---|
| Cliques ao longo do tempo | Detalhe do link e visão geral | Gráfico de área preenchida, com a série "Cliques" agrupada por dia; dias sem cliques aparecem com zero na visão geral. |
| Total de cliques | Detalhe do link e visão geral | Número KPI em destaque acima do gráfico: soma dos cliques no período e nos links selecionados. |
| Filtro de data | Detalhe do link e visão geral | Seletor de período independente em cada visão. |
| Filtro por link | Visão geral | Popover "Filtrar por link" (gatilho "Links (Todos)" / "Links (N)") que filtra tanto a série do gráfico quanto a tabela "Links criados" abaixo. |
| QR Code | Detalhe do link | Código QR gerado automaticamente, com download em PNG pelo botão "Baixar QR Code" (arquivo qrcode-{slug}.png). Codifica a URL curta completa, carregando o mesmo rastreamento. |
As visões de Smart Link solicitam os dados ao endpoint /links/stats com granularidade por dia.
Tabela "Links criados"
| Aspecto | Comportamento |
|---|---|
| Colunas | "SmartLink" (slug), "URL encurtado", "Data da criação", "Cliques" e uma ação de exclusão sem rótulo. |
| "Cliques" | Total por link, como número simples no formato pt-BR (por exemplo, 1 ou 1.234). |
| Ordenação | Clique nos cabeçalhos "SmartLink", "URL encurtado", "Data da criação" ou "Cliques". |
| Paginação | 20 linhas por página. |
| Celular | Exibida em formato de cartões. |
| "URL encurtado" | A URL curta abre em nova aba. Ao passar o mouse na linha, aparece um botão que copia a URL curta; o ícone vira um check após copiar. |
Perfil Somente Leitura
Para um membro com o perfil "Somente Leitura", os controles de escrita continuam visíveis, mas desativados, com um tooltip pedindo que ele solicite a ação ao proprietário da conta:
| Controle | Tela | Ação bloqueada |
|---|---|---|
| Botão de exclusão | Tabela "Links criados" | Excluir smart links |
| "Gerar Link Encurtado" | Formulário de criação | Criar smart links |
| "Salvar alterações" | Editor de detalhes | Editar smart links |
Estatísticas, filtros e QR Code funcionam normalmente nesse perfil.
Filtros de data
A visão geral usa, por padrão, o intervalo "Últimos 30 dias".
| Predefinição | Intervalo |
|---|---|
| Últimos 7 dias | 7 dias |
| Últimos 15 dias | 15 dias |
| Últimos 30 dias | 30 dias |
| Últimos 90 dias | 90 dias |
| Até o momento | Do início do ano corrente até hoje |
Também é possível escolher um intervalo personalizado em dois campos de data no formato DD/MM/YYYY e confirmar em "Aplicar".
Veja também
- Criando e gerenciando Smart Links: como aplicar esses parâmetros na prática.
- Analisando o desempenho: interpretar cliques e gráficos rastreados.
- Smart Links: Introdução: conceito e casos de uso.
