Πίσω στο Portfolio

GTag Manager Advanced

Open-source PrestaShop module (v1.2.0) για Google Consent Mode v2, αυτόματη καταγραφή GA4 Ecommerce Purchase και Google Ads conversions με δίγλωσσο cookie banner.

Κατηγορία
Plug-ins & Modules
Πελάτης
Open Source (PrestaShop Community)
Έτος
2024 - 2026
Διάρκεια
2 Εβδομάδες
Ρόλος
Σχεδιασμός και ανάπτυξη
GTag Manager Advanced

Η πρόκληση

Η απαίτηση της Google για υποχρεωτική εφαρμογή του Google Consent Mode v2 έθεσε σε κίνδυνο τη λειτουργία των διαφημιστικών καμπανιών και την αξιοπιστία των αναλύσεων σε χιλιάδες ηλεκτρονικά καταστήματα. Πολλά e-shops είτε έχαναν κρίσιμα δεδομένα remarketing και conversions στο Google Ads, είτε αναγκάζονταν να πληρώνουν ακριβές μηνιαίες συνδρομές σε εξωτερικές πλατφόρμες διαχείρισης συγκατάθεσης (CMPs).

Παράλληλα, πολλά διαθέσιμα modules παρουσίαζαν προβλήματα διπλοκαταγραφής (duplicate purchases) σε ανανεώσεις σελίδας και αδυνατούσαν να συνδέσουν σωστά την πραγματική αξία παραγγελίας με τα Google Ads conversion labels.

Τι φτιάχτηκε

Το GTag Manager Advanced είναι ένα εξειδικευμένο open-source module για το PrestaShop (συμβατό με τις εκδόσεις 1.7 και 8), σχεδιασμένο από το μηδέν από την DamiansLab για πλήρη τεχνική συμμόρφωση με το Google Consent Mode v2, αυτόματη καταγραφή GA4 Ecommerce Purchase και αξιόπιστο Google Ads Conversion Tracking.

Απαλλάσσει τους ιδιοκτήτες e-commerce από πολύπλοκες ρυθμίσεις στο Google Tag Manager ή ακριβές εξωτερικές συνδρομές, παρέχοντας εγγενή δίγλωσση διαχείριση συγκατάθεσης και αδιάλειπτη διαβίβαση των εμπορικών δεδομένων απευθείας από τον πυρήνα του PrestaShop.

Οθόνη διαμόρφωσης ρυθμίσεων GTag Manager Advanced στο PrestaShop back office

Τι περιλαμβάνει το module

1. Πλήρης Υποστήριξη Google Consent Mode v2 (Advanced Mode)

  • Αρχικοποίηση Default Denied: Όλα τα ad and analytics tags φορτώνονται με κατάσταση denied (ad_storage, ad_user_data, ad_personalization, analytics_storage), προστατεύοντας πλήρως το απόρρητο πριν τη συγκατάθεση.
  • Cookieless Pings: Επιτρέπει στη Google να συλλέγει ανώνυμα cookieless signals για μοντελοποίηση μετατροπών (conversion modeling).
  • Άμεση Ενημέρωση (Dynamic Update): Μόλις ο χρήστης αποδεχτεί τα cookies, εκτελείται ακαριαία η συνάρτηση gtag('consent', 'update') χωρίς να απαιτείται επαναφόρτωση της σελίδας.

2. Δίγλωσσο Cookie Consent Banner (Ελληνικά & Αγγλικά)

  • Αυτόματη Ανίχνευση Γλώσσας: Εντοπίζει τη γλώσσα του επισκέπτη μέσω του document.documentElement.lang και εμφανίζει το αντίστοιχο κείμενο.
  • Πλήρης Παραμετροποίηση από το Admin: Επεξεργασία των μηνυμάτων συγκατάθεσης απευθείας μέσα από τη φόρμα ρυθμίσεων του PrestaShop Back Office.
  • Αποθήκευση Επιλογής στο LocalStorage: Διατηρεί τη συγκατάθεση του χρήστη (key: gtagAdvancedConsent) ώστε το banner να μην ενοχλεί σε επόμενες επισκέψεις.

3. GA4 Ecommerce Purchase & Google Ads Conversion Tracking

  • Αναλυτικά Στοιχεία Καλαθιού: Μεταβίβαση πλήρους πίνακα items (κωδικός αναφοράς, ονομασία, τιμή με ΦΠΑ, ποσότητα) στο hook επιβεβαίωσης παραγγελίας (displayOrderConfirmation).
  • Deduplication μέσω Order Reference: Χρήση του order.reference ως transaction_id ώστε να αποτρέπονται διπλά συμβάντα σε refresh της σελίδας.
  • Δυναμική Αξία Μετατροπής: Υπολογισμός πραγματικού καθαρού τζίρου, ΦΠΑ και μεταφορικών για ακριβή μέτρηση ROAS στο Google Ads.

