Cole seu ID de Medição GA4 em Configurações → Google Analytics. O widget encaminha cada interação para sua propriedade existente, com o ID do agente anexado para filtragem.
A maioria das equipes já usa o Google Analytics. Agora seu widget de IA pode se integrar diretamente a ele. A integração do Google Analytics permite que você veja o engajamento do widget ao lado de todos os seus outros dados do site - nos mesmos painéis, segmentos e relatórios em que você já confia.
G-XXXXXXXXXX - encontre-o em GA4 → Admin → Fluxos de Dados → seu fluxo)É isso. O widget detecta o novo ID em seu próximo carregamento e começa a encaminhar eventos. Nenhuma alteração de código em seu site. Nenhum novo script de rastreamento para gerenciar. Apenas administradores e proprietários podem alterar o ID.
Quando o script de incorporação é iniciado, o widget informa qual propriedade GA4 enviar via um WIDGET_GA_INIT postMessage. O script de incorporação então:
window.gtag se já estiver na página - sem inicialização dupla, sem chamadas de config conflitantesgtag.js de googletagmanager.com e o inicializa com seu ID de Mediçãosend_to: <seu-id-de-medicao> para que os eventos sempre cheguem na propriedade correta, mesmo em sites com múltiplos fluxos GACinco interações do widget se tornam eventos GA4:
| Evento | Nome GA4 | Parâmetros extras |
|---|---|---|
| Widget aberto | widget_open | agent_id |
| Widget fechado | widget_close | agent_id |
| Mensagem enviada | widget_message_sent | agent_id, message_length |
| Resposta de IA recebida | widget_response_received | agent_id |
| Erro ocorrido | widget_error | agent_id, error_type |
Cada evento carrega agent_id para que você possa filtrar por agentes específicos no GA4 - útil se você executar vários agentes em uma organização. message_length (um número de caracteres) permite que você distinga consultas curtas de detalhadas sem capturar o conteúdo da mensagem. error_type classifica erros por categoria (rede, autenticação, limite de taxa) para painéis de diagnóstico.
O conteúdo da mensagem nunca é enviado ao Google Analytics. Apenas os metadados viajam: tipo de evento, ID do agente, comprimentos numéricos e categorias de erro. O widget executa o GA dentro do contexto da sua página, então seu banner de consentimento de cookies existente e mecanismos de conformidade com o GDPR controlam se o rastreamento é ativado - exatamente como fazem para o resto do seu site.
Se seu site já carrega o GA4, o widget detecta window.gtag e o utiliza diretamente. Se não, carrega gtag.js usando seu ID de Medição. De qualquer forma, os eventos chegam na mesma propriedade GA4 com o mesmo contexto de sessão que o resto do seu site - assim, as interações do widget aparecem naturalmente em suas jornadas de usuário, funis de conversão e segmentos de audiência.
Uma vez que os eventos estão fluindo:
widget_open para ver o engajamento diário/semanal do widgetwidget_open → widget_message_sent → seu evento de conversão, para medir quantos usuários de chat convertemagent_id para comparar agentes lado a ladosend_to correspondendo ao seu ID de Medição)Os dados de engajamento do widget sempre existiram no seu painel Companin. Esta integração os torna parte do seu quadro analítico mais amplo - atribuídos às mesmas sessões, aos mesmos usuários e aos mesmos objetivos que tudo o mais que você mede. Chega de alternar entre ferramentas para entender se o widget ajuda a converter visitantes.