Google Analytics GA4: configurazione e aiuto

Segui i passaggi in Avvio rapido.

Apri "Configure" in "Module Manager". Usa Impostazioni per ID e controlli del tracciamento, Diagnostica per le verifiche. Sono presenti pagine separate Licenza, Assistenza, Aggiorna e "Integrity".

"Enhanced Conversions" calcola l'hash di email, telefono, nome, cognome, città, regione e codice postale dopo aver rimosso gli spazi alle estremità e convertito in minuscolo. Il codice ISO del paese viene inviato senza hash. I campi indirizzo provengono dal primo indirizzo del cliente, se disponibile. Questa opzione è distinta dal tracciamento dell'ID cliente con hash.

Coinvolgimento prodotto

Il tracker condiviso riconosce anche cambi variante e interazioni con i dettagli prodotto. Per impostazione predefinita limita l'intento elevato a una volta per prodotto/sessione. Mantienilo separato dalla configurazione principale delle conversioni d'acquisto.

Quando Cookies Revolution è attivo, il modulo lo rileva e può spostarsi per ultimo su displayHeader affinché la CMP inizializzi prima Consent Mode. Usa Ripara l'ordine degli hook in Diagnostica se necessario.

Senza quella CMP rilevata, il modulo emette valori predefiniti Consent Mode che negano la memorizzazione analitica, pubblicitaria, dei dati utente pubblicitari e di personalizzazione, consentendo quella di sicurezza. È uno snippet predefinito. Non crea un banner né acquisisce il consenso. Configura gli aggiornamenti tramite lo strumento di consenso.

Il controllo di idoneità browser esclude controller non frontend, bot/strumenti di audit riconosciuti, dipendenti esclusi e browser con mpr_notrack=1. Per escludere un browser di prova:

document.cookie = 'mpr_notrack=1; path=/; max-age=31536000; SameSite=Lax';

Gli acquisti server richiedono il consenso analitico acquisito dell’acquirente, i suoi ID client e sessione GA originali e l’autorizzazione per questo modulo a inviare dati alla proprietà GA4 configurata. Si applicano anche gli opt-out del browser e le esclusioni dei dipendenti. "Server-Side Purchase Fallback" è disattivo per impostazione predefinita. Per attivarlo, inserisci credenziali valide e imposta "Purchase recovery hostname" sul nome host HTTPS del negozio in produzione, senza protocollo né percorso.

Il modulo carica GA4 in modo asincrono tramite displayHeader. Invia eventi e-commerce tramite questi percorsi:

Questa schermata delle impostazioni non ha interruttori separati per gli eventi e-commerce standard. La loro presenza dipende dagli hook corrispondenti e dal flusso del tema.

I dati d'acquisto includono riferimento ordine come transaction_id, valore, valuta, imposte, spedizione, coupon e righe. I campi articolo disponibili includono ID, nome, prezzo, quantità, marca, categoria, variante e sconto. Verifica i valori con un ordine di prova usando la tua configurazione di imposte, sconti e spedizione.

"Track custom events" è preimpostato su No. Il campo "Custom event rules" parte vuoto. Aggiungi regole, attiva l'interruttore e salva:

[
  {"event":"gallery_browse","trigger":"click","selector":".product-images img,.images-container img","params":{"component":"product_gallery"},"once":false},
  {"event":"checkout_page_seen","trigger":"url","contains":["/order"],"params":{"area":"checkout"},"once":true},
  {"event":"module_page_seen","trigger":"controller","controllers":["module"],"modules":["mprwishlist"]},
  {"event":"size_guide_opened","trigger":"event","dom_event":"shop:size-guide-opened","params":{"component":"size_guide"},"once":false}
]

document.dispatchEvent(new CustomEvent('shop:size-guide-opened'));

Usa nomi di eventi e parametri che inizino con una lettera, contengano lettere, cifre o underscore e abbiano al massimo 40 caratteri. Nomi e prefissi riservati vengono rifiutati. Le chiavi simili a dati personali vengono filtrate. I selettori di clic possono avere fino a 500 caratteri. once è false per i clic e true per le regole URL, controller e DOM per impostazione predefinita. Adatta i filtri controller/modulo alla rotta reale.

La convalida dell’ordine registra gli acquisti idonei per il recupero. Dopo 30 minuti senza conferma del browser, l’attività cron condivisa accoda e invia gli eventi Measurement Protocol purchase idonei usando i dati dell’acquirente acquisiti al checkout:

task: send_ga4_measurement_protocol
callable: mprgoogleanalytics::cronProcessMeasurementProtocolQueue
schedule: every:300
context: any
timeout: 30

Assicurati che il runner cron MPR condiviso esegua l'attività. Controlla il log eventi in Diagnostica e la coda conversioni condivisa. Le righe di log usano il prefisso del database seguito da mpr_analytics_events; ps_ è solo il consueto esempio. La pulizia di conservazione avviene dopo una convalida d'ordine idonea. Il recupero degli acquisti scade 72 ore dopo l’ordine. La conservazione dei record di recupero segue "Log Retention (days)".

Gli acquisti browser e server usano il riferimento ordine come transaction_id. Un registro condiviso assegna ogni acquisto a un solo canale di invio. Il recupero server gestisce solo gli ordini ancora privi di conferma del browser dopo 30 minuti.

Gli ID client e sessione server provengono dai cookie GA originali acquisiti prima dell’ordine. Gli ID mancanti o inutilizzabili sospendono il recupero; il modulo non genera identità sostitutive. La coda non trasforma eventi solo browser in eventi server.

Apri Diagnostica e usa Esegui i test. Controlla configurazione richiesta, validità delle regole, ordine degli hook, visibilità del gruppo del modulo, rilevamento CMP, script duplicati, esclusioni e stato Measurement Protocol. Usa Ripara l'ordine degli hook o Ripara il gruppo di moduli quando opportuno.

Usa un normale browser cliente per verificare richieste di rete e GA4 DebugView. Gli user agent bot/audit possono essere esclusi intenzionalmente. Prova visualizzazione prodotto, cambi carrello, checkout, login, registrazione, ricerca e ordine completo. Verifica riferimento transazione e totali degli articoli.

Se nessun tag si carica, controlla "Enable Tracking", "Measurement ID", esclusioni dipendenti/opt-out, esecuzione degli hook e titolarità duplicata. Se il tema omette displayProductActions o displayBeforeCarrier, il relativo evento potrebbe mancare.

Se manca l'acquisto server, controlla interruttore di fallback, ID, segreto, assegnazione della funzione di tracciamento al modulo, worker della coda e log HTTP/errori recente. Un segreto vuoto lascia disponibile il tracciamento browser. I totali GA4 possono differire da PrestaShop per script bloccati, consenso, attribuzione, ritardi dei report e rimborsi. Il tracciamento acquisti del modulo non è un sistema di riconciliazione contabile.

Imposta "Enable Tracking" su No e salva per sospendere l'integrazione. Disinstalla tramite "Module Manager" per rimuovere menu, registrazione cron e configurazione. La tabella condivisa della coda rimane se un altro modulo usa il pacchetto conversioni; altrimenti l'helper di disinstallazione la elimina. Gestisci proprietà GA4 e dati storici in Google Analytics. Il log eventi usa archiviazione condivisa; non eliminare manualmente una tabella condivisa.

Usa i nomi delle impostazioni sopra quando una schermata differisce dalla versione installata.