QRCode Suitepiattaforma QR
Documentazione

Setup forwarding GA4

Il forwarding GA4 invia ogni scan QR alla Sua proprietà Google Analytics 4 come evento `qr_scan`, e ogni conversione registrata come `qr_conversion`, tramite il Measurement Protocol. La configurazione si trova nella dashboard sotto Impostazioni → Integrazioni e richiede circa cinque minuti. Il forwarding è spento finché non lo collega — di default nulla lascia la piattaforma.

  1. 1

    Recuperi Measurement ID e secret API

    In Google Analytics 4: Admin → Flussi dati → il Suo flusso web → Measurement ID (inizia per `G-`). Dalla stessa schermata apra Secret API del Measurement Protocol → Crea e copi il valore. Servono entrambi: il Measurement Protocol si autentica sul secret e non su un tag del browser, perché questi eventi partono lato server dalla redirezione e non dal dispositivo del visitatore.

  2. 2

    Colleghi l'integrazione

    Dashboard → Impostazioni → Integrazioni → GA4. Incolli Measurement ID e secret API e salvi. Le credenziali vengono cifrate in AES-256-GCM prima di essere memorizzate, e il pannello mostra poi solo una versione mascherata. Usi «Invia test» per spingere un evento sonda e confermare che le credenziali funzionano prima di affidarsi alla connessione. Il forwarding GA4 è disponibile dal piano Pro; il piano viene ricontrollato al momento dell'invio, quindi un'organizzazione retrocessa smette subito di inoltrare invece di proseguire su un piano che non ha più.

  3. 3

    Sappia esattamente quali parametri partono

    Uno scan invia l'evento `qr_scan` con `qr_id`, `slug`, `device` e `country`, più `campaign_id` e `destination` quando il codice appartiene a una campagna o ha risolto verso un URL specifico. Una conversione invia `qr_conversion` con `event_name`, `source` e — quando presenti — `qr_id`, `campaign_id`, `value` e `currency`. Ogni payload porta `non_personalized_ads: true`. Il `client_id` GA4 è derivato in modo deterministico dall'hash di sessione anonimo: scan ripetuti dello stesso visitatore puntano allo stesso client GA4, senza cookie e senza nulla di riconducibile a un indirizzo IP.

  4. 4

    Verifichi in GA4 Tempo reale

    Scansioni uno dei Suoi codici con un telefono, poi apra GA4 → Report → Tempo reale entro un paio di minuti. L'evento `qr_scan` deve comparire, e il breakdown dei parametri deve mostrare lo `slug` del codice scansionato. Se non arriva nulla, le cause abituali sono un secret Measurement Protocol preso da un altro flusso dati, oppure un evento filtrato come traffico bot — gli accessi bot sono registrati sulla piattaforma ma non vengono mai inoltrati a GA4 né a nessun'altra integrazione.

  5. 5

    Cosa il forwarding non può rompere

    Il fan-out parte in fire-and-forget dalla redirezione: ogni adapter limita il proprio tempo di rete, non segue mai i redirect e registra i fallimenti invece di sollevarli. Un disservizio GA4 quindi non rallenta nulla e non perde scan dalla nostra parte — l'evento viene comunque scritto sulla piattaforma e i numeri della dashboard restano corretti anche quando la copia inoltrata non arriva mai. Tratti GA4 come una seconda destinazione, fallibile, non come il sistema di registrazione.

Domande frequenti

Che cos'è QRCode Suite?

QRCode Suite è una piattaforma QR indipendente: crei un account gratuito e generi QR code dinamici e personalizzati nel browser — senza bisogno di WordPress. I connettori portano gli stessi codici su WordPress e WooCommerce, dove gli ordini possono essere attribuiti a specifici QR code.

QRCode Suite funziona senza WordPress?

Sì. QRCode Suite è un SaaS indipendente: si registri, crei i QR code e monitori le scansioni interamente su qrcode-suite.com. Il plugin WordPress è un connettore opzionale che porta i Suoi codici in wp-admin e aggiunge l'attribuzione degli ordini WooCommerce.

QRCode Suite richiede un abbonamento separato?

Il piano Free è disponibile senza costi — senza carta di credito. I piani a pagamento (Pro 9 €, Business 29 €, Agency 79 € al mese) sbloccano codici illimitati, regole di redirect e altro. Non ci sono costi per singola scansione.

Quali tipi di QR code supporta QRCode Suite?

QRCode Suite supporta 22 tipi di QR code: URL statico, URL dinamico, Testo semplice, Telefono, Email, Posizione, Link Hub, SMS, WhatsApp, Wi-Fi, vCard, Profilo social, PDF, Download di file, Download di app, Coupon, Evento calendario, Modulo di raccolta lead, Raccolta recensioni, Richiesta all'ingrosso, Premio fedeltà e Payload personalizzato.

Posso modificare la destinazione di un QR code dopo averlo stampato?

Sì. I QR code dinamici usano un URL di redirect breve. Può aggiornare la destinazione dalla dashboard in qualsiasi momento, senza rigenerare o ristampare il codice.

Serve aiuto per iniziare?

Inizi gratis o consulti tutta la documentazione.

Inizia gratisTutta la doc