# Google Analytics 4

Conecte sua loja ao **Google Analytics 4 (GA4)** para acompanhar acessos, analisar o comportamento dos visitantes e obter informações sobre o desempenho da sua loja na Nortgraf.

## Para que serve a integração?

O Google Analytics 4 é uma ferramenta de análise que permite compreender como os visitantes interagem com seu site.

Com a integração, você pode acompanhar informações como origem dos acessos, páginas visitadas, dispositivos utilizados e eventos registrados durante a navegação.

Esses dados ajudam a identificar quais páginas recebem mais visitantes, avaliar campanhas de marketing e acompanhar o desempenho comercial da loja.

A Nortgraf permite configurar o ID de medição do GA4, uma chave para envio de eventos pelo servidor e um script adicional, quando necessário.

## 1 - Atenção e Regras

Antes de configurar a integração, observe algumas informações importantes:

- **Conta Google:** É necessário possuir uma conta Google para acessar o Google Analytics.
- **Propriedade GA4:** Sua loja precisa estar vinculada a uma propriedade do Google Analytics 4.
- **ID de medição:** É o identificador utilizado para enviar dados da loja à propriedade correta.
- **API Secret:** É uma credencial utilizada no envio de eventos pelo servidor por meio do Measurement Protocol.
- **Script adicional:** Campo opcional destinado a configurações específicas de acompanhamento.
- **Ativação:** A opção Enviar eventos para o GA4 deve estar habilitada para ativar a tag nas páginas da loja.
- **Privacidade:** O uso de ferramentas de análise deve respeitar as regras aplicáveis de privacidade e tratamento de dados.
- **Processamento:** Os eventos enviados podem levar algum tempo para aparecer nos relatórios do Google Analytics.

**Importante:** Para a configuração básica, normalmente é suficiente informar o ID de medição e ativar a integração. O API Secret e o script adicional são destinados a necessidades específicas.

## 2 - Criando sua Conta no Google Analytics

Caso ainda não utilize o Google Analytics, será necessário criar uma conta e uma propriedade para sua loja.

### Passo 1 - Acessar o Google Analytics

