Dokumentace aplikace

S ROASaurus začínáte? Začněte návodem. Návody k nastavení pro jednotlivé platformy jsou v centru nápovědy, krátké odpovědi v častých dotazech.

Jak ROASaurus funguje

Zachycení. Malý skript ve vašem obchodě zaznamenává zobrazení stránek, ID kliknutí z reklam a UTM parametry u návštěvníků, kteří dali souhlas, a to na vaší vlastní doméně.
Spárování. Když je objednávka zaplacena, ROASaurus ji přijme z vašeho e-shopu a spáruje ji s návštěvníkem a s kliknutím na reklamu, které ho přivedlo.
Odeslání. Nákup jde server-side do každé reklamní platformy, kterou připojíte, se stejným ID události jako pixel v prohlížeči, takže si platformy ponechají jen jednu kopii.
Reporty. Ze stejných objednávek se spolu s vašimi náklady a útratou za reklamu stanou reporty zisku, atribuce a celoživotní hodnoty.

Aplikace ve vaší administraci Shopify

Aplikace ROASaurus se otevírá přímo v administraci Shopify, bez samostatného přihlášení. Má pět stránek:

Domů	Kontrolní seznam nastavení, stav theme app embed, webového pixelu a vašich propojení a čísla za posledních 30 dní. Zde se nový obchod připojí ke svému účtu ROASaurus.
Propojení	Přidávejte, pozastavujte nebo odebírejte reklamní platformy, které dostávají vaše události, například Meta, Google Ads, GA4, TikTok a Pinterest.
Konfigurace	Nastavení obchodu, Shopify Markets a zdroje objednávek, prodejní místo (POS) a koncepty objednávek a rychlost vašeho obchodu.
Reporty	Příjmy, objednávky, útrata za reklamu, MER, čistý zisk a objednávky spárované s návštěvou za 7, 30 nebo 90 dní, s objednávkami, příjmy, útratou a ROAS podle kanálu.
Tarif	Váš tarif ROASaurus a odkaz do plné aplikace, kde se spravuje fakturace.

Plná aplikace na app.roasaurus.com obsahuje všechny reporty a nastavení: zisk a výkaz P&L, atribuci, celoživotní hodnotu, analýzu kreativ, publika, Ask AI a fakturaci. Otevřete ji z aplikace, nebo se přihlaste přímo.

Theme app embed a webový pixel

Theme app embed načítá skript ROASaurus na každé stránce obchodu. Zachycuje ID kliknutí z reklam, ukládá ID návštěvníka do košíku a po přijetí marketingových cookies návštěvníkem načte pixely vašich reklamních platforem v prohlížeči. Zapnete ho na stránce Domů v aplikaci, která otevře editor šablony. Webový pixel se instaluje spolu s aplikací a sleduje kroky pokladny a nákupy.

Oprávnění

Aplikace žádá o tato oprávnění Shopify a každé používá jen k uvedenému účelu:

Oprávnění	Slouží k
`read_orders`	Webhooky objednávek, zisk a atribuce.
`read_customers`	Stav souhlasu zákazníka a zákaznické segmenty pro publika.
`write_pixels, read_customer_events`	Instaluje a spouští webový pixel ROASaurus v pokladně.
`read_products, read_inventory`	Náklady na produkty a plány doskladnění.
`read_shopify_payments_disputes`	Chargebacky v reportech zisku.
`read_reports`	Náklady na přepravní štítky Shopify Shipping.
`read_markets, read_locations`	Pixely podle Market a pobočky prodejního místa (POS).

ROASaurus se řídí nastavením ochrany soukromí zákazníků vašeho obchodu. Návštěvník, který odmítne marketingové cookies, nedostane ID návštěvníka a jeho události z prohlížeče se reklamním platformám neodesílají. Jména, e-maily, telefonní čísla a adresy se před odesláním reklamní platformě hashují pomocí SHA-256. Podrobnosti najdete v průvodci souhlasem, v zásadách ochrany osobních údajů a ve smlouvě o zpracování osobních údajů.

Odinstalace

Když aplikaci odinstalujete, ROASaurus smaže své přístupové tokeny k vašemu obchodu a přestane odesílat události, které ještě čekaly ve frontě. O 48 hodin později, když Shopify pošle žádost o výmaz obchodu, se smažou všechny záznamy o obchodě. Žádosti vašich zákazníků o zobrazení nebo smazání jejich dat přicházejí do ROASaurus přes compliance webhooky Shopify a zpracovávají se automaticky.

Ostatní e-shopy

ROASaurus funguje také s WooCommerce (přes plugin), Wix, BigCommerce, Magento, PrestaShop, Shopware, Lightspeed, CCV Shop, Squarespace a Ecwid a s jakýmkoli backendem přes API pro objednávky. Návod pro každou z nich najdete v centru nápovědy.

Pro vývojáře

REST API čte reporty a odesílá objednávky a události pomocí klíče s omezeným rozsahem. Webhooky, exporty do datového skladu a MCP server pro AI klienty jsou popsány na stránkách funkcí.

Podpora

Napište na hello@roasaurus.com. Jak chráníme vaše data, popisuje stránka o zabezpečení; co se v poslední době změnilo, najdete v changelogu.