Como usar Tags na CodeQR

Tags são uma excelente maneira de organizar seus links na CodeQR. Você pode usar tags para agrupar links e facilitar a localização deles posteriormente.

O que é uma Tag?

Uma tag é um rótulo que você pode atribuir a um link. As tags são codificadas por cores e podem ser criadas e atribuídas a um link em apenas alguns cliques.

Com tags, você pode:

Organizar seus links por campanhas, clientes ou qualquer outras categorias que você possa imaginar.
Filtrar seus links por tags e obter um link compartilhável para os resultados filtrados.
Filtrar suas análises por tags para ver como suas campanhas estão performando.
Automatizar fluxos de trabalho baseados em categorização
Gerar relatórios específicos por categoria ou projeto

Como criar uma Tag

Para criar uma tag, navegue até a página de configurações de Tags no seu projeto da CodeQR.

Tags settings page

Clique em Criar Tag para abrir o modal de criação de tag, onde você pode criar uma nova tag e escolher uma cor para ela:

Você também pode criar novas tags diretamente dentro do construtor de links da CodeQR. Uma vez que você criou um link, clique no campo de entrada de tag e digite o nome da tag que você quer criar.

Se a tag já existe, você pode selecioná-la do dropdown. Caso contrário, pressione Enter ↩ para criar uma nova tag.

Uma vez que a tag é criada, clique no botão "Criar Link" para atribuir a tag ao link.

Estratégias de nomeação de tags

1. Por tipo de campanha

email-marketing: Para links em campanhas de email
redes-sociais: Links compartilhados em redes sociais
ads-pagos: Links de campanhas pagas (Google Ads, Facebook Ads)
seo-organico: Links para conteúdo orgânico
influenciadores: Parcerias com influenciadores

2. Por cliente ou projeto

cliente-empresa-a: Links específicos do cliente A
projeto-lancamento: Links do projeto de lançamento
campanha-black-friday: Links da campanha sazonal
webinar-maio: Links do webinar específico
produto-x: Links relacionados ao produto X

3. Por estágio do funil

awareness: Links para conscientização
consideration: Links para consideração
conversion: Links para conversão
retention: Links para retenção
advocacy: Links para advocacia

4. Por performance

alta-conversao: Links com alta taxa de conversão
teste-ab: Links em teste A/B
experimental: Links experimentais
otimizado: Links otimizados
em-analise: Links sendo analisados

Como editar ou excluir uma Tag

Tags podem ser editadas através da página de configurações de Tags no seu workspace da CodeQR.

Simplesmente clique no botão ⋮ para abrir o menu popover da tag, que oferece as seguintes opções:

Edit a tag by clicking on the ⋮ icon

Editar a tag: Alterar nome e cor
Copiar o ID único da tag: Para uso programático via API
Excluir a tag: Remover permanentemente
Ver analytics: Análises específicas da tag
Exportar dados: Dados dos links com essa tag

Você também pode usar os seguintes atalhos de teclado para gerenciar suas tags:

Atalho de TecladoAçãoEEditar uma tagICopiar o ID único da tagXExcluir uma tagAVer analytics da tagDDuplicar tag

Para abrir o modal de edição de tag, clique no botão "Editar". Dentro do modal de edição de tag, você pode:

Renomear a tag: Alterar o nome da tag
Mudar a cor da tag: Escolher nova cor
Definir descrição: Adicionar descrição para a tag
Configurar automações: Regras automáticas para a tag

Posso atribuir múltiplas tags a um link?

Sim, você pode. Na seção de tags de um determinado link, você pode selecionar múltiplas tags para atribuir ao link.

As tags aparecerão nos detalhes do link, e você pode filtrar seus links por essas tags.

Melhores práticas para múltiplas tags:

1. Hierarquia lógica

Tags primárias: cliente-a, campanha-verao
Tags secundárias: email-marketing, promocional
Tags de contexto: urgente, teste-ab

