
Minilição 24 de 30 · Alcançar pessoas e oferecer serviços
Escolha o significado real do evento
Para quem é esta lição?
Para quem quer entender visitas ao site e ações úteis. Um assistente pode conectar o exemplo de rastreamento fornecido; você decide o significado de uma medição e examina o resultado.
Meça o resultado que importa, não um clique próximo dele.
Objetivo desta lição
- Defina uma ação sem confundir clique com conclusão.
- Examine eventos realmente coletados.
- Mantenha consentimento, falha de coleta e dados privados separados.
Explicação, exemplo resolvido e prática
Antes de começar
Sua própria propriedade GA4 e fluxo web de prática e a página separada fornecida. Um assistente de programação pode configurar e orientar o DebugView. Isole os eventos de prática e use atividade fictícia, não dados privados de visitantes.
Confira os conhecimentos iniciais
São habilidades úteis, não cursos obrigatórios bloqueados. Se já as domina, comece aqui; caso contrário, abra a preparação. Os arquivos fornecidos dispensam um site pessoal anterior.
- Como publicar seu site pelo GitHub
Conecte um repositório de prática à hospedagem.
Tempo estimado: 19–31 min
Estimativas com os arquivos iniciais e as contas e ferramentas necessárias já prontas. Configuração, filas de publicação e esperas de e-mail ou DNS exigem tempo adicional. O exemplo é uma configuração de prática condicionada ao consentimento, não um sistema completo de consentimento para uma jurisdição específica. Os relatórios da conta podem demorar para atualizar.
Entenda a ideia
Abra a página de prática por HTTP com o assistente. O botão “Open workshop instructions” revela uma seção de instruções. O resultado útil é as instruções ficarem visíveis, não apenas alguém pressionar o botão.
Em measurement-plan.csv, descreva esse resultado como workshop_open, uma vez por carregamento após permitir a análise. O exercício conta só atividade registrada; não informa quantos visitantes com bloqueio ou sem consentimento usaram o recurso.
Um exemplo concreto
Suponha que o botão foi pressionado, mas um erro manteve as instruções ocultas. É uma tentativa de interação, não um workshop_open bem-sucedido. Uma inscrição também só contaria como concluída depois da sua própria condição de sucesso.
Use a página de análise fornecida e meu fluxo GA4 exclusivo para testes. Configure o ID público e mantenha Enhanced Measurement desligado neste exercício isolado. Explique workshop_open como a primeira abertura visível após carregar a página. Teste cada ramo com nova recarga: Keep analytics off e abrir; Allow analytics e abrir duas vezes; e uma solicitação de coleta bloqueada. Mostre page_view e workshop_open separadamente em Network e no meu DebugView. Não envie e-mail, texto livre ou identificadores privados. Os botões básicos escolhem o consentimento inicial de um carregamento; não apresente Keep analytics off como retirada de consentimento depois de Allow.Arquivos desta etapa
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
Experimente
O botão fornecido é pressionado, mas as instruções ficam ocultas. Isso deve contar como workshop_open? Qual resultado observável deve contar?
Mostrar uma solução comentada
Não deve contar. Contaria workshop_open quando as instruções ficassem visíveis pela primeira vez após permitir a análise, no máximo uma vez nesse carregamento. Um segundo clique que deixa as mesmas instruções abertas não deve adicionar outra abertura.
O que uma boa resposta inclui
- Define o evento como instruções visíveis, não um clique.
- Usa uma primeira abertura por carregamento como regra de contagem.
Como funciona (opcional)
Meça visitas e uma ação útil
Decida o que um número significa antes de acrescentar rastreamento.
Uma visualização indica que uma página foi registrada, enquanto uma ação relevante informa algo sobre o uso. Aqui a ação é abrir as instruções da oficina, não apenas passar o cursor sobre um botão.
Este exemplo carrega o GA4 apenas depois de uma aceitação de prática. Seus números, portanto, descrevem atividade registrada com consentimento, não um censo completo de todos os visitantes. Bloqueios, consentimento e falhas de rede podem criar lacunas na medição.
Exemplo resolvido
workshop_open só é enviado quando as instruções ficam visíveis pela primeira vez nesta aba. Ele não recebe o nome sign_up nem purchase, porque nenhuma dessas ações aconteceu.
Exercício técnico complementar
Um visitante clica no botão de inscrição, mas a verificação falha. Isso deve ser contado como uma inscrição concluída?
Mostrar uma solução comentada
Não. Você pode contar uma tentativa separadamente, mas a inscrição concluída só deve ser disparada depois de o sistema confirmar o sucesso.
- Distingue tentativa de interação de resultado bem-sucedido.
- Nomeia o evento conforme o comportamento observado.

