Автоматические скидки Google
Автоматические скидки Google
Модуль интегрирует Google Automated Discounts с OpenCart 3.x. Поддерживает правила минимальной цены, XML-фиды, CRON, проверку JWT/ES256, тестовые ссылки и персональные цены в корзине и заказе.
Промокод применится автоматически при добавлении товара в корзину
Введите домен без www, http, https (например: example.com)
Описание
Модуль Google Automated Discounts интегрирует OpenCart с программой автоматических скидок Google Merchant Center. Расширение поддерживает два режима работы: расчёт минимально допустимых цен средствами модуля с передачей их через дополнительный XML-фид или приём готовой персональной цены, рассчитанной Google Merchant Center.
Модуль принимает персональную цену из подписанного параметра pv2, проверяет её и применяет на странице товара, в списках, корзине и при оформлении заказа. Обычная цена и акция товара в базе данных не меняются: персональное предложение сохраняется только для соответствующего посетителя.
Решение подходит магазинам с несколькими витринами, валютами и учётными записями Merchant Center. Для каждой нужной комбинации создаётся отдельный канал с собственным Merchant Center ID, валютой, полем Offer ID и источником ценовых ограничений.
Два режима работы
Для каждого канала можно отдельно выбрать источник ценовых ограничений:
- Настройки модуля — модуль определяет товары, участвующие в программе, рассчитывает минимально допустимые цены и формирует дополнительный XML-фид с атрибутами auto_pricing_min_price и, при наличии закупочной цены, cost_of_goods_sold
- Google Merchant Center — товары, валовая маржа и максимальный размер скидки настраиваются непосредственно в кабинете Google. Дополнительный XML-фид минимальных цен модуля не используется, а персональная цена принимается из подписанного JWT без повторной проверки по локальным правилам и минимальной цене
В обоих режимах модуль проверяет криптографическую подпись, Merchant Center ID, Offer ID, валюту, срок действия данных и соответствие товара. Полученная цена должна быть положительной и ниже текущей цены товара. Различие заключается только в том, где определяются условия участия и допустимая нижняя граница цены.
Режим Google Merchant Center не отменяет основной товарный фид магазина. Google по-прежнему должен получать основные данные товаров и корректные Offer ID через стандартный источник товарных данных.
Как работают автоматические скидки
- Администратор создаёт канал для нужного магазина, Merchant Center и валюты
- Для канала выбирается источник ценовых ограничений: настройки модуля или Google Merchant Center
- В локальном режиме администратор настраивает правила участия и расчёта минимальной цены, после чего CRON формирует дополнительный XML-фид
- В режиме Google Merchant Center товары, маржа и максимальная скидка настраиваются в кабинете Google без использования дополнительного фида модуля
- Google определяет персональную цену и передаёт её покупателю в подписанном JWT через GET-параметр pv2
- Модуль проверяет подпись ES256, Merchant Center ID, Offer ID, товар, валюту, цену и срок действия данных
- В локальном режиме дополнительно проверяется участие товара и соответствие цены рассчитанной нижней границе
- После успешной проверки персональная цена отображается на сайте и переходит в корзину и заказ
Персональная цена сохраняется для страницы товара не менее 30 минут, а для корзины — 48 часов. Она не становится общей ценой товара и не показывается другим покупателям.
Что умеет модуль
- Создавать отдельные каналы для разных магазинов, Merchant Center и валют
- Выбирать источник ценовых ограничений отдельно для каждого канала
- Работать по локальным правилам с дополнительным XML-фидом минимальных цен
- Принимать готовую цену Google без локальной проверки минимальной цены
- Работать без дополнительного XML-фида модуля, если товары, маржа и максимальная скидка настроены в Merchant Center
- Формировать статические XML-фиды в формате Google Merchant Center
- Задавать собственное имя файла каждого XML-фида
- Формировать фид по защищённому секретному ключу CRON
- Выбирать поле OpenCart, которое используется как Offer ID
- Управлять участием товаров через категории, производителей и отдельные товары
- Создавать правила включения и исключения товаров
- Фильтровать товары по текущей цене и наличию действующей акции
- Рассчитывать минимальную цену как максимальную скидку от текущей цены
- Рассчитывать минимальную цену как наценку на закупочную цену
- Задавать индивидуальные настройки непосредственно в карточке товара
- Проверять подписанные персональные цены Google по протоколу ES256
- Применять персональную цену на витрине, в корзине и заказе
- Помечать обычные и тестовые заказы Google в административной части
- Создавать локальные тестовые ссылки для проверки сценария до подключения Merchant Center
- Показывать статистику активных цен и связанных заказов
- Очищать просроченные записи и старую историю
- Вести журнал причин принятия или отклонения персональной цены
- Работать с украинским, английским и русским языками
Каналы и Offer ID
Канал объединяет настройки одного магазина, учётной записи Merchant Center и валюты. Для каждого канала задаются название, магазин, Merchant Center ID, валюта, Offer ID, источник ценовых ограничений, имя XML-файла и статус.
Offer ID можно получать из стандартных полей OpenCart: product_id, model, sku, upc, ean, jan, isbn или mpn.
Значение выбранного поля должно точно совпадать с ID соответствующего предложения в основном товарном источнике Merchant Center. Иначе модуль не примет персональную цену для товара.
Локальные правила ценообразования
Правила используются только тогда, когда источником ценовых ограничений выбраны настройки модуля. В режиме Google Merchant Center локальные правила, закупочная и ручная минимальная цена не ограничивают предложение, полученное из подписанного JWT.
Правила проверяются от меньшего значения порядка сортировки к большему. Для товара используется первое подходящее правило.
- Разрешить или запретить участие — включение или исключение соответствующих товаров
- Категории, производители и товары — область действия правила
- Учёт акции — все товары, только товары с действующей акцией или только без неё
- Цена от и до — необязательные границы текущей цены
- Метод и значение — максимальная скидка от текущей цены или наценка на закупочную цену
Категории, производители и отдельные товары в одном правиле объединяются: достаточно соответствия одному из выбранных списков. Если все списки пусты, правило распространяется на все товары канала.
Методы расчёта минимальной цены
- Максимальная скидка от текущей цены — минимальная цена равна текущей цене минус заданный процент. Закупочная цена не нужна
- Наценка на закупочную цену — минимальная цена равна закупочной цене плюс заданный процент. Для этого метода поле cost должно быть заполнено
Если закупочная цена указана, модуль передаёт её как cost_of_goods_sold и не позволяет установить локальную минимальную цену ниже себестоимости. Если cost равна нулю, атрибут не добавляется в XML.
Настройки в карточке товара
Модификатор добавляет к стандартной форме товара OpenCart закупочную цену, ручную минимальную автоматическую цену и режим участия в автоматических скидках. Эти параметры используются локальным режимом и имеют приоритет над автоматическими правилами.
Отображение поля закупочной цены можно отключить, если магазин уже использует совместимый модуль закупок, который хранит данные в том же поле cost.
Статический XML-фид и CRON
Статический XML-фид используется в режиме локальных ценовых ограничений. Каждый канал формирует отдельный XML-файл в каталоге price. Google получает готовый файл без запуска тяжёлых SQL-запросов при каждом обращении к его URL.
- Один вызов CRON полностью перестраивает выбранный фид
- URL CRON защищён общим секретным ключом
- Для каждого канала отображаются готовый URL и команда для crontab
- В настройках доступны размер, дата изменения и статистика созданного файла
- Товар без cost может передавать Offer ID и auto_pricing_min_price
- Если cost указана, дополнительно передаётся cost_of_goods_sold
Если источником ценовых ограничений выбран Google Merchant Center, подключать сформированный модулем XML-фид не нужно. Условия участия, валовая маржа и максимальная скидка настраиваются в кабинете Google.
Проверка персональной цены
Встроенная вкладка тестирования позволяет создать временную ссылку с тестовой персональной ценой и проверить весь сценарий до получения производственной ссылки Google.
В локальном режиме тестовая цена должна быть ниже текущей и не ниже рассчитанного минимума. В режиме Google Merchant Center локальный минимум не проверяется, но цена должна быть положительной и ниже текущей цены товара.
Для тестирования модуль создаёт отдельную пару ключей ES256 в защищённом каталоге storage. Локальный тест не меняет официальный публичный ключ Google и не заменяет производственную проверку Merchant Center.
Проверка безопасности
- Проверка криптографической подписи ES256
- Проверка Merchant Center ID, Offer ID и соответствующего товара
- Проверка валюты, срока действия и корректности персональной цены
- Проверка соответствия цены текущей цене товара
- Проверка допустимой локальной минимальной цены, если канал работает по правилам модуля
- Привязка локальной тестовой ссылки к IP-адресу
- Журнал причин принятия или отклонения без сохранения самого JWT
Официальный публичный ключ Google ES256 уже заполнен в настройках. Он является общим для интеграций Automated Discounts и не требует создания администратором магазина.
Отображение персональной цены
Персональная цена интегрируется в страницу товара, категории, страницы производителей, поиск, акции, стандартные модули товаров, корзину, стандартное оформление заказа и административную страницу заказа.
Модули быстрого заказа, которые используют стандартные Cart и addOrder OpenCart, получают персональную цену автоматически. Для расширений, которые читают цену или создают заказ прямыми SQL-запросами, может потребоваться отдельная адаптация.
Метка заказа
Если при оформлении использована персональная цена, модуль сохраняет связь с заказом. Администратор видит отдельную метку Google Automated Discounts, а для локальных тестов используется отдельная тестовая метка.
SEO URL и параметр pv2
SEO-модуль, CDN или редирект с index.php на SEO URL не должен удалять GET-параметр pv2. Если магазин использует SeoPro или другой модификатор URL, параметр нужно добавить в список разрешённых. Страницы с персональной ценой нельзя сохранять в общем полностраничном кеше.
Мультимагазинность и валюты
Для каждого канала выбирается конкретный магазин и одна из активных валют OpenCart. Правила не смешиваются между каналами, поэтому можно создавать разные условия для отдельных стран, валют, магазинов или учётных записей Merchant Center.
Производительность
- Статические XML-файлы вместо генерации фида при каждом запросе Google
- Выборка только необходимых данных товаров
- Индексы собственных таблиц для основных операций
- Применение персональных цен к массиву товаров одним пакетным запросом
- Использование стандартных Currency, Tax, Cart, Events и DB API OpenCart
- Отсутствие внешних API-запросов при открытии страниц магазина
Совместимость с шаблонами и сторонними модулями
Основная логика работает на уровне стандартных моделей товаров, корзины, событий и заказа OpenCart. Если тема или сторонний модуль получает цены прямыми SQL-запросами, использует собственную корзину или создаёт заказ в обход стандартного addOrder, может потребоваться точечная адаптация.
Открытый код и независимость
Код модуля не закодирован и не обфусцирован. Расширение не использует лицензионные серверы, телеметрию или удалённые библиотеки. Проверка JWT, расчёт правил, сохранение персональных цен и формирование XML выполняются непосредственно на сайте.
Системные требования
- Учётная запись Google Merchant Center с доступной программой Automated Discounts
- Настроенная передача конверсий покупки с данными корзины
- Для локального режима — возможность записи XML-файлов в каталог price и настройка регулярного CRON
Установка
- Установите архив через Extensions / Installer
- Обновите кеш в Extensions / Modifications
- Установите и откройте Google Automated Discounts в разделе Feeds / Каналы продвижения
- Включите модуль и создайте канал для нужного магазина, Merchant Center и валюты
- Проверьте поле Offer ID и выберите источник ценовых ограничений
- Для локального режима настройте правила, запустите CRON и подключите XML как дополнительный источник данных Merchant Center
- Для режима Google Merchant Center настройте товары, валовую маржу и максимальную скидку непосредственно в кабинете Google
- Проверьте локальную и производственную тестовую ссылку
Модуль не изменяет файлы ядра OpenCart напрямую. Интеграция выполняется через стандартные Events OpenCart и OCMOD.
Важные примечания
Модуль не подключает магазин к программе Google Automated Discounts автоматически. Доступность программы, настройки Merchant Center и окончательное одобрение магазина определяются Google.
Основной источник товарных данных Merchant Center должен содержать товары с корректными Offer ID независимо от выбранного режима. Значение поля Offer ID в модуле должно точно совпадать с идентификатором соответствующего предложения в основном товарном источнике Google.
В режиме локальных настроек XML модуля используется как дополнительный источник атрибутов автоматических скидок. В режиме Google Merchant Center этот дополнительный файл не нужен, поскольку ценовые ограничения настраиваются непосредственно в кабинете Google.
Модуль не заменяет систему аналитики и не отправляет конверсии покупки в Google. Для этого требуется отдельная интеграция Google Analytics, Google Ads или другой совместимый модуль.
Лицензия
Лицензия распространяется на один домен и его поддомены.
Характеристики
- Версия OpenCart
- 3.0.0 3.0.1 3.0.2 3.0.3 3.0.4 3.0.5
- Локализация модуля
- Украинский, Английский, Русский
- Язык поддержки
- Украинский, Английский, Русский
- Метод активации
- Автоматическая активация
- Ioncube Loader
- Нет (не нужен)
- Обращение к серверу разработчика
- Нет
- Если сервер разработчика недоступен
- Дополнение работает
- Версия PHP
- 7.3 7.4 8.0 8.1 8.2 8.3 8.4 8.5
- Совместимо с шаблонами
- Default
Вопросы (0)
Войдите, чтобы задать вопрос.
ВойтиВопросов пока нет
Задайте первый вопрос об этом товаре!
История изменений
- - Исправлена обработка дублирующихся Offer ID и HTML-сущностей.
- - Добавлена пакетная генерация фидов с продолжением после прерывания.
- - Добавлена настройка выгрузки только товаров в наличии.
- - Исправлено копирование параметров ценообразования и очистка данных удалённых товаров.
- - Доработаны права доступа, аннулирование тестовых ссылок и работа отключённого модуля.
- - Обновлены интерфейс и локализации, удалён устаревший и неиспользуемый код.
- - Проверена работа на PHP 7.1–8.5.