> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 📊 Configurar o Google Analytics 4 Rastreamento para reservas de nomeação > ℹ️ **Note:** Este artigo foi traduzido automaticamente utilizando IA e pode conter imprecisões. Se algo parecer errado, entre em contato com nossa equipe de suporte. Quer ver quais compromissos estão dirigindo a mais receita, de onde suas reservas vêm, e como os clientes se movem através de seu fluxo de reserva? O Google Analytics 4 pode ajudar com isso. Hoppy Appointments pode enviar automaticamente eventos de reserva para sua propriedade GA4 — incluindo conversões, cancelamentos, remarcações e inscrições na lista de espera. Uma vez conectado, você será capaz de analisar o comportamento de reserva ao lado do resto do tráfego de sua loja. Este guia leva-o através da ligação GA4 passo a passo. --- # **⚠️ Antes de começar** Antes de configurar o rastreamento GA4, certifique-se de ter: * A **Hoppy Appointments** app instalado no seu Shopify guardar * Pelo menos um serviço ativo * A **Propriedade do Google Analytics 4** já criado * Acesso ao seu GA4 **ID da medição** e **Segredo da API** 💡 Se você ainda não criou uma propriedade GA4, você pode fazer isso em sua conta do Google Analytics primeiro. Você só precisa da propriedade — nenhuma instalação de tag do site é necessária dentro Shopify em vez Hoppy Appointments eventos. --- # **🛠️ Passo 1 — Abrir configurações de análise e rastreamento** Na sua Shopify administrador: 1. Abrir o **Hoppy Appointments** app 2. Clique **Configuração** no menu da aplicação 3. Clique **Análise & Rastreamento** Você verá cartões para os provedores de rastreamento disponíveis. Este guia centra-se na **Google Analytics 4** Cartão. --- # **🛠️ Passo 2 — Encontre seu ID de medição GA4 e API Secret** Você precisa de dois valores do Google Analytics. ## **ID da medição** 1. No Google Analytics, abra sua propriedade 2. Ir para **Administrador** → **Fluxos de Dados** 3. Clique em seu **Web** fluxo de dados 4. Copiar a **ID da medição** (parece que `G-XXXXXXXXXX`) --- ## **Segredo da API** 1. No mesmo fluxo de dados da Web, clique **Segredos da API do protocolo de medição** 2. Clique **Criar** 3. Digite um apelido como “Hoppy Appointments“ 4. Copiar o gerado **Segredo da API** ⚠️ Importante: O segredo API é usado no lado servidor e nunca é mostrado aos clientes ou armazenado no navegador. Mantenha-o privado, como qualquer chave API. --- # **🛠️ Etapa 3 — Introduzir as credenciais GA4 Hoppy Appointments** De volta para o Hoppy Appointments **Análise & Rastreamento** página: 1. Encontrar o **Google Analytics 4** cartão 2. Colar o seu **ID da medição** no campo ID da medição 3. Colar o seu **Segredo da API** no campo API Secret Esse é o mínimo necessário para começar a rastrear eventos de reserva. ℹ️ Não existe nenhum botão separado "Ativar GA4". Uma vez que o ID de medição e o segredo API são inseridos, o rastreamento GA4 torna-se ativo. --- # **🛠️ Passo 4 — Configurações Opcionais** Dependendo da sua configuração, você também pode querer configurar esses campos opcionais. ## **ID do contentor GTM** Se utilizar **Google Tag Manager**, digite seu ID do recipiente (parece que `GTM-XXXXXXX`). Quando preenchido, o script do carregador GTM é injetado no iframe de reserva. Isso permite que você roteie dados para GA4, Google Ads ou outras tags através do GTM. ℹ️ Isto é completamente opcional. O rastreamento GA4 funciona sem GTM. --- ## **Modo de depuração** Activar **Modo de depuração** enquanto testa a sua configuração. Quando o modo de depuração estiver ligado: * Os eventos são validados primeiro contra o endpoint de depuração do Google * Você pode ver eventos em GA4 **DepurarVer** em tempo real * As cargas malformadas surgem como erros em vez de serem silenciosamente largadas Desligue o modo de depuração quando estiver satisfeito com a configuração. --- # **💾 Passo 5 — Salvar** Clique **Gravar** no bar de cima. Espere pela mensagem de confirmação, então seu rastreamento GA4 está ao vivo 🎉 --- # **📈 Que eventos são seguidos** Uma vez conectado, Hoppy Appointments envia automaticamente os seguintes eventos para o GA4. ## **compra** Despedido quando uma reserva é confirmada como criado. * **Reservas gratuitas** → dispara imediatamente após o cliente enviar o formulário * **Reservas pagas** → incêndios após o cliente completa checkout e pagamento é confirmado * Inclui valor de reserva, moeda e detalhes de serviço Este é o seu principal evento de conversão. --- ## **reserva completada** Despedido quando você marca a presença de uma reserva como **Concluído** no administrador. Use isso para rastrear compromissos que foram realmente cumpridos. --- ## **reserva cancelado** Despedido quando uma reserva é cancelada – seja por você ou pelo cliente. --- ## **reserva remarcada** Despedido quando uma reserva é transferida para uma nova data ou hora. --- ## **gerar lead** Despedido quando um cliente entra na lista de espera para um slot totalmente reservado. --- # **⚠️ Notas e Limitações Importantes** * **Os eventos GA4 são enviados para o servidor.** Hoppy Appointments usa o Protocolo de Medição GA4, então os eventos funcionam mesmo que o cliente use um bloqueador de anúncios. * **Não há evento de pagamento separado.** A conversão é monitorada como `purchase` sob a `booking_created` acção. O evento dispara uma vez que a reserva é confirmada, não quando o cliente começa checkout. * **As reservas manuais não são rastreadas.** As reservas criadas por sua equipe no administrador, POS ou manualmente são excluídas da análise. * **As reservas do pacote contam como uma conversão.** Um único evento é disparado para o pacote pai, não para cada sessão dentro dele. * **O segredo da API é necessário.** O rastreamento GA4 não funcionará apenas com o ID de Medição. * **GTM é opcional e só do lado do cliente.** Se você adicionar um ID de recipiente GTM, o script carrega dentro do iframe de reserva. Os eventos GA4 do lado do servidor ainda vão diretamente para GA4. * **O modo de depuração valida primeiro.** No modo de depuração, cada evento é verificado contra o endpoint de depuração do Google antes de ser enviado para o fluxo de produção. --- # **🎉 Resultado Final** Uma vez configurado: ✅ Conversões de reservas são enviadas para sua propriedade GA4 ✅ Reservas gratuitas e pagas são rastreadas corretamente ✅ Eventos do ciclo de vida como remarcar, cancelar e completar são gravados ✅ As inscrições na lista de espera aparecem como eventos principais ✅ Você pode analisar o comportamento de nomeação ao lado do tráfego de sua loja Com o GA4 conectado, você pode construir relatórios e audiências com base na atividade de reserva real – e tomar decisões mais inteligentes sobre seus serviços 📊 ---