Google Tag Manager: configurazione e aiuto

Segui i passaggi in Avvio rapido.

Apri "Configure" da "Module Manager". Il modulo ha schede "Core", "Server-side", "Events", "Traffic" e "Consent". Usa la pagina separata Diagnostica per i controlli. Sono presenti anche i controller Licenza, Assistenza, Aggiorna e "Integrity".

Rimuovi i caricamenti manuali duplicati del contenitore dal tema o da altri moduli. Il modulo controlla anche quale integrazione MPR è titolare del contenitore configurato e della destinazione GA4. Risolvi la titolarità prima di provare l'invio.

Configura personalmente lo spazio di lavoro GTM. Associa nomi e parametri degli eventi dataLayer del modulo ai tag da inviare e imposta i requisiti di consenso opportuni. Installare il modulo non pubblica quei tag GTM.

Il modulo carica gtm.js tramite il runtime browser condiviso. L'hook displayAfterBodyOpeningTag resta registrato, ma il suo modello body attuale non contiene un iframe noscript. Non usare un iframe come verifica dell'installazione.

Ogni interruttore standard è preimpostato su Sì. Disattiva gli eventi inutili.

Gli eventi del carrello registrano le modifiche di quantità riuscite, anziché i tentativi di aggiunta non riusciti. Prova modifiche di quantità riuscite nel tuo tema.

Contatto e coinvolgimento prodotto

Il coinvolgimento prodotto usa come predefiniti 3 interazioni galleria, 1 cambio variante, 1 interazione con dettagli o 45 secondi. L'intento elevato è limitato per prodotto e pagina senza deduplicazione tramite archiviazione di sessione in questa integrazione GTM. Usa i requisiti di consenso GTM per i tag riceventi.

"Enhanced Conversions" è allegato ai dati d'acquisto idonei. Non è un evento separato enhanced_conversions_data incondizionato su ogni pagina autenticata. Il modulo controlla il permesso di matching dell'acquirente prima di costruire quei dati.

Regole degli eventi personalizzati

[
  {"event":"gallery_browse","trigger":"click","selector":".product-images img,.images-container img","params":{"component":"product_gallery"},"once":false},
  {"event":"promo_page_seen","trigger":"url","contains":["/special-offer"],"params":{"campaign_area":"landing_page"}},
  {"event":"checkout_seen","trigger":"controller","controllers":["order","order-opc"]},
  {"event":"gallery_open","trigger":"event","dom_event":"mpr:gallery-open","params":{"component":"product_gallery"}}
]

document.dispatchEvent(new CustomEvent('mpr:gallery-open'));

I nomi devono iniziare con una lettera, usare lettere, cifre o underscore e avere al massimo 40 caratteri. Nomi/prefissi riservati e chiavi di parametri simili a dati personali vengono filtrati o rifiutati. I selettori di clic hanno un limite di 500 caratteri. once è false per i clic e true per le regole URL, controller e DOM per impostazione predefinita. Configura le attivazioni GTM per i nomi personalizzati esatti.

"Exclude logged-in employees" è preimpostato su Sì. Il runtime controlla le regole per i dipendenti e per la rinuncia al tracciamento quando invia; l'HTML pubblico condiviso può comunque contenere configurazione statica per un visitatore escluso. L'endpoint privato eventi applica i propri controlli di idoneità.

L'helper traffico riconosce gli user agent di bot, crawler, strumenti di audit e browser senza interfaccia. Una richiesta curl non equivale a una prova in un normale browser cliente.

Per escludere un browser dal tracciamento:

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

"Emit Consent Mode fallback (when no CMP installed)" è preimpostato su Sì. Il modulo di configurazione descrive il fallback con consenso negato per default per un negozio senza Cookies Revolution. Ripara l'ordine degli hook è un'azione che sposta questo modulo per ultimo su displayHeader dopo la CMP. Non è un interruttore salvato.

