Серверный трекинг для Shopware 6
Добавьте интеграцию Shopware с правом чтения заказов, и ROASaurus будет синхронизировать оплаченные заказы через Admin API. Вебхук Flow Builder доставляет их в момент оплаты.
| Shopware: коротко | |
|---|---|
| Заказы поступают через | Опрос Admin API каждые 5 минут; мгновенно через вебхук Flow Builder |
| Учётные данные | Access key ID и secret access key интеграции |
| Оплаченные заказы | Транзакция в состоянии paid |
| ID заказа | Номер заказа Shopware |
| Сниппет страницы благодарности | Шаблон checkout/finish с page.order.orderNumber |
Как подключается Shopware
- Добавьте скрипт ROASaurus в вашу тему (
base.html.twig, блокbase_script_tracking) или через плагин менеджера тегов. - Settings › System › Integrations › Add integration с правом чтения заказов. Введите access key ID и secret access key в ROASaurus.
- Для точного сопоставления добавьте сниппет страницы благодарности в
storefront/page/checkout/finish/index.html.twig.
ROASaurus обменивает ключи интеграции на недолговечный токен Admin API и каждые 5 минут ищет заказы, обновлённые с момента последнего запуска. Заказ считается оплаченным, если одна из его транзакций в состоянии paid. В качестве id используется номер заказа — его же отправляет и сниппет страницы благодарности.
Мгновенные заказы через Flow Builder
В Shopware Evolve и выше создайте flow с триггером State Enter / Order Transaction / State / Paid и действием Call URL (Webhook), POST на URL вебхука ROASaurus. Вызов — лишь сигнал: ROASaurus не доверяет его содержимому и вместо этого запрашивает заказы за последние два часа через аутентифицированный API. Заказы, которые у него уже есть, игнорируются.
Что ROASaurus читает из каждого заказа
Сумму, валюту, дату заказа, email и имя клиента, платёжные телефон, город, индекс и страну, id клиента и товарные позиции с количеством, ценой за единицу и номером товара.
Связь заказов с рекламными кликами
Сниппет страницы благодарности отправляет покупку ROASaurus с номером заказа и суммой, что связывает заказ с посетителем. Без него ROASaurus использует email, который посетитель ранее оставил на вашем сайте, например во всплывающем окне.
Ограничения
- Shopware по умолчанию анонимизирует IP-адрес клиента, поэтому запасной вариант по IP почти не помогает. Добавьте сниппет страницы благодарности.
- Вебхукам Flow Builder нужен Shopware Evolve или выше. Без них заказы поступают с задержкой до 5 минут.
- Коннектор создан по официальной документации API платформы. После сохранения учётных данных нажмите Test connection, затем оформите тестовый заказ и проверьте Event log.
Читайте также
Ответы на вопросы
Нужен ли мне Flow Builder?
Нет. Без него ROASaurus запрашивает оплаченные заказы каждые 5 минут. Вебхук Flow Builder, доступный в Shopware Evolve и выше, лишь ускоряет их поступление.
Безопасен ли вебхук Flow Builder?
ROASaurus воспринимает его только как сигнал. Он никогда не берёт данные заказа из вызова, а запрашивает недавние заказы через Admin API с вашими ключами интеграции.
Какой доступ нужен интеграции?
Право чтения заказов. ROASaurus использует access key ID и secret интеграции, чтобы получить недолговечный токен Admin API.
Каждая продажа прослежена до рекламы, которая её принесла
Серверный трекинг, прибыль и пожизненная ценность клиента в одном приложении. 14 дней бесплатно, без банковской карты.
Начать бесплатный пробный период →