Οι οθόνες του module σε περιβάλλον διαχείρισης και καταστήματος

Στιγμιότυπα από περιβάλλον δοκιμών (demo store) με εικονικά δεδομένα παραγγελιών.

Περιβάλλον διαχείρισης PrestaShop & Επιθεώρηση κώδικα

Οθόνη διαμόρφωσης ρυθμίσεων GTag Manager Advanced στο PrestaShop back officeΛίστα εγκατεστημένων προσθέτων PrestaShop με το GTag Manager Advanced ενεργόΈλεγχος DataLayer και Google Consent Mode v2 στην κονσόλα προγραμματιστήΕπαλήθευση συμβάντων στο Google Analytics 4 DebugView

Περιβάλλον καταστήματος, Cookie Banner & Ολοκλήρωση παραγγελίας

Εμφάνιση cookie consent banner στα ελληνικά στο footer ηλεκτρονικού καταστήματοςΕμφάνιση cookie consent banner στα αγγλικά για διεθνείς επισκέπτεςΣελίδα επιβεβαίωσης παραγγελίας με καταγραφή GA4 purchase eventΕπαλήθευση καταγραφής μετατροπής Google Ads conversion με δυναμική αξία

Περιβάλλον mobile

Προβολή cookie consent banner σε κινητό τηλέφωνοΕπιβεβαίωση παραγγελίας και αποστολή μετατροπής σε mobile περιβάλλον

Στο παρασκήνιο

  • Hook Architecture: Εγγραφή στα καίρια σημεία εισαγωγής του PrestaShop (displayHeader για το gtag.js setup, displayFooter για το banner, και displayOrderConfirmation για το ecommerce tracking).
  • Ασφάλεια εκτέλεσης Hooks: Ενσωμάτωση μηχανισμού static $done = true για την αποτροπή πολλαπλών εκτελέσεων σε custom themes που καλούν το ίδιο hook επανειλημμένα.
  • Smarty JSON Encoding: Χρήση της παραμέτρου nofilter στα templates για την ακέραια απόδοση δομημένων αντικειμένων JSON (JSON_UNESCAPED_UNICODE) χωρίς σφάλματα escaping.
  • Αυτόματο Script Αναβάθμισης: Περιλαμβάνει το upgrade-1.2.0.php για ομαλή μετάβαση από παλαιότερες εκδόσεις με αυτόματη δήλωση των νέων παραμέτρων ρύθμισης.
  • Πλήρης Open-Source Διαθεσιμότητα: Δημόσιο αποθετήριο στο GitHub, έτοιμο για εγκατάσταση σε οποιοδήποτε σύγχρονο PrestaShop store.

Η λύση

Αναπτύχθηκε ένα αυτόνομο PrestaShop module (PHP 7.4 - 8.x & Smarty) που ενσωματώνει εγγενώς το Google Consent Mode v2, ορίζοντας αρχικά όλα τα ad και analytics tags σε κατάσταση denied και ενημερώνοντάς τα δυναμικά σε granted μόλις δοθεί συγκατάθεση.

Παράλληλα, υλοποιήθηκε hook στο displayOrderConfirmation που μεταδίδει ολοκληρωμένα e-commerce payloads με πραγματικές τιμές, ΦΠΑ, έξοδα αποστολής και το order reference ως μοναδικό κλειδί deduplication, σε συνδυασμό με παραμετροποιήσιμο Google Ads conversion tracking.

Το αποτέλεσμα

Το module προσφέρει άμεση και πλήρη συμμόρφωση με τις απαιτήσεις του Google Consent Mode v2 και του GDPR χωρίς καμία εξάρτηση από μηνιαίες συνδρομές σε εξωτερικές πλατφόρμες διαχείρισης συγκατάθεσης.

Η ακρίβεια των μετρήσεων στο Google Analytics 4 και στο Google Ads βελτιστοποιήθηκε θεαματικά, εξαλείφοντας πλήρως τις διπλοκαταγραφές πωλήσεων και παρέχοντας αξιόπιστα δεδομένα ROAS για τη βελτιστοποίηση των διαφημιστικών εκστρατειών.

Γκαλερί