Usar tags para filtrar links, QR codes e páginas

Tag é um rótulo que você põe num link, num QR code ou numa página, e o mesmo item pode carregar várias. É isso que faz da tag a ferramenta de relatório: uma tag de campanha atravessa clientes, canais e meses, e a Análise consegue filtrar por ela.

Disponibilidade

• Plano: todos, com um limite de quantas tags distintas o espaço de trabalho comporta: Gratuito 2 · Starter 25 · Pro 50 · Business 150 · Scale 1000. O limite conta tags, não itens marcados.
• Onde: Configurações → Tags, e o campo Tags nos construtores de link, QR code e página.
• Cores: o seletor traz seis — Vermelho, Amarelo, Verde, Azul, Roxo e Marrom. Uma sétima, pink, só é aceita pela API.

Antes de começar

Combine o que uma tag significa antes de criar muitas. Uma lista de tags que cresceu por acidente é pior que nenhuma, porque os filtros deixam de ser confiáveis. Escolher entre pastas e tags para organizar links explica quando um agrupamento deve ser tag, e Nomear links para o time achar depois trata do vocabulário.

Passos

1. Abra Configurações → Tags.
2. Selecione Adicionar.
3. Digite o nome em Nome da Tag e escolha uma Cor da Tag.
4. Selecione Criar tag.

A tag entra na lista, e cada linha mostra quantos links e QR codes a carregam:

Depois, no construtor de link, QR code ou página, escolha a tag em Tags e salve. Um item aceita mais de uma. Também dá para criar a tag direto do construtor: comece a digitar e a opção Criar tag aparece.

Filtrar por tag

Nas listas de Links e QR Codes, filtre por tag para ver tudo que a carrega, atravessando pastas. O filtro se combina com os outros — domínio, pasta, busca —, então black-friday dentro da pasta Cliente A é um clique mais uma seleção. Há ainda os filtros Com tags e Sem tags, úteis para achar o que ficou sem marcação.

Tags na Análise

A Análise filtra por tag, e essa é a diferença prática entre tag e pasta: tag fatia relatório, pasta não. Filtre um relatório por black-friday e você tem os cliques, escaneamentos e conversões daquela campanha, independentemente de onde os links moram.

O que acontece ao excluir uma tag

Nada é apagado. A tag some e os itens que a carregavam deixam de carregá-la. Os links continuam funcionando, as estatísticas ficam intactas e as outras tags dos mesmos itens permanecem.

Renomear funciona igual: os itens acompanham o novo nome, e os relatórios passados se agrupam por ele.

Faça o mesmo pela API

curl -X POST https://api.codeqr.io/tags \
  -H "Authorization: Bearer codeqr_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"tag":"black-friday","color":"blue"}'

O campo color aceita red, yellow, green, blue, purple, pink e brown. Sem ele, uma cor é escolhida para você.

Marque no momento de criar o link, informando os nomes:

curl -X POST https://api.codeqr.io/links \
  -H "Authorization: Bearer codeqr_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","domain":"go.example.com","tagNames":["black-friday","email"]}'

Um assistente de IA conectado por MCP consegue listar e criar tags.

Verifique se funcionou

Marque um link e filtre a lista de Links por essa tag: o link aparece e o resto some. Depois abra a Análise e filtre pela mesma tag — os números devem bater com os contadores daquele link.

Solução de problemas

Não consigo criar mais uma tag

O espaço de trabalho chegou ao limite do plano — 2 no gratuito, 25 no Starter, 50 no Pro, 150 no Business. Exclua tags que você não usa para filtrar; excluir não custa nada além do rótulo.

Duas tags significam a mesma coisa

Renomeie uma para o nome da outra, re-marque os itens e exclua a duplicada. A Análise acompanha o nome atual.

O filtro por tag não devolve nada

Confira se você está na lista certa e se os itens esperados realmente carregam a tag, e não só um nome parecido. Os filtros são exatos.

Dá para marcar páginas e QR codes também

Sim. As tags valem para links, QR codes e páginas, e o filtro funciona em cada lista.

A tag marrom fica sem cor

Marrom aparece no seletor, mas não existe estilo definido para esse valor, então tanto a amostra quanto qualquer tag criada com ela aparecem sem cor. Escolha outra cor enquanto isso não é corrigido.

As tags podem ser aplicadas sozinhas

Não. Toda tag é aplicada por uma pessoa ou pelo seu próprio código, pela API. O construtor oferece sugestões de IA, mas quem confirma é você.

Artigos relacionados

• Escolher entre pastas e tags para organizar links
• Criar pastas para agrupar links e QR codes
• Nomear links para o time achar depois