Configuração do forwarding GA4
- 1
Obtenha o Measurement ID e o segredo API
No Google Analytics 4: Admin → Fluxos de dados → o seu fluxo web → Measurement ID (começa por `G-`). No mesmo ecrã, abra Segredos API do Measurement Protocol → Criar e copie o valor. São precisos os dois: o Measurement Protocol autentica-se pelo segredo e não por uma tag de navegador, porque estes eventos saem do servidor no redirecionamento e não do dispositivo do visitante.
- 2
Ligue a integração
Painel → Definições → Integrações → GA4. Cole o Measurement ID e o segredo API e guarde. As credenciais são cifradas com AES-256-GCM antes de serem armazenadas, e o painel passa a mostrar apenas uma versão mascarada. Use «Enviar teste» para lançar um evento sonda e confirmar que as credenciais funcionam antes de depender da ligação. O forwarding GA4 está disponível a partir do plano Pro; o plano é reverificado no momento do envio, por isso uma organização despromovida deixa de encaminhar de imediato em vez de continuar num plano que já não tem.
- 3
Saiba exatamente que parâmetros são enviados
Um scan envia o evento `qr_scan` com `qr_id`, `slug`, `device` e `country`, mais `campaign_id` e `destination` quando o código pertence a uma campanha ou resolveu para um URL específico. Uma conversão envia `qr_conversion` com `event_name`, `source` e — quando existem — `qr_id`, `campaign_id`, `value` e `currency`. Cada payload leva `non_personalized_ads: true`. O `client_id` do GA4 é derivado de forma determinista do hash de sessão anónimo: scans repetidos do mesmo visitante apontam para o mesmo cliente GA4, sem cookie e sem nada reversível para um endereço IP.
- 4
Verifique no GA4 Tempo real
Digitalize um dos seus códigos com um telemóvel e abra GA4 → Relatórios → Tempo real dentro de um ou dois minutos. O evento `qr_scan` deve aparecer, e o detalhe de parâmetros deve mostrar o `slug` do código digitalizado. Se nada chegar, as causas habituais são um segredo do Measurement Protocol de outro fluxo de dados, ou um evento filtrado como tráfego de bots — os acessos de bots são registados na plataforma mas nunca são encaminhados para o GA4 nem para qualquer outra integração.
- 5
O que o forwarding não consegue partir
O fan-out sai em fire-and-forget a partir do redirecionamento: cada adaptador limita o seu próprio tempo de rede, nunca segue redirecionamentos e regista as falhas em vez de as propagar. Uma indisponibilidade do GA4 não atrasa nada nem perde scans do nosso lado — o evento continua a ser escrito na plataforma e os números do painel mantêm-se corretos mesmo quando a cópia encaminhada nunca chega. Trate o GA4 como um segundo destino, falível, e não como o sistema de registo.
Perguntas frequentes
O que é o QRCode Suite?
O QRCode Suite é uma plataforma QR independente: crie uma conta gratuita e gere códigos QR dinâmicos e personalizados no browser — sem precisar de WordPress. Os conectores levam os mesmos códigos ao WordPress e ao WooCommerce, onde os pedidos podem ser atribuídos a códigos QR específicos.
O QRCode Suite funciona sem WordPress?
Sim. O QRCode Suite é um SaaS independente: registe-se, crie códigos QR e acompanhe as leituras inteiramente em qrcode-suite.com. O plugin WordPress é um conector opcional que traz os seus códigos para o wp-admin e adiciona a atribuição de encomendas WooCommerce.
O QRCode Suite exige uma subscrição separada?
O plano Free está disponível sem custos — sem cartão de crédito. Os planos pagos (Pro 9 €, Business 29 €, Agency 79 € por mês) desbloqueiam códigos ilimitados, regras de redireccionamento e mais. Não existe taxa por leitura.
Que tipos de códigos QR suporta o QRCode Suite?
O QRCode Suite suporta 22 tipos de códigos QR: URL estático, URL dinâmico, Texto simples, Telefone, Email, Localização, Link Hub, SMS, WhatsApp, Wi-Fi, vCard, Perfil social, PDF, Descarga de ficheiro, Descarga de app, Cupão, Evento de calendário, Formulário de captação de leads, Recolha de avaliações, Pedido grossista, Recompensa de fidelidade e Payload personalizado.
Posso alterar o destino de um código QR depois de o imprimir?
Sim. Os códigos QR dinâmicos usam um URL de redireccionamento curto. Pode actualizar o destino a partir do seu painel a qualquer momento, sem gerar ou imprimir novamente o código.
Precisa de ajuda para começar?
Comece grátis ou consulte toda a documentação.