Etapa 1 · Como medir visitas e ações úteis no seu site
Conecte apenas a medição de prática
Deixe o assistente cuidar da integração enquanto você limita os dados.
Explicação, exemplo resolvido e prática
Entenda a ideia
Peça ao assistente para conectar seu fluxo web GA4 exclusivo e desativar Enhanced Measurement neste teste isolado. O ID de medição é configuração pública. Exclua texto pessoal, endereços de e-mail e informações privadas de URL dos valores enviados.
A página começa sem análise. “Allow analytics for this test” ativa para aquele carregamento; “Keep analytics off” só mantém desligada uma página inicialmente desligada. Não desfaz Allow. Recarregue antes de trocar de ramo de teste. Um site público precisa de um fluxo adequado de preferências e retirada de consentimento além deste exercício.
Um exemplo concreto
Para a ação fornecida, workshop_id pode ser o valor fixo practice-one. Não precisa do e-mail do visitante ou do texto que digitou em outro formulário. A tarefa de referência usa explanation_open, não workshop_open; compare cada versão com seu próprio nome de evento.
Arquivos desta etapa
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
Experimente
Quais valores de evento a prática precisa, quais dados privados você excluirá e como começará um teste com análise desligada?
Mostrar uma solução comentada
Eu enviaria workshop_open com workshop_id practice-one e o page_view separado após optar pela análise. Excluiria e-mails, mensagens e dados privados de URL. No ramo desligado, recarregaria, escolheria “Keep analytics off” e abriria as instruções. Clicar nisso depois de Allow não retira o consentimento neste laboratório.
O que uma boa resposta inclui
- Usa o identificador fixo da ação sem texto privado ou identidade.
- Inicia o ramo desligado após nova recarga e não trata recusar depois de permitir como retirada de consentimento.
Como funciona (opcional)
Configure um conjunto pequeno e intencional de eventos
Use um fluxo de teste e examine exatamente o que sai da página.
Crie seu próprio fluxo da web no GA4, desative Enhanced Measurement para este exercício isolado e coloque o ID de medição em config.js. É configuração pública; não a confunda com uma chave de serviço privilegiada.
O script suprime a visualização automática e envia uma explicitamente após a aceitação. Remove a consulta e o fragmento de page_location, limpa o campo de referência e envia apenas um ID fixo de oficina com a ação. Mantenha nomes, e-mails e textos de formulário fora dos eventos.
Enhanced Measurement é desativado aqui apenas para isolar os eventos explícitos desta lição. Em um site real, escolha os recursos de medição de acordo com um plano revisado, em vez de supor que devem ficar sempre desligados. Mantenha este fluxo de prática separado e examine tráfego inesperado: um ID público de medição não autentica eventos de visitantes genuínos.
Exemplo resolvido
Uma URL contendo ?email=someone@example.com não deve virar parâmetro de evento. O código fornecido usa apenas a origem e o caminho no próprio campo de localização; também não coloque dados pessoais em segmentos do caminho.
GA4: configurar eventos · GA4: campos de configuração
Exercício técnico complementar
Por que o plano de medição deve listar dados excluídos além dos nomes dos eventos?
Mostrar uma solução comentada
Parâmetros de eventos e URLs podem vazar informações sem intenção. Defina o que deve ficar de fora e depois examine a solicitação do navegador para verificar se o código respeita esse limite.
- Antecipa a coleta acidental de dados pessoais.
- Verifica os dados realmente enviados.

