Integrações - Analytics e Rastreamento

Esta página é uma visão geral focada dos campos de analytics e rastreamento. O conteúdo operacional completo da tela (incluindo avaliações Google/TripAdvisor, feeds Meta Ads, casos especiais e erros de validação) vive no artigo principal Configurações - Integrações.

O que é

A página Configurações > Integrações centraliza, em um único formulário, todos os identificadores externos que devem ser injetados no site público da sua empresa. Esta visão geral cobre especificamente os sete campos de analytics e rastreamento validados pelo IntegracoesController@update:

• Google Analytics 4 (GA4)
• Google Tag Manager (GTM)
• Meta Pixel (Facebook/Instagram)
• Google Ads (ID e Rótulo de Conversão)
• TikTok Pixel
• Microsoft Clarity
• Hotjar

Cada campo aceita nullable|string|max:50. Esvaziar um campo e salvar remove a chave do JSON tenant.integracoes (o controlador roda array_filter antes de persistir), então desligar uma plataforma é apenas apagar o conteúdo e clicar em Salvar Integrações.

Como usar

1. Vá em Configurações > Integrações no sidebar (URL /admin/configuracoes/integracoes).
2. Role até o bloco da plataforma desejada - todos os campos desta visão geral ficam nas seções Analytics e Rastreamento, Marketing e Conversões e Ferramentas de Análise UX.
3. Cole o identificador no formato indicado pelo placeholder do campo:
   • GA4 - ID de Medição: G-XXXXXXXXXX. Pegue em Google Analytics → Admin → Fluxos de dados → ID de medição.
   • GTM - ID do Contêiner: GTM-XXXXXXX. Se preencher este campo, GA4, Meta Pixel e Google Ads podem ser gerenciados de dentro do GTM e ficam opcionais.
   • Meta Pixel - ID do Pixel: número de 15 dígitos. Pegue em Meta Events Manager → Fontes de dados → Pixel.
   • Google Ads - ID de Conversão: AW-123456789. Pegue em Google Ads → Ferramentas → Conversões → Detalhes da tag.
   • Google Ads - Rótulo de Conversão: opcional, aparece junto do ID no painel do Google Ads.
   • TikTok Pixel - ID do Pixel: pegue no TikTok Events Manager.
   • Microsoft Clarity - ID do Projeto: crie a conta gratuita em clarity.microsoft.com e copie o ID do projeto.
   • Hotjar - Site ID: número inteiro exibido nas configurações do site no Hotjar.
4. Clique em Salvar Integrações no rodapé fixo. O botão só fica habilitado quando há alteração detectada. Após salvar aparece o toast Integrações salvas com sucesso! e a página recarrega com os valores persistidos no campo JSON tenants.integracoes.

Casos especiais

Centralizar tudo no GTM

Se você quer um único ponto de gestão das tags, preencha apenas o ID do Contêiner (GTM-XXXXXXX) e deixe GA4, Meta Pixel e Google Ads em branco. O site público injeta apenas o snippet do GTM e o restante das tags você configura por lá. A própria página exibe esse aviso no bloco do GTM.

Coexistência com códigos do Viagilize

A própria plataforma pode incluir códigos de analytics internos para medir performance do site público. Eles convivem com os IDs que você cadastra aqui e não interferem nos dados que chegam às suas contas externas, conforme avisa o bloco informativo azul no final da tela.

Limpar uma integração existente

Apague o conteúdo do campo e clique em Salvar Integrações. Não existe botão "Remover" - o array_filter do controlador descarta automaticamente qualquer chave vazia antes de gravar.

Erros comuns e como resolver

• "The integrações.google_analytics_id may not be greater than 50 characters." - Causa: o valor colado excede o limite max:50 da regra de validação. Solução: confira se copiou apenas o ID (G-XXXXXXXXXX), sem texto extra ao redor.
• GA4 cadastrado mas sem dados no Google Analytics - Causa: o ID foi colado com espaços, com aspas ou com o prefixo errado. Solução: garanta o formato G- seguido de letras e números maiúsculos, sem caracteres extras.
• Meta Pixel não recebe eventos - Causa: o ID do Pixel foi preenchido junto com o GTM, mas o GTM já dispara o Pixel internamente, gerando duplicidade ou conflito. Solução: escolha um dos dois - ou cadastra o Pixel no campo dedicado, ou deixa o campo em branco e gerencia pelo GTM.
• TikTok Pixel salvo mas sem eventos - Causa: o ID copiado foi o da conta de anúncios, não o do Pixel. Solução: vá ao TikTok Events Manager, abra o Pixel correto e copie o identificador exibido no topo (geralmente começa por C).

Onde encontrar

• URL: /admin/configuracoes/integracoes
• Caminho no menu: Configurações > Integrações
• Permissão necessária: ver as configurações para abrir; editar as configurações para salvar
• Módulo necessário: nenhum

Veja também

• Configurações - Integrações - artigo principal com todos os blocos (avaliações Google/TripAdvisor, feeds Meta Ads, casos especiais e erros adicionais)
• Configurações - API e Webhooks
• Domínio personalizado