Docs
Referência

Parâmetros e rastreamento

Anatomia da URL

ParteExemploDescrição
Subdomínioseudominio.comServidor/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.
Slugpromo-veraoParte 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ão falha.
  • 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âmetroObrigatórioExemplo
utm_source (Origem da Campanha)Sim, quando o rastreamento UTM está ativogoogle, facebook, newsletter
utm_medium (Meio da Campanha)Nãocpc, banner, email
utm_campaign (Nome da Campanha)Nãoblack_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_term e utm_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 chave utm_term ou utm_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"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_source nã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).

ItemOnde apareceDescrição
Cliques ao longo do tempoDetalhe do link e visão geralGráfico de área preenchida, com a série "Cliques" agrupada por dia; dias sem cliques aparecem com zero na visão geral.
Total de cliquesDetalhe do link e visão geralNúmero KPI em destaque acima do gráfico: soma dos cliques no período e nos links selecionados.
Filtro de dataDetalhe do link e visão geralSeletor de período independente em cada visão.
Filtro por linkVisão geralPopover "Filtrar por link" (gatilho "Links (Todos)" / "Links (N)") que filtra tanto a série do gráfico quanto a tabela "Links criados" abaixo.
QR CodeDetalhe do linkCó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.

AspectoComportamento
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çãoClique nos cabeçalhos "SmartLink", "URL encurtado", "Data da criação" ou "Cliques".
Paginação20 linhas por página.
CelularExibida 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:

ControleTelaAção bloqueada
Botão de exclusãoTabela "Links criados"Excluir smart links
"Gerar Link Encurtado"Formulário de criaçãoCriar smart links
"Salvar alterações"Editor de detalhesEditar 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çãoIntervalo
Últimos 7 dias7 dias
Últimos 15 dias15 dias
Últimos 30 dias30 dias
Últimos 90 dias90 dias
Até o momentoDo 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