1. Acesse [analytics.google.com](http://analytics.google.com).
2. Entre com sua conta Google.
3. Se for seu primeiro acesso, inicie a configuração de uma nova conta.
4. Informe um nome para identificar sua empresa ou loja.
5. Configure as preferências solicitadas.
6. Avance para a criação da propriedade.

### Passo 2 - Criar uma propriedade GA4

Na etapa de criação da propriedade:

1. Informe o nome da propriedade, como o nome da sua loja.
2. Selecione o fuso horário adequado.
3. Escolha a moeda utilizada pela empresa.
4. Informe as informações comerciais solicitadas.
5. Conclua a criação da propriedade.

**Dica:** Utilize um nome que permita identificar facilmente sua loja, principalmente se você administra mais de um site no Google Analytics.

## 3 - Criando um Fluxo de Dados

Após criar a propriedade, será necessário configurar um fluxo de dados para seu site.

### Passo 1 - Adicionar o site

1. No Google Analytics, acesse **Administrador**.
2. Localize **Fluxos de dados**.
3. Clique para adicionar um novo fluxo.
4. Selecione **Web**.
5. Informe o endereço público da sua loja.
6. Digite um nome para identificar o fluxo.
7. Conclua a configuração.

O endereço informado deve corresponder ao domínio utilizado pelos visitantes para acessar sua loja.

### Passo 2 - Obter o ID de medição

Depois de criar o fluxo:

1. Abra o fluxo de dados correspondente.
2. Localize o campo **ID de medição**.
3. Copie o identificador apresentado.

O ID de medição do GA4 normalmente possui o formato:

**G-XXXXXXXXXX**

Esse identificador será utilizado nas configurações da Nortgraf.

**Importante:** Não confunda o ID de medição com o ID numérico da propriedade. Para essa integração, utilize o identificador iniciado por G-.

## 4 - Configurando o Google Analytics na Nortgraf

Com o ID de medição em mãos, acesse o painel administrativo da sua loja.

### Passo 1 - Acessar a integração

1. Entre no painel administrativo da Nortgraf.
2. Acesse **Configurações &gt; Integrações**.
3. Localize **Google Analytics 4**.
4. Abra a página de configuração.

A tela apresenta as seções **Medição** e **Ativação**.

### Passo 2 - Informar o ID de medição

Na seção **Medição**:

1. Localize o campo **ID de medição**.
2. Cole o identificador copiado do Google Analytics.
3. Confira se o código corresponde ao fluxo de dados da sua loja.

Exemplo:

**G-XXXXXXXXXX**

Esse código identifica a propriedade que receberá os eventos de acompanhamento.

### Passo 3 - Ativar a integração

Na seção **Ativação**:

1. Localize **Enviar eventos para o GA4**.
2. Habilite a opção.
3. Clique em **Salvar**.

Com a integração habilitada, a Nortgraf poderá inserir a tag de acompanhamento nas páginas da loja.

**Importante:** A ativação não garante, por si só, que todos os eventos desejados estejam configurados ou que os relatórios sejam preenchidos imediatamente. O recebimento deve ser confirmado no Google Analytics.

## 5 - Configurando o API Secret

O campo **API Secret** é utilizado para funcionalidades que enviam eventos diretamente do servidor ao Google Analytics por meio do Measurement Protocol.

Essa configuração é opcional para o acompanhamento básico realizado pela tag.

### Passo 1 - Criar o segredo no Google Analytics

1. Acesse sua propriedade no Google Analytics.
2. Abra **Administrador**.
3. Localize **Fluxos de dados**.
4. Selecione o fluxo Web da sua loja.
5. Acesse a opção de criação de segredos da API do Measurement Protocol.
6. Crie um novo segredo.
7. Copie o valor disponibilizado pelo Google.

### Passo 2 - Informar o segredo na Nortgraf

1. Retorne à integração Google Analytics 4 na Nortgraf.
2. Localize o campo **API Secret**.
3. Informe o segredo gerado.
4. Salve as configurações.

### Para que serve?

O Measurement Protocol permite que aplicações enviem determinados eventos diretamente ao Google Analytics, sem depender exclusivamente de scripts executados no navegador.

A Nortgraf possui suporte para utilizar essa credencial em processos de envio de conversões pelo servidor.

**Atenção:** O API Secret é uma informação privada. Não o compartilhe publicamente nem o insira em scripts expostos aos visitantes.

## 6 - Utilizando um Script Adicional

A seção **Medição** também disponibiliza o campo **Script adicional**.

Esse campo é opcional e deve ser utilizado somente quando existe uma necessidade específica de acompanhamento.

### Quando utilizar?

O script adicional pode ser utilizado quando sua configuração exige um snippet próprio além da tag padrão disponibilizada pela integração.

### Como configurar?

1. Acesse a integração **Google Analytics 4**.
2. Localize o campo **Script adicional**.
3. Insira o código necessário.
4. Confira se o conteúdo está correto.
5. Salve as alterações.

**Importante:** Não adicione novamente a tag padrão do Google Analytics sem necessidade. Instalar a mesma medição mais de uma vez pode provocar registros duplicados e prejudicar a análise dos dados.

Se você utiliza o Google Tag Manager para administrar suas tags, verifique também as configurações realizadas nele.

## 7 - Testando a Integração

Depois de salvar as configurações, recomendamos verificar se o Google Analytics está recebendo os eventos da loja.

### Passo 1 - Abrir sua loja

1. Acesse o endereço público da sua loja.
2. Navegue pelas páginas disponíveis.
3. Abra alguns produtos.
4. Realize interações normais de navegação.

### Passo 2 - Verificar no Google Analytics

1. Retorne ao painel do Google Analytics.
2. Abra a propriedade correspondente.
3. Consulte o relatório **Em tempo real**.
4. Verifique se existe atividade sendo registrada.

Quando necessário, utilize as ferramentas de depuração disponibilizadas pelo Google para investigar o recebimento de eventos específicos.

### Resultado esperado

Se a configuração estiver correta e o acompanhamento não estiver bloqueado pelo navegador ou por regras de consentimento, o Google Analytics deverá começar a registrar atividades compatíveis com a implementação.

**Dica:** Para realizar o teste, utilize uma janela de navegação sem bloqueadores de rastreamento e confira se está acessando o domínio correto da loja.

## 8 - Entendendo os Dados do Google Analytics

Após configurar a integração, você poderá utilizar os relatórios do Google Analytics para analisar o comportamento dos visitantes.

### Origem dos acessos

Permite identificar de onde vêm os visitantes, como mecanismos de pesquisa, campanhas, redes sociais e acessos diretos, conforme os dados coletados.

### Páginas visitadas

Ajuda a identificar quais páginas e produtos recebem mais acessos.

### Dispositivos

Permite consultar informações sobre os dispositivos utilizados pelos visitantes, como computadores e celulares.

### Eventos

Os eventos representam interações registradas durante a navegação ou enviadas pelos mecanismos de medição configurados.

### Conversões e eventos principais

Você pode utilizar os recursos do GA4 para acompanhar eventos importantes para seu negócio, conforme a configuração e os eventos efetivamente recebidos.

**Importante:** A disponibilidade dos relatórios e eventos depende das configurações da propriedade e dos dados coletados. A integração não significa que todos os eventos de comércio eletrônico estejam automaticamente disponíveis.

## 9 - Integração com o Google Tag Manager

O Google Tag Manager é uma ferramenta separada que permite administrar tags e scripts de acompanhamento.

Você pode utilizá-lo para organizar diferentes recursos de marketing, incluindo o Google Analytics.

Entretanto, é importante evitar configurações duplicadas.

### Exemplo

Se o Google Analytics estiver configurado diretamente na Nortgraf e também for instalado pelo Google Tag Manager, verifique se os dois métodos não estão enviando o mesmo evento mais de uma vez.

Para administrar suas tags pelo Google Tag Manager, consulte o artigo **Google Tag Manager**.

## 10 - Desativando a Integração

Se desejar interromper o acompanhamento realizado pela integração:

1. Acesse **Configurações &gt; Integrações**.
2. Abra **Google Analytics 4**.
3. Localize a seção **Ativação**.
4. Desabilite **Enviar eventos para o GA4**.
5. Clique em **Salvar**.

A desativação interrompe a injeção da tag padrão controlada por essa opção.

**Atenção:** Se você utiliza scripts adicionais, Google Tag Manager ou outros mecanismos de envio de eventos, confira essas configurações separadamente.

Desativar a integração na Nortgraf não exclui sua propriedade nem os dados já registrados no Google Analytics.

## 11 - Seções de Referência

**Medição**

Reúne os campos necessários à configuração do acompanhamento.

**ID de medição**

Identificador do fluxo Web da propriedade GA4, normalmente iniciado por G-.

**API Secret**

Credencial utilizada para eventos enviados pelo servidor através do Measurement Protocol.

**Script adicional**

Campo opcional para inclusão de um snippet próprio de acompanhamento.

**Ativação**

Reúne as opções relacionadas ao funcionamento da integração.

**Enviar eventos para o GA4**

Controla a ativação da tag padrão do Google Analytics nas páginas da loja.

## 12 - Problemas Comuns

**Não encontro o ID de medição.**

Acesse o Google Analytics, abra Administrador, selecione Fluxos de dados e consulte o fluxo Web correspondente à sua loja.

**O Google Analytics não registra acessos.**

Confira o ID de medição, verifique se a integração está habilitada e confirme que você está acessando o domínio correto.

Também verifique se o navegador utiliza bloqueadores de rastreamento ou se existem condições de consentimento que impeçam a coleta.

**Os dados não aparecem imediatamente nos relatórios.**

Alguns relatórios podem apresentar atraso no processamento. Utilize o relatório Em tempo real para verificar a atividade inicial.

**Preciso configurar o API Secret?**

Não obrigatoriamente. Para o acompanhamento básico por tag, o ID de medição normalmente é suficiente. O API Secret é destinado a funcionalidades de envio de eventos pelo servidor.

**Os acessos estão sendo contados mais de uma vez.**

Confira se o Google Analytics não está instalado simultaneamente por múltiplos métodos, como integração direta, Google Tag Manager e scripts adicionais.

**Configurei o Google Tag Manager. Preciso ativar também o Google Analytics na Nortgraf?**

Depende da sua configuração. Se o Google Tag Manager já administra a tag do GA4, evite instalar uma segunda tag idêntica sem necessidade.

**O campo Script adicional é obrigatório?**

Não. Utilize esse campo somente quando precisar inserir um snippet próprio.

**Desativei o Google Analytics, mas ainda encontro eventos.**

Verifique se existem outras ferramentas ou scripts enviando dados, como Google Tag Manager, scripts adicionais ou integrações pelo servidor.

**Minha conta Google possui várias propriedades. Qual devo utilizar?**

Utilize o ID de medição do fluxo Web correspondente à loja que deseja acompanhar.

**Alterei o domínio da loja. Preciso configurar novamente?**

Confira o endereço utilizado no fluxo de dados do Google Analytics e verifique se a propriedade continua recebendo os eventos corretamente.

---

**Dica:** Após configurar o Google Analytics, realize uma navegação de teste na loja e acompanhe o relatório Em tempo real. Isso ajuda a confirmar o recebimento dos primeiros eventos antes de utilizar os dados para avaliar campanhas e decisões comerciais.