Etapa 2 · Como medir visitas e ações úteis no seu site
Verifique o evento real no provedor
Um evento em fila local ainda não é coleta pelo provedor.
Explicação, exemplo resolvido e prática
Entenda a ideia
Faça dois testes separados com o assistente. Teste A: recarregue, escolha “Keep analytics off” e abra as instruções. Elas devem aparecer sem script Google nem solicitação de coleta. Teste B: recarregue, escolha Allow e abra duas vezes.
No teste B, as contagens explícitas devem ser um page_view e um workshop_open. Confira as solicitações e o evento correspondente no seu DebugView separadamente; comandos enfileirados não são recebimento. Se abrir antes de Allow, essa abertura não será contada depois; recarregue e siga a ordem indicada.
Um exemplo concreto
Matriz esperada: desligado → abrir = 0 page_view, 0 workshop_open; nova recarga → Allow → abrir duas vezes = 1 page_view, 1 workshop_open. São contagens dos eventos nomeados da prática, não uma afirmação de que todos os tipos automáticos do GA4 somam dois.
Arquivos desta etapa
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
Experimente
Faça os testes após nova recarga: desligado/abrir e Allow/abrir duas vezes. O que ocorreu localmente e quais eventos nomeados chegaram ao fluxo de teste?
Mostrar uma solução comentada
Resultado ilustrativo: Após uma nova escolha desligada, as instruções abriram sem solicitação de análise: 0 page_view e 0 workshop_open. Depois de nova recarga e Allow, dois cliques geraram um page_view e um workshop_open no fluxo. Se Network enfileira os comandos, mas DebugView não mostra recebimento, a coleta do provedor continua sem comprovação, não aprovada.
O que uma boa resposta inclui
- Usa um carregamento novo para cada ramo de consentimento e a ordem de ações indicada.
- Compara as contagens esperadas 0/0 e 1/1 com as observações reais no navegador e no provedor.
Como funciona (opcional)
Verifique a coleta separadamente da fila local
Uma entrada em dataLayer não prova que o Google a recebeu.
Mantenha a análise desligada e verifique se as instruções ainda abrem sem carregar gtag.js. Em uma nova aba, permita o teste, examine as solicitações de saída e abra o DebugView ou Realtime do GA4.
Clique duas vezes no botão da oficina. Esta implementação envia sua ação uma vez por carregamento da página. Um script bloqueado pode deixar uma fila local sem evento recebido; um painel sem atividade, por si só, não prova que ninguém visitou.
O indicador de abertura fica apenas na memória da página. Recarregar inicia uma nova instância de medição e pode registrar outra abertura; isso não é uma contagem duradoura de pessoas únicas. Uma abertura anterior ao consentimento não é emitida retroativamente após a aceitação.
Exemplo resolvido
Se o navegador coloca workshop_open na fila, mas um bloqueador impede a solicitação de coleta, o recurso pode continuar funcionando enquanto o GA4 não o registra. Verifique o caminho do rastreamento antes de deduzir uma queda brusca no tráfego.
Exercício técnico complementar
A fila local contém o evento, mas o DebugView não. O que você verificou e o que continua desconhecido?
Mostrar uma solução comentada
Você verificou que a página criou um comando de evento. Confirme o ID correto de medição, a entrega do script e da solicitação e a visualização da conta antes de afirmar que houve ingestão.
- Afirma apenas a criação local do evento.
- Investiga separadamente a entrega pela rede e a ingestão na conta.

