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

Проследяване от страна на сървъра за всеки уебсайт

Добавете един таг на скрипт към сайта си и изпращайте платените поръчки като JSON от вашия бекенд или от no-code инструмент. ROASaurus съпоставя всяка поръчка с клика върху нейната реклама и я препраща към вашите рекламни платформи.

Персонализиран уебсайт накратко
СкриптЕдин таг на скрипт на всяка страница: прегледи на страници, click ID-та, бисквитката на посетителя _tl
Orders APIPOST /api/v1/orders с ключ на магазина и API ключ
JSON webhookPOST към вашия webhook URL от вашия бекенд, Zapier, Make или n8n
Офлайн събитияPOST /api/v1/events за лийдове, демонстрации и повторни таксувания
Съпоставяне на поръчкитеvisitor_id (бисквитката _tl), събитие от страницата за благодарност, имейл, въведен по-рано, или IP и браузър

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

Поставете тага на скрипта от страницата Tracking & platforms на всяка страница, обикновено в „custom code“, „code injection“ или „header scripts“. Той записва прегледите на страници, улавя click ID-тата от рекламите и UTM параметрите и задава бисквитката на посетителя _tl. Други събития изпращайте с tlq('track', 'AddToCart', {...}).

2. Изпращайте платените поръчки

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

JSON webhook. Изберете „Other / custom webhook“, когато добавяте магазина, и изпращайте с POST поръчките към вашия webhook 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 на вашата поръчка. Това свързва поръчката с посетителя, дори когато не можете да подадете бисквитката. След като сървърът ви започне да изпраща поръчки, покупките от браузъра само свързват посетители; те вече не създават поръчки.

Лийдове и абонаменти

API-то за офлайн събития (POST /api/v1/events) приема лийдове, демонстрации, MQL и повторни таксувания на абонаменти, съпоставени с посетител по хеширан имейл. Приема до 1 000 събития в минута на магазин, по 3 KB всяко.

Фунии и first-party бисквитки

Посочете домейните на вашата фуния и на магазина в Settings › Linked domains и връзките между тях ще пренасят ID на посетителя и click ID-тата. Ако предоставяте скрипта от свой собствен поддомейн (CNAME), събирането на данни остава във вашия домейн и _tl се издава наново като HTTP бисквитка. Safari все пак може да ограничи тази бисквитка до 7 дни.

Свързани

ЧЗВ

Въпроси и отговори

Трябва ли ми разработчик?

Не винаги. Zapier, Make или n8n могат да изпращат платените поръчки от вашия магазин или платежен инструмент към webhook URL на ROASaurus. Подаването на ID на посетителя от бисквитката _tl обикновено изисква малка промяна на сайта ви.

Как да изпращам тестови поръчки?

Добавете "test": true към поръчката. ROASaurus я съхранява, за да можете да проверите формата, но не изпраща нищо към рекламните платформи.

Какво да правя, ако сайтът ми изобщо няма бекенд?

Задействайте покупката от браузъра на страницата за потвърждение. Когато магазинът няма източник на поръчки от страна на сървъра, това събитие създава поръчката и се препраща към рекламните платформи. Източникът от сървъра е по-надежден.

Всяка продажба, проследена до рекламата, която я е донесла

Проследяване от страна на сървъра, печалба и пожизнена стойност на клиента в едно приложение. 14-дневен безплатен пробен период, без кредитна карта.

Започнете безплатния си пробен период →