Documentatie van de app

Nieuw bij ROASaurus? Begin met de tutorial. Installatiegidsen per platform staan in het helpcentrum, korte antwoorden in de FAQ.

Hoe ROASaurus werkt

Vastleggen. Een klein script op je webshop legt paginaweergaven, click-id's van advertenties en UTM-parameters vast voor bezoekers die toestemming geven, op je eigen domein.
Koppelen. Zodra een bestelling betaald is, ontvangt ROASaurus die van je webshop en koppelt hem aan de bezoeker en de advertentieklik die hem binnenbracht.
Versturen. De aankoop gaat server-side naar elk advertentieplatform dat je koppelt, met hetzelfde event-id als de browserpixel, zodat de platforms één exemplaar houden.
Rapporteren. Dezelfde bestellingen worden, met je kosten en advertentiekosten, rapporten over winst, attributie en lifetime value.

De app in je Shopify-admin

De ROASaurus-app opent in de Shopify-admin, zonder aparte login. Hij heeft vijf pagina’s:

Home	De installatiechecklist, de status van de theme app embed, de webpixel en je koppelingen, en de cijfers van de laatste 30 dagen. Hier koppelt een nieuwe webshop zich aan zijn ROASaurus-account.
Koppelingen	Voeg de advertentieplatforms toe die je events ontvangen, zoals Meta, Google Ads, GA4, TikTok en Pinterest, of pauzeer of verwijder ze.
Installatie	Webshopinstellingen, Shopify Markets en orderbronnen, kassa- en conceptbestellingen, en de snelheid van je storefront.
Rapporten	Omzet, bestellingen, advertentiekosten, MER, nettowinst en aan een bezoek gekoppelde bestellingen over 7, 30 of 90 dagen, met bestellingen, omzet, kosten en ROAS per kanaal.
Abonnement	Je ROASaurus-abonnement, en een link naar de volledige app waar je de facturering beheert.

De volledige app op app.roasaurus.com bevat elk rapport en elke instelling: winst en de P&L, attributie, lifetime value, creative-analyse, doelgroepen, Ask AI en facturering. Open hem vanuit de app, of log direct in.

Theme app embed en webpixel

De theme app embed laadt het ROASaurus-script op elke storefront-pagina. Hij legt click-id's van advertenties vast, slaat het bezoeker-id op in de winkelwagen en laadt de browserpixels van je advertentieplatforms nadat een bezoeker marketingcookies accepteert. Zet hem aan vanaf de pagina Start van de app; die opent de thema-editor. De webpixel wordt met de app geïnstalleerd en volgt de checkoutstappen en aankopen.

Toestemmingen

De app vraagt deze Shopify-toestemmingen en gebruikt elke toestemming alleen voor wat erbij staat:

Toestemming	Gebruikt voor
`read_orders`	Orderwebhooks, winst en attributie.
`read_customers`	De toestemmingsstatus van de klant en klantsegmenten voor doelgroepen.
`write_pixels, read_customer_events`	Installeert en draait de ROASaurus-webpixel in de checkout.
`read_products, read_inventory`	Productkosten en bijbestelplannen.
`read_shopify_payments_disputes`	Chargebacks in winstrapporten.
`read_reports`	Kosten van Shopify Shipping-labels.
`read_markets, read_locations`	Pixels per Market en kassalocaties.

ROASaurus volgt de klantprivacy-instellingen van de webshop. Een bezoeker die marketingcookies weigert, krijgt geen bezoeker-id en zijn browserevents worden niet naar advertentieplatforms gestuurd. Namen, e-mailadressen, telefoonnummers en adressen worden met SHA-256 gehasht voordat ze naar een advertentieplatform gaan. Details staan in de gids over toestemming, het privacybeleid en de verwerkersovereenkomst.

De-installeren

Als je de app de-installeert, verwijdert ROASaurus zijn toegangstokens voor je webshop en stopt het met het versturen van events die nog in de wachtrij stonden. 48 uur later, wanneer Shopify zijn verzoek tot verwijdering van de shopgegevens stuurt, wordt elk record van de webshop verwijderd. Verzoeken van je klanten om hun gegevens in te zien of te verwijderen komen via de compliance-webhooks van Shopify bij ROASaurus binnen en worden automatisch afgehandeld.

Andere webshops

ROASaurus werkt ook met WooCommerce (via een plugin), Wix, BigCommerce, Magento, PrestaShop, Shopware, Lightspeed, CCV Shop, Squarespace en Ecwid, en met elke backend via de orders-API. Zie het helpcentrum voor elk platform.

Voor developers

De REST API leest rapporten en verstuurt bestellingen en events met een sleutel met beperkte rechten. Webhooks, warehouse-exports en een MCP-server voor AI-clients staan beschreven op de functiepagina’s.

Support

Mail naar hello@roasaurus.com. Hoe we je gegevens beschermen staat op de beveiligingspagina; wat er onlangs veranderd is, staat in de changelog.