2. Combinações estratégicas

Campanha + Canal: black-friday + instagram
Cliente + Tipo: empresa-x + newsletter
Produto + Estágio: produto-a + lancamento
Região + Idioma: brasil + portugues

3. Sistema de cores coordenado

Vermelhas: Campanhas urgentes ou de alta prioridade
Azuis: Clientes ou projetos principais
Verdes: Campanhas bem-sucedidas ou otimizadas
Amarelas: Testes ou campanhas experimentais
Roxas: Conteúdo educacional ou webinars

Quantas tags posso criar?

O número de tags que você pode criar depende do seu plano:

Plano Gratuito: Até 5 tags
Plano Pro: Até 25 tags
Plano Business: Tags ilimitadas
Plano Enterprise: Tags ilimitadas

Confira nossa página de preços para mais informações sobre nossos planos.

Dicas para otimizar o uso de tags:

Para planos com limite:

Use tags genéricas: marketing, vendas, suporte
Combine com prefixos: mkt-email, mkt-social, mkt-ads
Foque no essencial: Apenas categorias que você realmente filtra
Revise periodicamente: Remova tags não utilizadas

Para planos ilimitados:

Seja específico: campanha-black-friday-2024-instagram
Use subcategorias: cliente-a-newsletter-semanal
Inclua contexto temporal: q1-2024, dezembro-2024
Adicione metadados: alta-prioridade, revisar-semanalmente

Filtragem e busca por tags

1. Filtros simples

Por tag única: Mostrar apenas links com tag específica
Por múltiplas tags: Links que contenham todas as tags selecionadas
Exclusão de tags: Links que não contenham determinadas tags
Combinação AND/OR: Lógica booleana para filtros complexos

2. Filtros avançados

{
  "filters": {
    "tags": {
      "include": ["campanha-verao", "instagram"],
      "exclude": ["pausado", "arquivado"],
      "operator": "AND"
    },
    "date_range": {
      "start": "2024-06-01",
      "end": "2024-08-31"
    }
  }
}

3. Busca inteligente

Busca por nome da tag: Digite parte do nome
Busca por cor: Filtre por cores específicas
Busca por descrição: Encontre por palavras na descrição
Busca por ID: Para integração via API

Analytics por tags

Métricas disponíveis:

Total de cliques por tag
Taxa de conversão por categoria
Performance temporal das tags
Comparação entre tags
ROI por campanha/tag

Relatórios personalizados:

{
  "report": {
    "tags": ["email-marketing", "redes-sociais"],
    "metrics": ["clicks", "conversions", "ctr", "revenue"],
    "period": "last_30_days",
    "group_by": "day"
  }
}

Gerenciando tags programaticamente

Você também pode gerenciar tags programaticamente usando a API da CodeQR.

Operações disponíveis via API:

1. Criar uma nova tag

POST /api/tags
{
  "name": "campanha-natal-2024",
  "color": "#FF0000",
  "description": "Campanha de Natal 2024 - Links promocionais"
}

2. Listar todas as tags

