App-Dokumentation · ROASaurus

Neu bei ROASaurus? Fang mit dem Tutorial an. Einrichtungsanleitungen pro Plattform findest du im Hilfecenter, kurze Antworten in den FAQ.

So funktioniert ROASaurus

Erfassen. Ein kleines Skript in deinem Shop erfasst Seitenaufrufe, Click-IDs von Anzeigen und UTM-Parameter von Besuchern, die einwilligen, auf deiner eigenen Domain.
Zuordnen. Sobald eine Bestellung bezahlt ist, erhält ROASaurus sie von deinem Shop und ordnet sie dem Besucher und dem Anzeigenklick zu, über den er kam.
Senden. Der Kauf geht serverseitig an jede Werbeplattform, die du verbindest, mit derselben Event-ID wie beim Browser-Pixel, damit die Plattformen nur eine Kopie behalten.
Auswerten. Aus denselben Bestellungen werden, zusammen mit deinen Kosten und Werbeausgaben, Berichte zu Gewinn, Attribution und Customer Lifetime Value.

Die App in deinem Shopify-Admin

Die ROASaurus-App öffnet sich im Shopify-Admin, ohne separates Login. Sie hat fünf Seiten:

Startseite	Die Einrichtungs-Checkliste, der Status der App-Einbettung im Theme, des Web-Pixels und deiner Verbindungen sowie die Zahlen der letzten 30 Tage. Hier verbindet sich ein neuer Shop mit seinem ROASaurus-Konto.
Verbindungen	Füge die Werbeplattformen hinzu, die deine Events erhalten, etwa Meta, Google Ads, GA4, TikTok und Pinterest, oder pausiere und entferne sie.
Einrichtung	Shop-Einstellungen, Shopify Markets und Bestellquellen, Point of Sale und Entwurfsbestellungen sowie die Geschwindigkeit deiner Storefront.
Berichte	Umsatz, Bestellungen, Werbeausgaben, MER, Nettogewinn und einem Besuch zugeordnete Bestellungen für 7, 30 oder 90 Tage, mit Bestellungen, Umsatz, Ausgaben und ROAS pro Kanal.
Tarif	Dein ROASaurus-Tarif und ein Link zur vollständigen App, in der die Abrechnung verwaltet wird.

Die vollständige App auf app.roasaurus.com enthält jeden Bericht und jede Einstellung: Gewinn und die GuV, Attribution, Customer Lifetime Value, Creative-Analysen, Zielgruppen, Ask AI und Abrechnung. Öffne sie aus der App heraus oder melde dich direkt an.

App-Einbettung im Theme und Web-Pixel

Die App-Einbettung im Theme lädt das ROASaurus-Skript auf jeder Storefront-Seite. Sie erfasst Click-IDs von Anzeigen, speichert die Besucher-ID im Warenkorb und lädt die Browser-Pixel deiner Werbeplattformen, sobald ein Besucher Marketing-Cookies akzeptiert. Aktiviere sie auf der Startseite der App, die den Theme-Editor öffnet. Das Web-Pixel wird mit der App installiert und erfasst Checkout-Schritte und Käufe.

Berechtigungen

Die App fragt diese Shopify-Berechtigungen an und nutzt jede nur für den angegebenen Zweck:

Berechtigung	Verwendet für
`read_orders`	Bestell-Webhooks, Gewinn und Attribution.
`read_customers`	Den Einwilligungsstatus des Kunden und Kundensegmente für Zielgruppen.
`write_pixels, read_customer_events`	Installiert und betreibt das ROASaurus-Web-Pixel im Checkout.
`read_products, read_inventory`	Produktkosten und Nachbestellpläne.
`read_shopify_payments_disputes`	Rückbuchungen in Gewinnberichten.
`read_reports`	Kosten für Versandetiketten von Shopify Shipping.
`read_markets, read_locations`	Pixel pro Market und Point-of-Sale-Standorte.

ROASaurus folgt den Kunden-Datenschutzeinstellungen des Shops. Ein Besucher, der Marketing-Cookies ablehnt, erhält keine Besucher-ID, und seine Browser-Events werden nicht an Werbeplattformen gesendet. Namen, E-Mail-Adressen, Telefonnummern und Adressen werden mit SHA-256 gehasht, bevor sie an eine Werbeplattform gehen. Details stehen im Leitfaden zur Einwilligung, in der Datenschutzerklärung und im Auftragsverarbeitungsvertrag.

Deinstallation

Wenn du die App deinstallierst, löscht ROASaurus seine Zugriffstokens für deinen Shop und sendet keine Events mehr, die noch in der Warteschlange waren. 48 Stunden später, wenn Shopify seine Anfrage zur Löschung der Shopdaten sendet, wird jeder Datensatz des Shops gelöscht. Anfragen deiner Kunden, ihre Daten einzusehen oder zu löschen, erreichen ROASaurus über die Compliance-Webhooks von Shopify und werden automatisch bearbeitet.

Andere Webshops

ROASaurus funktioniert auch mit WooCommerce (über ein Plugin), Wix, BigCommerce, Magento, PrestaShop, Shopware, Lightspeed, CCV Shop, Squarespace und Ecwid sowie mit jedem Backend über die Orders API. Im Hilfecenter findest du jede Anleitung.

Für Entwickler

Die REST API liest Berichte und sendet Bestellungen und Events mit einem Schlüssel mit eingeschränkten Rechten. Webhooks, Warehouse-Exporte und ein MCP-Server für KI-Clients sind auf den Funktionsseiten beschrieben.

Support

Schreib an hello@roasaurus.com. Wie wir deine Daten schützen, steht auf der Sicherheitsseite; was sich zuletzt geändert hat, steht im Changelog.