Carrello della spesa
Tracciamento automatico degli eventi e-commerce
Il modulo supporta l’intero set di eventi richiesti da Google Dynamic Remarketing nel modello retail. Ogni evento invia l’identificatore del prodotto (items[].id) conforme al feed di Google Merchant Center e il parametro google_business_vertical: 'retail', consentendo a Google di abbinare con precisione gli annunci ai prodotti del tuo catalogo.
| Evento Google | Quando si attiva | Dati nell’evento |
|---|---|---|
| view_item | Pagina prodotto + cambio variante (AJAX) | ID prodotto, prezzo, business vertical |
| view_item_list | Categoria, novità, bestseller, promozioni, produttore, fornitore | Elenco ID prodotti, valore totale |
| view_search_results | Risultati di ricerca | Elenco ID prodotti, valore totale |
| add_to_cart | Aggiunta del prodotto al carrello (AJAX, senza ricaricamento) | ID prodotto con la variante selezionata, prezzo |
| purchase | Conferma dell’ordine | Elenco ID prodotti, valore dell’ordine, valuta |
Identificatore prodotto configurabile
Un requisito fondamentale di Google è la corrispondenza tra l’identificatore del prodotto nel tag di remarketing e l’identificatore nel feed di Google Merchant Center. Il modulo consente di scegliere il formato dell’identificatore tra 5 opzioni:
- ID prodotto —
id_productpredefinito dal database PrestaShop - ID prodotto - ID attributo — formato
id_product-id_product_attribute(trattino) - ID prodotto _ ID attributo — formato
id_product_id_product_attribute(underscore) - Reference — codice / numero di catalogo del prodotto
- EAN-13 — codice a barre europeo
Per i prodotti con combinazioni (varianti), il modulo recupera automaticamente gli identificatori specifici della combinazione selezionata — se la variante ha un proprio EAN o una propria referenza, sarà proprio questo identificatore a essere inviato a Google, e non l’identificatore del prodotto principale.
Pagine listing supportate
Il modulo traccia l’evento view_item_list su tutte le pagine con elenchi di prodotti in PrestaShop:
- Pagine categoria
- Pagine produttore
- Pagine fornitore
- Novità
- Bestseller
- Promozioni (riduzioni di prezzo)
Su ciascuna di queste pagine il modulo prova prima a recuperare l’elenco dei prodotti dai dati già caricati da PrestaShop (variabili Smarty), eliminando così query SQL aggiuntive. Se i dati non sono disponibili (ad es. tema personalizzato), il modulo passa automaticamente a una query diretta al database come fallback.
Tracciamento intelligente di varianti e carrello
Nella pagina prodotto, quando il cliente cambia variante (colore, taglia), il modulo invia una richiesta AJAX asincrona al server, recupera l’identificatore e il prezzo della combinazione specifica e quindi invia immediatamente a Google l’evento view_item aggiornato — senza ricaricare la pagina. Allo stesso modo, l’aggiunta del prodotto al carrello genera l’evento add_to_cart con l’identificatore corretto della variante.
Tag globale Google (gtag.js)
Il modulo può caricare automaticamente lo script gtag.js con l’identificatore di conversione Google Ads, impostando contemporaneamente la valuta e il paese del negozio. Se hai già installato Google Tag Manager o un altro modulo che carica gtag.js, puoi disattivare questa opzione per evitare la duplicazione del tag — gli eventi di remarketing continueranno comunque a essere inviati correttamente.
Compatibilità completa
- PrestaShop 1.7.x – 9.x — un unico modulo per tutte le versioni
- PHP 7.0 – 8.5 — senza Composer, senza dipendenze esterne
- Multistore — ogni negozio può avere il proprio identificatore di conversione Google Ads
- Tutti i temi — Classic, Starter Theme, Hummingbird e temi personalizzati
- Multilingua — pannello di configurazione in lingua polacca e inglese
Perché conviene
- Un clic — integrazione completa — inserisci il Google Conversion ID, salva e il gioco è fatto; tutti gli eventi funzionano automaticamente su ogni pagina del negozio
- Conformità con Google Merchant Center — l’identificatore del prodotto nel tag corrisponde all’identificatore nel feed, rendendo possibili annunci dinamici di prodotto con immagini e prezzi corretti
- Tracciamento delle varianti in tempo reale — il cambio di colore, taglia o altro attributo aggiorna immediatamente i dati nel tag di remarketing, senza ricaricare la pagina
- Prestazioni — nelle pagine listing il modulo utilizza i dati già caricati da PrestaShop; zero query SQL aggiuntive nel flusso standard
- Sicurezza — validazione dei token AJAX, verifica origin/referer, escaping di tutte le variabili nei template, protezione contro CSRF e XSS
- Verifica del proprietario dell’ordine — l’evento purchase si attiva solo per il cliente che ha effettuato l’ordine; non c’è rischio di perdita di dati dell’ordine
- Nessun conflitto — l’opzione di disattivazione del tag globale consente la coesistenza con Google Tag Manager senza duplicazione degli script
- Copertura completa delle pagine — categorie, produttori, fornitori, novità, bestseller, promozioni, ricerca, prodotti, carrello e ordine
Requisiti
- PrestaShop 1.7.0 o successivo (inclusi 8.x e 9.x)
- PHP 7.0 o successivo
- Account Google Ads con remarketing dinamico attivo
- Feed prodotti in Google Merchant Center (per annunci dinamici di prodotto)
Installazione e configurazione
- Installa il modulo tramite il pannello di amministrazione di PrestaShop (Moduli → Carica modulo)
- Vai alla configurazione del modulo
- Incolla il Google Ads Conversion ID (formato:
AW-123456789) - Scegli se il modulo deve caricare il tag globale
gtag.js(disattivalo se hai GTM) - Scegli il formato dell’identificatore prodotto corrispondente al tuo feed in Google Merchant Center
- Salva — il remarketing dinamico funziona immediatamente su tutte le pagine del negozio