Integrace e-shopu

Server-side tracking pro jakýkoli web

Přidejte na svůj web jednu značku skriptu a odesílejte zaplacené objednávky jako JSON ze svého backendu nebo z no-code nástroje. ROASaurus spáruje každou objednávku s kliknutím na reklamu a přepošle ji na vaše reklamní platformy.

Vlastní web ve zkratce
SkriptJedna značka skriptu na každé stránce: zobrazení stránek, ID kliknutí, cookie návštěvníka _tl
Orders APIPOST /api/v1/orders s klíčem obchodu a klíčem API
Webhook s JSONPOST na vaši URL webhooku z vašeho backendu, Zapier, Make nebo n8n
Offline událostiPOST /api/v1/events pro leady, demo a opakované platby
Párování objednávekvisitor_id (cookie _tl), událost na poděkovací stránce, e-mail, který návštěvník zadal dříve, nebo IP adresa a prohlížeč

1. Přidejte skript

Vložte značku skriptu ze stránky Tracking & platforms na každou stránku, obvykle v části „custom code“, „code injection“ nebo „header scripts“. Zaznamenává zobrazení stránek, zachytává ID kliknutí z reklam a UTM a nastavuje cookie návštěvníka _tl. Další události odesílejte pomocí tlq('track', 'AddToCart', {...}).

2. Odesílejte zaplacené objednávky

API pro objednávky. Vytvořte klíč API v části Settings › Orders API a odesílejte každou zaplacenou objednávku metodou POST na /api/v1/orders. Formát požadavku je zobrazen na této stránce. Cookie _tl předejte jako visitor_id, aby se objednávka spárovala s kliknutím na reklamu.

Webhook s JSON. Při přidávání obchodu zvolte „Other / custom webhook“ a odesílejte objednávky metodou POST na svou URL webhooku. Pole: order_id, total, currency, email, phone, first_name, last_name, country, zip, client_ip, user_agent, items (variant_id, quantity, price) a pokud můžete, visitor_id. Můžete předat také click_ids, landing_url a is_first_order a testovací objednávky označit pomocí "test": true, takže se uloží, ale neodešlou.

3. Odešlete událost na poděkovací stránce

Na potvrzovací stránce odešlete tlq('track', 'Purchase', ...) s event_id nastaveným na order- plus ID vaší objednávky. Tím se objednávka propojí s návštěvníkem, i když nemůžete předat cookie. Jakmile váš server začne odesílat objednávky, nákupy z prohlížeče už jen propojují návštěvníky; objednávky už nevytvářejí.

Leady a předplatná

API pro offline události (POST /api/v1/events) přijímá leady, demo, MQL a opakované platby předplatného, které páruje s návštěvníkem podle hashovaného e-mailu. Přijímá až 1 000 událostí za minutu na obchod, každou do 3 KB.

Funnely a first-party cookies

Uveďte domény svého funnelu a obchodu v části Settings › Linked domains a odkazy mezi nimi ponesou ID návštěvníka a ID kliknutí. Pokud skript načítáte z vlastní subdomény (CNAME), sběr zůstane na vaší doméně a cookie _tl se vydá znovu jako HTTP cookie. Safari může tuto cookie stále omezit na 7 dní.

Související

Časté dotazy

Otázky a odpovědi

Potřebuji vývojáře?

Ne vždy. Zapier, Make nebo n8n mohou odesílat zaplacené objednávky z vašeho e-shopu nebo platebního nástroje na URL webhooku ROASaurus. Předání ID návštěvníka z cookie _tl obvykle vyžaduje drobnou úpravu vašeho webu.

Jak odešlu testovací objednávky?

Přidejte k objednávce "test": true. ROASaurus ji uloží, abyste mohli zkontrolovat formát, ale reklamním platformám nic neodešle.

Co když můj web nemá vůbec žádný backend?

Odešlete nákup z prohlížeče na potvrzovací stránce. Pokud obchod nemá serverový zdroj objednávek, tato událost objednávku vytvoří a přepošle se reklamním platformám. Serverový zdroj je spolehlivější.

Každý prodej dohledaný k reklamě, která ho přinesla

Server-side tracking, zisk a celoživotní hodnota zákazníka v jedné aplikaci. 14denní zkušební verze zdarma, bez platební karty.

Začněte svou zkušební verzi zdarma →