Серверный трекинг для магазинов на Ecwid
ROASaurus читает оплаченные заказы Ecwid через токен custom app и отправляет их в ваши рекламные платформы с сервера. Попросите поддержку Ecwid включить вебхуки, и заказы будут поступать мгновенно.
| Ecwid: коротко | |
|---|---|
| Заказы поступают через | Опрос API каждые 5 минут; вебхуки после того, как их включит поддержка Ecwid |
| Учётные данные | Store ID, секретный токен custom app и его client secret для вебхуков |
| Проверка вебхука | Подпись HMAC с client secret |
| Оплаченные заказы | Статус оплаты PAID |
| Сниппет страницы благодарности | Ecwid.OnOrderPlaced, после скрипта отслеживания |
Как подключается Ecwid
- Добавьте скрипт ROASaurus на сайт, в который встроен ваш магазин Ecwid, или в пользовательский код вашего Instant Site.
- Добавьте после него сниппет страницы благодарности. Он слушает событие Ecwid
OnOrderPlacedи отправляет покупку ROASaurus с номером заказа, суммой и email. - На my.ecwid.com/#develop-apps создайте custom app с правом чтения заказов. Введите в ROASaurus ваш store ID (он указан в URL админки и в разделе Account › Summary) и токен приложения
secret_….
После этого ROASaurus каждые 5 минут запрашивает заказы, обновлённые с момента последнего запуска, и отправляет те, у которых статус оплаты PAID.
Мгновенные заказы через вебхуки
URL вебхуков для custom apps в Ecwid настраивает команда поддержки API. Попросите их указать в качестве URL вебхука вашего приложения адрес со вкладки Connection в ROASaurus и выбрать события order.created и order.updated. Вставьте client secret приложения в ROASaurus: каждый вебхук проверяется по подписи HMAC, после чего заказ запрашивается из API.
Что ROASaurus читает из каждого заказа
Сумму, валюту, email, платёжные имя, телефон и адрес, id клиента и товары с их комбинацией, количеством, ценой и SKU. В заказах Ecwid есть IP-адрес и user agent покупателя, поэтому ROASaurus может также сопоставлять по тому же IP и браузеру, но только если подходит ровно один посетитель.
Ограничения
- Для вебхуков нужно обратиться в поддержку Ecwid. До этого заказы поступают с задержкой до 5 минут.
- Ecwid передаёт имя одним полем, которое ROASaurus делит на имя и фамилию.
- Коннектор создан по официальной документации API платформы. После сохранения учётных данных нажмите Test connection, затем оформите тестовый заказ и проверьте Event log.
Читайте также
Ответы на вопросы
Почему для вебхуков нужно обращаться в Ecwid?
Ecwid настраивает URL вебхука для custom app через поддержку API. Опрос раз в 5 минут работает и без них.
Для чего нужен client secret?
Он подтверждает, что вебхук действительно пришёл от Ecwid. ROASaurus проверяет с его помощью подпись HMAC каждого вебхука, прежде чем запросить заказ.
Работает ли это, если Ecwid встроен в другой сайт?
Да. Добавьте скрипт ROASaurus и сниппет страницы благодарности на сайт, в который встроен ваш магазин Ecwid.
Каждая продажа прослежена до рекламы, которая её принесла
Серверный трекинг, прибыль и пожизненная ценность клиента в одном приложении. 14 дней бесплатно, без банковской карты.
Начать бесплатный пробный период →