Dokumentacja aplikacji

Pierwszy raz w ROASaurus? Zacznij od samouczka. Instrukcje konfiguracji dla każdej platformy są w centrum pomocy, krótkie odpowiedzi w FAQ.

Jak działa ROASaurus

Zbieranie. Mały skrypt w twoim sklepie zapisuje odsłony stron, click id reklam i parametry UTM odwiedzających, którzy wyrazili zgodę, na twojej własnej domenie.
Dopasowanie. Gdy zamówienie zostanie opłacone, ROASaurus otrzymuje je z twojego sklepu i dopasowuje do odwiedzającego oraz kliknięcia reklamy, które go przyprowadziło.
Wysyłka. Zakup trafia server-side do każdej podłączonej platformy reklamowej z tym samym event id co piksel przeglądarkowy, więc platformy zachowują jedną kopię.
Raporty. Te same zamówienia, razem z twoimi kosztami i wydatkami na reklamy, stają się raportami zysku, atrybucji i wartości życiowej klienta.

Aplikacja w panelu Shopify

Aplikacja ROASaurus otwiera się w panelu Shopify, bez osobnego logowania. Ma pięć stron:

Strona główna	Lista kontrolna konfiguracji, stan osadzenia aplikacji w motywie, web pixela i twoich połączeń oraz liczby z ostatnich 30 dni. Tutaj nowy sklep łączy się ze swoim kontem ROASaurus.
Połączenia	Dodawaj, wstrzymuj lub usuwaj platformy reklamowe, które otrzymują twoje zdarzenia, np. Meta, Google Ads, GA4, TikTok i Pinterest.
Konfiguracja	Ustawienia sklepu, Shopify Markets i źródła zamówień, punkty sprzedaży (POS) i zamówienia robocze oraz szybkość twojej witryny sklepu.
Raporty	Przychód, zamówienia, wydatki na reklamy, MER, zysk netto i zamówienia dopasowane do wizyty za 7, 30 lub 90 dni oraz zamówienia, przychód, wydatki i ROAS według kanału.
Plan	Twój plan ROASaurus i link do pełnej aplikacji, w której zarządzasz rozliczeniami.

Pełna aplikacja na app.roasaurus.com zawiera wszystkie raporty i ustawienia: zysk i P&L, atrybucję, wartość życiową klienta, analitykę kreacji, grupy odbiorców, Ask AI i rozliczenia. Otwórz ją z aplikacji lub zaloguj się bezpośrednio.

Osadzenie aplikacji w motywie i web pixel

Osadzenie aplikacji w motywie ładuje skrypt ROASaurus na każdej stronie witryny sklepu. Zapisuje click id reklam, zapisuje identyfikator odwiedzającego w koszyku i ładuje piksele przeglądarkowe twoich platform reklamowych, gdy odwiedzający zaakceptuje marketingowe cookie. Włącz je na stronie Strona główna w aplikacji, która otwiera edytor motywu. Web pixel instaluje się razem z aplikacją i śledzi kroki checkoutu oraz zakupy.

Uprawnienia

Aplikacja prosi o następujące uprawnienia Shopify i używa każdego z nich tylko do wymienionego celu:

Uprawnienie	Do czego służy
`read_orders`	Webhooki zamówień, zysk i atrybucja.
`read_customers`	Stan zgody klienta i segmenty klientów dla grup odbiorców.
`write_pixels, read_customer_events`	Instaluje i uruchamia web pixel ROASaurus w checkoucie.
`read_products, read_inventory`	Koszty produktów i plany uzupełniania zapasów.
`read_shopify_payments_disputes`	Chargebacki w raportach zysku.
`read_reports`	Koszty etykiet Shopify Shipping.
`read_markets, read_locations`	Piksele dla każdego Market i lokalizacje punktów sprzedaży.

ROASaurus stosuje się do ustawień prywatności klientów sklepu. Odwiedzający, który odrzuci marketingowe cookie, nie dostaje identyfikatora odwiedzającego, a jego zdarzenia z przeglądarki nie są wysyłane do platform reklamowych. Imiona i nazwiska, adresy e-mail, numery telefonów i adresy są hashowane za pomocą SHA-256, zanim zostaną wysłane do platformy reklamowej. Szczegóły znajdziesz w przewodniku po zgodach, polityce prywatności i umowie powierzenia przetwarzania danych.

Odinstalowanie

Gdy odinstalujesz aplikację, ROASaurus usuwa swoje tokeny dostępu do twojego sklepu i przestaje wysyłać zdarzenia, które jeszcze czekały w kolejce. 48 godzin później, gdy Shopify wyśle żądanie usunięcia danych sklepu, wszystkie dane sklepu zostają usunięte. Prośby twoich klientów o wgląd w dane lub ich usunięcie docierają do ROASaurus przez webhooki zgodności Shopify i są obsługiwane automatycznie.

Inne sklepy internetowe

ROASaurus działa też z WooCommerce (przez wtyczkę), Wix, BigCommerce, Magento, PrestaShop, Shopware, Lightspeed, CCV Shop, Squarespace i Ecwid, a z dowolnym backendem przez API zamówień. Instrukcje dla każdej z nich znajdziesz w centrum pomocy.

Dla deweloperów

REST API odczytuje raporty i wysyła zamówienia oraz zdarzenia za pomocą klucza o ograniczonym zakresie. Webhooki, eksporty do hurtowni danych i serwer MCP dla klientów AI są opisane na stronach funkcji.

Wsparcie

Napisz na hello@roasaurus.com. Jak chronimy twoje dane, opisujemy na stronie bezpieczeństwa; ostatnie zmiany są na liście zmian.