Integracja ze sklepem internetowym

Server-side tracking dla dowolnej witryny

Dodaj do witryny jeden znacznik skryptu i wysyłaj opłacone zamówienia jako JSON z backendu lub narzędzia no-code. ROASaurus dopasowuje każde zamówienie do kliknięcia w reklamę i przekazuje je do twoich platform reklamowych.

Własna witryna w skrócie
SkryptJeden znacznik skryptu na każdej stronie: wyświetlenia stron, click id, cookie odwiedzającego _tl
Orders APIPOST /api/v1/orders z kluczem sklepu i kluczem API
Webhook JSONPOST na adres URL twojego webhooka z backendu, Zapier, Make lub n8n
Zdarzenia offlinePOST /api/v1/events dla leadów, dem i ponownych obciążeń
Dopasowanie zamówieńvisitor_id (cookie _tl), zdarzenie na stronie z podziękowaniem, e-mail podany wcześniej przez odwiedzającego albo IP i przeglądarka

1. Dodaj skrypt

Wklej znacznik skryptu ze strony Tracking & platforms na każdej stronie, zwykle w sekcji „custom code”, „code injection” lub „header scripts”. Zapisuje wyświetlenia stron, przechwytuje click id reklam i UTM oraz ustawia cookie odwiedzającego _tl. Inne zdarzenia wysyłaj przez tlq('track', 'AddToCart', {...}).

2. Wysyłaj opłacone zamówienia

Orders API. Utwórz klucz API w Settings › Orders API i wysyłaj każde opłacone zamówienie metodą POST na /api/v1/orders. Format żądania jest pokazany na tej stronie. Przekaż cookie _tl jako visitor_id, aby zamówienie zostało dopasowane do kliknięcia w reklamę.

Webhook JSON. Wybierz „Other / custom webhook”, gdy dodajesz sklep, i wysyłaj zamówienia metodą POST na adres URL swojego webhooka. Pola: order_id, total, currency, email, phone, first_name, last_name, country, zip, client_ip, user_agent, items (variant_id, quantity, price) oraz, jeśli możesz, visitor_id. Możesz też przekazać click_ids, landing_url i is_first_order oraz oznaczać zamówienia testowe przez "test": true, aby były zapisywane, ale nie wysyłane.

3. Uruchom zdarzenie na stronie z podziękowaniem

Na stronie potwierdzenia uruchom tlq('track', 'Purchase', ...), ustawiając event_id na order- plus id zamówienia. To łączy zamówienie z odwiedzającym, nawet gdy nie możesz przekazać cookie. Gdy twój serwer zacznie wysyłać zamówienia, zakupy z przeglądarki tylko łączą odwiedzających; nie tworzą już zamówień.

Leady i subskrypcje

Offline events API (POST /api/v1/events) przyjmuje leady, dema, MQL i ponowne obciążenia subskrypcji, dopasowane do odwiedzającego po zahashowanym e-mailu. Przyjmuje do 1000 zdarzeń na minutę na sklep, po 3 KB każde.

Lejki i cookie first-party

Wpisz domeny swoich lejków i sklepu w Settings › Linked domains, a linki między nimi będą przenosić visitor id i click id. Udostępnianie skryptu z własnej subdomeny (CNAME) utrzymuje zbieranie danych na twojej domenie i wystawia _tl ponownie jako cookie HTTP. Safari nadal może ograniczyć to cookie do 7 dni.

Powiązane

FAQ

Pytania i odpowiedzi

Czy potrzebuję programisty?

Nie zawsze. Zapier, Make lub n8n mogą wysyłać opłacone zamówienia z twojego sklepu lub narzędzia płatniczego na adres URL webhooka ROASaurus. Przekazanie visitor id z cookie _tl zwykle wymaga niewielkiej zmiany w twojej witrynie.

Jak wysyłać zamówienia testowe?

Dodaj do zamówienia "test": true. ROASaurus zapisuje je, żeby można było sprawdzić format, ale nic nie wysyła do platform reklamowych.

Co jeśli moja witryna w ogóle nie ma backendu?

Uruchom zakup z przeglądarki na stronie potwierdzenia. Gdy sklep nie ma serwerowego źródła zamówień, to zdarzenie tworzy zamówienie i jest przekazywane do platform reklamowych. Źródło serwerowe jest bardziej niezawodne.

Każda sprzedaż przypisana do reklamy, która ją przyniosła

Server-side tracking, zysk i wartość życiowa klienta w jednej aplikacji. 14-dniowy darmowy okres próbny, bez karty kredytowej.

Zacznij darmowy okres próbny →