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

Серверный трекинг для любого сайта

Добавьте на сайт один тег скрипта и отправляйте оплаченные заказы в формате JSON из своего бэкенда или no-code инструмента. ROASaurus сопоставляет каждый заказ с кликом по рекламе и передаёт его в ваши рекламные платформы.

Собственный сайт: коротко
СкриптОдин тег скрипта на каждой странице: просмотры страниц, click id, cookie посетителя _tl
Orders APIPOST /api/v1/orders с ключом магазина и API keyом
JSON-вебхукPOST на URL вашего вебхука из бэкенда, Zapier, Make или n8n
Офлайн-событияPOST /api/v1/events для лидов, демо и повторных списаний
Сопоставление заказовvisitor_id (cookie _tl), событие страницы благодарности, email, который посетитель оставил ранее, или IP и браузер

1. Добавьте скрипт

Вставьте тег скрипта со страницы Tracking & platforms на каждую страницу, обычно в разделе «custom code», «code injection» или «header scripts». Скрипт записывает просмотры страниц, фиксирует click id из рекламы и UTM и устанавливает cookie посетителя _tl. Другие события отправляйте через tlq('track', 'AddToCart', {...}).

2. Отправьте оплаченные заказы

Orders API. Создайте API key в Settings › Orders API и отправляйте каждый оплаченный заказ методом POST на /api/v1/orders. Формат запроса показан на этой странице. Передавайте cookie _tl как visitor_id, чтобы заказ сопоставился с кликом по рекламе.

JSON-вебхук. Выберите «Other / custom webhook» при добавлении магазина и отправляйте заказы методом POST на URL вашего вебхука. Поля: order_id, total, currency, email, phone, first_name, last_name, country, zip, client_ip, user_agent, items (variant_id, quantity, price) и, если можете, visitor_id. Также можно передавать click_ids, landing_url и is_first_order, а тестовые заказы помечать "test": true, чтобы они сохранялись, но не отправлялись.

3. Отправьте событие страницы благодарности

На странице подтверждения вызовите tlq('track', 'Purchase', ...), указав в event_id значение order- плюс id вашего заказа. Это связывает заказ с посетителем, даже если вы не можете передать cookie. Когда ваш сервер отправляет заказы, покупки из браузера только связывают посетителей и больше не создают заказы.

Лиды и подписки

API офлайн-событий (POST /api/v1/events) принимает лиды, демо, MQL и повторные списания по подпискам, сопоставляя их с посетителем по хешированному email. Он принимает до 1 000 событий в минуту на магазин, до 3 КБ каждое.

Воронки и first-party cookie

Укажите домены воронок и магазина в Settings › Linked domains, и ссылки между ними будут передавать visitor id и click id. Если отдавать скрипт со своего поддомена (CNAME), сбор данных остаётся на вашем домене, а _tl выдаётся заново как HTTP cookie. Safari всё равно может ограничивать срок жизни этого cookie 7 днями.

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

FAQ

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

Нужен ли мне разработчик?

Не всегда. Zapier, Make или n8n могут отправлять оплаченные заказы из вашего магазина или платёжного инструмента на URL вебхука ROASaurus. Для передачи visitor id из cookie _tl обычно нужна небольшая правка на вашем сайте.

Как отправлять тестовые заказы?

Добавьте в заказ "test": true. ROASaurus сохраняет его, чтобы вы могли проверить формат, но ничего не отправляет в рекламные платформы.

Что, если у моего сайта вообще нет бэкенда?

Отправьте покупку из браузера на странице подтверждения. Если у магазина нет серверного источника заказов, это событие создаёт заказ и передаётся в рекламные платформы. Серверный источник надёжнее.

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

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

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