Il runtime Google condiviso attivo stabilisce anch'esso valori negati per default e legge il consenso attuale. Il percorso contenitore/dataLayer GTM delega il consenso dei tag successivi alla tua configurazione GTM. Gli eventi privati carrello/in attesa e l'autorizzazione acquisto richiedono la decisione esplicita analitica/di servizio applicabile. Configura comportamento del consenso del contenitore e CMP; un fallback non è un banner di consenso.

Prova rifiuto, concessione e revoca con la CMP effettiva e i tag GTM. Il runtime supporta altri lettori CMP, ma l'helper dell'ordine hook di questo modulo rileva specificamente Cookies Revolution. Una decisione mancante dell'acquirente sospende l'invio privato/server degli acquisti.

Salva entrambe le credenziali prima di attivare il fallback. Copre solo purchase. Il modulo registra l'ID client GA e il consenso analitico dell'acquirente durante la convalida dell'ordine e li ricontrolla prima dell'invio. Un acquisto senza l'ID client GA dell'acquirente non viene inviato; non viene generato un ID sostitutivo. Ordini del personale, dati dell'acquirente mancanti, conflitti di titolarità, restrizioni in uscita o una revoca possono sospendere un acquisto.

La convalida ordine ammette gli acquisti in una coda durevole; non invia direttamente una richiesta HTTP a GA4. Il worker registrato rileva anche acquisti recenti idonei:

task: send_ga4_measurement_protocol
callable: mprgoogletagmanager::cronProcessMeasurementProtocolQueue
schedule: every:300
context: cron
timeout: 30

Assicurati che il runner cron MPR condiviso esegua l'attività. Il worker invia lotti da 20; questa schermata non ha un campo per la dimensione del lotto. Il worker usa i dati dell'acquirente salvati al checkout, mai i cookie di chi esegue il cron.

I dati browser e server usano il riferimento ordine come transaction_id e un registro condiviso evita che lo stesso ordine venga inviato due volte. Fai un ordine di prova e controlla come appare nella destinazione, valori e articoli compresi.

Usa Diagnostica > Esegui i test per controllare configurazione, contenitori duplicati, ordine hook, visibilità del gruppo del modulo, JSON personalizzato e stato server. Usa Ripara l'ordine degli hook o Ripara il gruppo di moduli quando indicato.

In GTM Preview, conferma ogni nome evento e controlla ecommerce.currency, ecommerce.value e ecommerce.items. I dati d'acquisto includono riferimento transazione, imposte, spedizione, coupon e campi articolo disponibili quali ID, nome, marca, categoria, variante, prezzo e quantità. L'integrazione svuota l'oggetto e-commerce precedente prima di inserire un altro evento e-commerce.

L'output pubblico contiene configurazione statica. I dati cliente/carrello/in attesa vengono ottenuti tramite l'endpoint privato autenticato. Controlla che la cache non serva risposte private a un altro visitatore. Verifica un ordine di prova in Preview e nell'account analitico ricevente dopo aver configurato e pubblicato il contenitore.

Se manca il contenitore, controlla interruttore principale, "Container ID", titolarità della destinazione, regole di esclusione dei dipendenti applicate al browser, script bloccati e risorse condivise mancanti. Il modello body attuale è intenzionalmente vuoto.

Se mancano eventi, controlla interruttori, esecuzione degli hook del tema, risposta dell'endpoint privato e consenso. Usa un cambio carrello riuscito; l'hook precedente all'aggiornamento conservato non emette eventi. Un checkout personalizzato può richiedere una propria regola o integrazione.

Se gli acquisti server sono sospesi, controlla credenziali salvate, che il worker sia in esecuzione, i dati dell'acquirente registrati, l'ID client GA originale e le revoche. Esamina diagnostica e log recenti. La tabella di log usa il prefisso configurato del database seguito da mpr_analytics_events.

Imposta "Enable Google Tag Manager" su No e salva per sospendere l'integrazione. Disinstalla tramite "Module Manager" per rimuovere menu, configurazione e registrazione cron. Questo metodo non elimina esplicitamente righe del log eventi o della coda. L'infrastruttura condivisa segue le regole di conservazione del suo schema; non eliminare tabelle manualmente. Contenitore GTM e cronologia Google Analytics rimangono nei rispettivi servizi.

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