Интеграция с интернет-магазином

Серверный трекинг для Magento 2 и Adobe Commerce

Создайте интеграцию Magento с доступом к заказам, и ROASaurus будет каждые 5 минут запрашивать оплаченные заказы через REST API, а затем отправлять их в ваши рекламные платформы с сервера.

Magento: коротко
Заказы поступают черезОпрос REST API каждые 5 минут
Учётные данныеIntegration access token; consumer key, consumer secret и access token secret, если использование bearer-токена отключено
Доступ к ресурсамSales › Operations › Orders
Оплаченные заказыСостояние processing или complete
ID заказаIncrement id, который видят клиенты

Как подключается Magento

  1. Content › Design › Configuration › your store view › HTML Head › Scripts and Style Sheets: добавьте тег скрипта ROASaurus.
  2. System › Extensions › Integrations › Add New Integration с доступом к ресурсу Sales › Operations › Orders. Активируйте интеграцию и скопируйте access token.
  3. Введите токен в ROASaurus. Указывайте URL магазина, только если API работает по другому адресу, чем домен вашего магазина.

Bearer-токен или OAuth 1.0a

Начиная с Magento 2.4.4 параметр «Allow OAuth Access Tokens to be used as standalone Bearer tokens» по умолчанию выключен. Если он выключен в вашем магазине, введите также consumer key, consumer secret и access token secret из той же интеграции. Тогда ROASaurus подписывает каждый запрос по OAuth 1.0a вместо отправки bearer-токена.

Как читаются заказы

В Magento Open Source нет вебхуков заказов, поэтому ROASaurus каждые 5 минут запрашивает через REST API заказы, обновлённые с момента последнего запуска, с перекрытием в 30 минут. Заказы в состоянии processing или complete считаются оплаченными. В качестве id заказа используется increment id. Конфигурируемые товары встречаются в данных заказа Magento дважды — как родительский и дочерний; ROASaurus оставляет родительские позиции, чтобы количество не удваивалось.

Из каждого заказа он читает итоговую сумму, валюту, email и имя клиента, платёжные телефон и адрес с кодом региона, id клиента и IP-адрес клиента.

Связь заказов с рекламными кликами

Для точного сопоставления попросите разработчика запускать сниппет покупки ROASaurus на checkout/onepage/success с increment id заказа и итоговой суммой. Без него ROASaurus использует email, который посетитель ранее оставил на вашем сайте, например во всплывающем окне, затем IP-адрес, если подходит только один посетитель.

Ограничения

  • Без вебхуков заказы попадают в рекламные платформы с задержкой до 5 минут после оплаты. «Fetch orders now» запускает синхронизацию по требованию.
  • Для сниппета страницы успешного заказа нужен небольшой собственный модуль, который добавляет ваш разработчик.
  • Коннектор создан по официальной документации API платформы. После сохранения учётных данных нажмите Test connection, затем оформите тестовый заказ и проверьте Event log.

Читайте также

FAQ

Ответы на вопросы

Почему заказы Magento запрашиваются каждые 5 минут?

В Magento Open Source нет вебхуков заказов. Вместо этого ROASaurus каждые 5 минут опрашивает REST API с перекрытием, чтобы не пропустить ни один заказ, и игнорирует заказы, которые у него уже есть.

Мой токен отклоняется. Что проверить?

Начиная с 2.4.4 отдельные bearer-токены по умолчанию выключены. Введите также consumer key, consumer secret и access token secret, и ROASaurus будет подписывать запросы по OAuth 1.0a.

Работает ли это с Adobe Commerce?

Коннектор использует REST API и интеграции Magento 2, общие для Magento Open Source и Adobe Commerce.

Каждая продажа прослежена до рекламы, которая её принесла

Серверный трекинг, прибыль и пожизненная ценность клиента в одном приложении. 14 дней бесплатно, без банковской карты.

Начать бесплатный пробный период →