Автоматичне відстеження подій e-commerce
Модуль підтримує повний набір подій, необхідних для Google Dynamic Remarketing у моделі retail. Кожна подія передає ідентифікатор товару (items[].id), сумісний із фідом Google Merchant Center, а також параметр google_business_vertical: 'retail', що дозволяє Google точно зіставляти рекламу з товарами з вашого каталогу.
| Подія Google | Коли спрацьовує | Дані в події |
|---|---|---|
| view_item | Сторінка товару + зміна варіанта (AJAX) | ID товару, ціна, business vertical |
| view_item_list | Категорія, новинки, бестселери, акції, виробник, постачальник | Список ID товарів, загальна сума значень |
| view_search_results | Результати пошуку | Список ID товарів, загальна сума значень |
| add_to_cart | Додавання товару до кошика (AJAX, без перезавантаження) | ID товару з вибраним варіантом, ціна |
| purchase | Підтвердження замовлення | Список ID товарів, вартість замовлення, валюта |
Налаштовуваний ідентифікатор товару
Ключовою вимогою Google є відповідність ідентифікатора товару в тегу ремаркетингу ідентифікатору у фіді Google Merchant Center. Модуль дозволяє вибрати формат ідентифікатора з 5 варіантів:
- ID товару — стандартний
id_productз бази даних PrestaShop - ID товару - ID атрибута — формат
id_product-id_product_attribute(дефіс) - ID товару _ ID атрибута — формат
id_product_id_product_attribute(підкреслення) - Reference — артикул / каталожний номер товару
- EAN-13 — європейський штрихкод
Для товарів із комбінаціями (варіантами) модуль автоматично отримує ідентифікатори, специфічні для вибраної комбінації — якщо варіант має власний EAN або reference, саме цей ідентифікатор буде передано до Google, а не ідентифікатор основного товару.
Підтримувані сторінки списків
Модуль відстежує подію view_item_list на всіх сторінках зі списками товарів у PrestaShop:
- Сторінки категорій
- Сторінки виробника
- Сторінки постачальника
- Новинки
- Бестселери
- Акції (зниження цін)
На кожній із цих сторінок модуль спочатку намагається отримати список товарів із даних, уже завантажених PrestaShop (змінні Smarty), що усуває додаткові SQL-запити. Якщо дані недоступні (наприклад, нестандартна тема), модуль автоматично перемикається на прямий запит до бази даних як fallback.
Інтелектуальне відстеження варіантів і кошика
На сторінці товару, коли клієнт змінює варіант (колір, розмір), модуль надсилає асинхронний AJAX-запит до сервера, отримує ідентифікатор і ціну конкретної комбінації, а потім негайно надсилає оновлену подію view_item до Google — без перезавантаження сторінки. Аналогічно, додавання товару до кошика генерує подію add_to_cart з правильним ідентифікатором варіанта.
Глобальний тег Google (gtag.js)
Модуль може автоматично завантажити скрипт gtag.js з ідентифікатором конверсії Google Ads, одночасно встановлюючи валюту та країну магазину. Якщо у вас уже встановлено Google Tag Manager або інший модуль, що завантажує gtag.js, ви можете вимкнути цю опцію, щоб уникнути дублювання тегу — події ремаркетингу й надалі надсилатимуться коректно.
Повна сумісність
- PrestaShop 1.7.x – 9.x — один модуль для всіх версій
- PHP 7.0 – 8.5 — без Composer, без зовнішніх залежностей
- Multistore — кожен магазин може мати власний ідентифікатор конверсії Google Ads
- Усі теми — Classic, Starter Theme, Hummingbird і нестандартні теми
- Багатомовність — панель конфігурації польською та англійською мовами
Чому варто
- Один клік — повна інтеграція — вкажіть Google Conversion ID, збережіть, і готово; усі події працюють автоматично на кожній сторінці магазину
- Сумісність із Google Merchant Center — ідентифікатор товару в тегу відповідає ідентифікатору у фіді, що дає змогу показувати динамічну товарну рекламу з правильними зображеннями та цінами
- Відстеження варіантів у реальному часі — зміна кольору, розміру або іншого атрибута миттєво оновлює дані в тегу ремаркетингу, без перезавантаження сторінки
- Продуктивність — на сторінках списків модуль використовує дані, уже завантажені PrestaShop; жодних додаткових SQL-запитів у стандартному flow
- Безпека — валідація AJAX-токенів, перевірка origin/referer, екранування всіх змінних у шаблонах, захист від CSRF і XSS
- Перевірка власника замовлення — подія purchase спрацьовує лише для клієнта, який оформив замовлення; немає ризику витоку даних замовлення
- Відсутність конфліктів — опція вимкнення глобального тегу дозволяє співіснувати з Google Tag Manager без дублювання скриптів
- Повне покриття сторінок — категорії, виробники, постачальники, новинки, бестселери, акції, пошук, товари, кошик і замовлення
Вимоги
- PrestaShop 1.7.0 або новіша версія (включно з 8.x і 9.x)
- PHP 7.0 або новіша версія
- Обліковий запис Google Ads з активним динамічним ремаркетингом
- Фід товарів у Google Merchant Center (для динамічної товарної реклами)
Встановлення та налаштування
- Встановіть модуль через панель адміністрування PrestaShop (Модулі → Завантажити модуль)
- Перейдіть до налаштувань модуля
- Вставте Google Ads Conversion ID (формат:
AW-123456789) - Виберіть, чи має модуль завантажувати глобальний тег
gtag.js(вимкніть, якщо у вас є GTM) - Виберіть формат ідентифікатора товару, що відповідає вашому фіду в Google Merchant Center
- Збережіть — динамічний ремаркетинг почне працювати негайно на всіх сторінках магазину