GET /api/tags
Response:
{
  "tags": [
    {
      "id": "tag_123",
      "name": "email-marketing",
      "color": "#3B82F6",
      "links_count": 45,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ]
}

3. Atualizar uma tag

PUT /api/tags/tag_123
{
  "name": "email-marketing-2024",
  "color": "#10B981",
  "description": "Campanhas de email marketing para 2024"
}

4. Excluir uma tag

DELETE /api/tags/tag_123

5. Atribuir tags a um link

POST /api/links
{
  "url": "https://exemplo.com",
  "tags": ["email-marketing", "promocional", "urgente"]
}

Webhooks para tags

Configure webhooks para receber notificações quando:

{
  "events": ["tag.created", "tag.updated", "tag.deleted", "link.tagged", "link.untagged"],
  "webhook_url": "https://seu-sistema.com/webhooks/codeqr"
}

Automações baseadas em tags

1. Regras automáticas

Auto-tag por URL: Tags automáticas baseadas no domínio
Auto-tag por campanha: Detectar UTM parameters
Auto-tag temporal: Tags baseadas em data/hora
Auto-tag por performance: Tags baseadas em métricas

2. Integrações

Google Analytics: Enviar tags como custom dimensions
CRM: Sincronizar tags com campos personalizados
Email marketing: Segmentar listas baseado em tags
Slack/Teams: Notificações por categoria de tag

3. Fluxos de trabalho

{
  "automation": {
    "trigger": "link.created",
    "condition": "url.contains('utm_campaign=black-friday')",
    "action": "add_tags(['black-friday', 'promocional', 'sazonal'])"
  }
}

Casos de uso avançados

1. Gestão de campanhas multi-canal

{
  "campanha_lancamento": {
    "tags_principais": ["lancamento-produto-x"],
    "tags_canal": ["email", "social", "ads", "influencer"],
    "tags_fase": ["teaser", "pre-launch", "launch", "post-launch"],
    "tags_publico": ["clientes", "prospects", "parceiros"]
  }
}

2. Organização por cliente

{
  "cliente_enterprise": {
    "estrutura": "cliente-[nome]-[projeto]-[tipo]",
    "exemplo": "cliente-microsoft-teams-integration-api",
    "cores": {
      "cliente": "#FF6B6B",
      "projeto": "#4ECDC4",
      "tipo": "#45B7D1"
    }
  }
}

3. Controle de qualidade

{
  "qa_tags": {
    "status": ["aprovado", "em-revisao", "rejeitado"],
    "prioridade": ["critico", "alto", "medio", "baixo"],
    "responsavel": ["equipe-a", "equipe-b", "terceirizado"]
  }
}

Melhores práticas para tags

1. Convenções de nomenclatura

Use hífens: email-marketing em vez de email_marketing
Seja consistente: Sempre minúsculas
Evite espaços: black-friday em vez de black friday
Use prefixos: tipo-, cliente-, campanha-

2. Organização hierárquica

Nível 1: Tipo (campanha-, cliente-, produto-)
Nível 2: Categoria (campanha-email-, cliente-enterprise-)
Nível 3: Específico (campanha-email-newsletter-semanal)

3. Manutenção regular

Auditoria mensal: Revisar tags não utilizadas
Consolidação: Unir tags similares
Atualização: Manter nomes atualizados
Documentação: Manter guia de uso interno

4. Governança de dados

Permissões: Quem pode criar/editar tags
Aprovação: Processo para novas tags
Padrões: Guidelines para nomenclatura
Treinamento: Educar equipe sobre uso correto

Solução de problemas

1. Tags não aparecem nos filtros

Problema: Tags criadas não aparecem na lista de filtros Soluções:

Verificar se tag foi salva corretamente
Atualizar página do navegador
Verificar permissões do usuário
Contatar suporte se persistir

2. Performance lenta com muitas tags

Problema: Interface lenta com muitas tags Soluções:

Implementar paginação de tags
Usar busca em vez de scroll
Arquivar tags não utilizadas
Otimizar queries de banco

3. Inconsistência de cores

Problema: Cores das tags não padronizadas Soluções:

Definir paleta de cores padrão
Criar guia de estilo para tags
Usar ferramenta de validação
Treinar equipe sobre padrões

Integração com ferramentas externas

1. Google Sheets

Exporte dados de links com tags para análise:

function exportTaggedLinks() {
  // Conectar com API da CodeQR
  // Filtrar por tags específicas
  // Exportar para planilha
}

2. Zapier/Make

Automatize fluxos baseados em tags:

Trigger: Link criado com tag específica
Action: Adicionar ao CRM, enviar notificação, etc.

3. Business Intelligence

Conecte tags com ferramentas de BI:

Power BI: Dashboards por categoria de tag
Tableau: Visualizações de performance por tag
Looker: Relatórios automatizados