Отзывы пользователей
Модуль 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 выполняются непосредственно на сайте.
Системные требования
- OpenCart 3.0.3.x
- PHP OpenSSL с поддержкой ES256
- Аккаунт 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 или другой совместимый модуль.
DEMO
- Admin Page
- login/password: demo/demodemo
Лицензия
Лицензия распространяется на один домен и его поддомены.
Характеристики
-
Сейчас на странице 0 пользователей
- Нет пользователей, просматривающих эту страницу.