Etapa 3 · Como medir visitas e ações úteis no seu site
Verifique uma nova ação significativa
Mantenha definição, implementação e teste juntos.
Explicação, exemplo resolvido e prática
Entenda a ideia
Peça ao assistente para implementar a variante fornecida de abrir uma explicação. A ação bem-sucedida é a explicação ficar visível, chamada explanation_open com explanation_id practice-one. A referência mantém o comportamento de consentimento inicial e uma vez por carregamento.
Repita os testes com nova recarga, desligado e Allow/abrir duas vezes, para o novo evento. Depois peça uma simulação local de bloqueio da análise. A explicação deve continuar utilizável se a coleta falhar. Salve esperado e observado em analytics-tests.txt.
Um exemplo concreto
Na referência, a meta é 0 explanation_open enquanto desligado e 1 após Allow e dois cliques. Ver workshop_open significaria que a ação antiga continua sendo medida, mesmo com o rótulo do botão alterado.
Arquivos desta etapa
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
Experimente
Entregue a alteração de abertura da explicação com resultados desligado, ligado/cliques repetidos e coleta bloqueada. Qual evento foi realmente medido?
O que entregar: Uma definição de evento e observações reais positivas e negativas de coleta.
Mostrar uma solução comentada
Entrega ilustrativa: A explicação abre sem rastreamento no ramo desligado; um novo ramo Allow seguido de dois cliques envia um explanation_open com explanation_id practice-one, além do page_view separado. Bloquear a coleta mantém a explicação legível, sem afirmar recebimento pelo provedor. Isso verifica a ação nomeada e consentimento inicial, não um sistema de retirada pronto para produção.
O que uma boa resposta inclui
- Mede a explicação visível com explanation_open e o identificador fixo correspondente.
- Verifica zero antes do consentimento, um após aberturas repetidas permitidas e uso do recurso mesmo com falha de coleta.
Como funciona (opcional)
Sua tarefa: medir um resultado real
Escolha um recurso cujo resultado bem-sucedido seu site consiga observar.
Escreva um plano de medição para um recurso: uma inscrição confirmada, uma solicitação de download bem-sucedida ou uma busca concluída. Defina tentativa e sucesso separadamente quando fizer sentido.
Implemente um evento fixo sem dados pessoais e verifique se uma ação que falha não emite sucesso. Documente os limites de bloqueadores e consentimento e remova o modo de depuração antes de uma publicação real.
Exemplo resolvido
Um clique no botão de formulário pode produzir feedback_attempt; apenas uma resposta bem-sucedida do servidor deve produzir feedback_accepted. Nenhum dos dois prova que um e-mail posterior foi entregue.
O roteiro completo de referência está em reference/assignment-walkthrough.txt. Compare as etapas com seu resultado; preencha o registro de teste com observações do seu próprio projeto.
Exercício técnico complementar
Produza uma definição de evento, sua implementação e um registro de coleta positiva e negativa.
Mostrar uma solução comentada
Defina uma ação que o sistema realmente consiga observar. O recurso de prática de referência abre uma explicação local e emite um evento fixo explanation_open apenas depois de ela ficar visível, não simplesmente quando um botão é pressionado.
Antes de aceitar, realize a tarefa e confirme que funciona sem carregar o script do Google. Depois de aceitar em uma nova aba, examine page_view e os dados e a quantidade de eventos da ação em Network e no seu próprio DebugView. Clique duas vezes e verifique a regra documentada de uma vez por aba.
Mantenha textos livres, e-mail, consulta e fragmento e conteúdo identificável de caminhos fora dos eventos. Um comando local na fila não é ingestão remota; um bloqueador ou fluxo incorreto pode deixar relatórios vazios mesmo quando a página funciona. Remova o modo de depuração e implemente um fluxo adequado de consentimento persistente e retirada antes do uso público.
- O sucesso corresponde ao conhecimento real do sistema.
- Nenhum texto livre nem identidade pessoal é enviado e ações com falha não emitem sucesso.
Esta lição foi útil?
Deixe uma curtida ou compartilhe com alguém que possa aproveitar.