App documentation · ROASaurus

New to ROASaurus? Start with the tutorial. Setup guides per platform are in the help center, short answers in the FAQ.

How ROASaurus works

Capture. A small script on your store records page views, ad click ids and UTM parameters for visitors who consent, on your own domain.
Match. When an order is paid, ROASaurus receives it from your webshop and matches it to the visitor and the ad click that brought them.
Send. The purchase goes server-side to every ad platform you connect, with the same event id as the browser pixel, so the platforms keep one copy.
Report. The same orders, with your costs and ad spend, become profit, attribution and lifetime value reports.

The app in your Shopify admin

The ROASaurus app opens inside the Shopify admin, with no separate login. It has five pages:

Home	The setup checklist, the status of the theme app embed, the web pixel and your connections, and the numbers of the last 30 days. A new store connects to its ROASaurus account here.
Connections	Add, pause or remove the ad platforms that receive your events, such as Meta, Google Ads, GA4, TikTok and Pinterest.
Setup	Store settings, Shopify Markets and order sources, point of sale and draft orders, and the speed of your storefront.
Reports	Revenue, orders, ad spend, MER, net profit and orders matched to a visit for 7, 30 or 90 days, with orders, revenue, spend and ROAS per channel.
Plan	Your ROASaurus plan, and a link to the full app where billing is managed.

The full app at app.roasaurus.com holds every report and setting: profit and the P&L, attribution, lifetime value, creative analytics, audiences, Ask AI and billing. Open it from the app, or log in directly.

Theme app embed and web pixel

The theme app embed loads the ROASaurus script on every storefront page. It captures ad click ids, stores the visitor id on the cart and loads the browser pixels of your ad platforms after a visitor accepts marketing cookies. Switch it on from the app's Home page, which opens the theme editor. The web pixel is installed with the app and tracks checkout steps and purchases.

Permissions

The app asks for these Shopify permissions, and uses each one only for what is listed:

Permission	Used for
`read_orders`	Order webhooks, profit and attribution.
`read_customers`	The customer's consent state and customer segments for audiences.
`write_pixels, read_customer_events`	Installs and runs the ROASaurus web pixel at checkout.
`read_products, read_inventory`	Product costs and restock plans.
`read_shopify_payments_disputes`	Chargebacks in profit reports.
`read_reports`	Shopify Shipping label costs.
`read_markets, read_locations`	Pixels per Market and point of sale locations.

ROASaurus follows the store's customer privacy settings. A visitor who declines marketing cookies gets no visitor id and their browser events are not sent to ad platforms. Names, emails, phone numbers and addresses are hashed with SHA-256 before they are sent to an ad platform. Details are in the consent guide, the privacy policy and the data processing agreement.

Uninstalling

When you uninstall the app, ROASaurus deletes its access tokens for your store and stops sending events that were still queued. 48 hours later, when Shopify sends its shop redaction request, every record of the store is deleted. Requests from your customers to see or delete their data reach ROASaurus through Shopify's compliance webhooks and are handled automatically.

Other webshops

ROASaurus also works with WooCommerce (through a plugin), Wix, BigCommerce, Magento, PrestaShop, Shopware, Lightspeed, CCV Shop, Squarespace and Ecwid, and with any backend through the orders API. See the help center for each one.

For developers

The REST API reads reports and sends orders and events with a scoped key. Webhooks, warehouse exports and an MCP server for AI clients are described on the feature pages.

Support

Email hello@roasaurus.com. How we protect your data is on the security page; what changed recently is in the changelog.