Documentation de l’app

Nouveau sur ROASaurus ? Commencez par le tutoriel. Les guides de configuration par plateforme sont dans le centre d’aide, les réponses courtes dans la FAQ.

Comment fonctionne ROASaurus

Capter. Un petit script sur votre boutique enregistre les pages vues, les identifiants de clic publicitaire et les paramètres UTM des visiteurs qui consentent, sur votre propre domaine.
Associer. Quand une commande est payée, ROASaurus la reçoit de votre boutique et l’associe au visiteur et au clic publicitaire qui l’a amené.
Envoyer. L’achat part côté serveur vers chaque plateforme publicitaire que vous connectez, avec le même identifiant d’événement que le pixel navigateur, pour que les plateformes n’en gardent qu’une copie.
Analyser. Ces mêmes commandes, avec vos coûts et vos dépenses publicitaires, deviennent des rapports de bénéfice, d’attribution et de valeur vie client.

L’app dans votre admin Shopify

L’app ROASaurus s’ouvre dans l’admin Shopify, sans connexion séparée. Elle compte cinq pages :

Accueil	La checklist de configuration, l’état de l’app embed du thème, du pixel web et de vos connexions, et les chiffres des 30 derniers jours. C’est ici qu’une nouvelle boutique se connecte à son compte ROASaurus.
Connexions	Ajoutez, mettez en pause ou supprimez les plateformes publicitaires qui reçoivent vos événements, comme Meta, Google Ads, GA4, TikTok et Pinterest.
Configuration	Réglages de la boutique, Shopify Markets et sources de commandes, point de vente et brouillons de commande, et vitesse de votre boutique.
Rapports	Chiffre d’affaires, commandes, dépenses publicitaires, MER, bénéfice net et commandes associées à une visite sur 7, 30 ou 90 jours, avec commandes, chiffre d’affaires, dépenses et ROAS par canal.
Formule	Votre formule ROASaurus, et un lien vers l’app complète où se gère la facturation.

L’app complète sur app.roasaurus.com contient tous les rapports et réglages : bénéfice et P&L, attribution, valeur vie client, analyse créative, audiences, Ask AI et facturation. Ouvrez-la depuis l’app ou connectez-vous directement.

App embed du thème et pixel web

L’app embed du thème charge le script ROASaurus sur chaque page de la boutique. Il capte les identifiants de clic publicitaire, enregistre l’identifiant visiteur sur le panier et charge les pixels navigateur de vos plateformes publicitaires une fois que le visiteur accepte les cookies marketing. Activez-le depuis la page Accueil de l’app, qui ouvre l’éditeur de thème. Le pixel web est installé avec l’app et suit les étapes du checkout et les achats.

Autorisations

L’app demande ces autorisations Shopify et n’utilise chacune que pour l’usage indiqué :

Autorisation	Utilisée pour
`read_orders`	Webhooks de commande, bénéfice et attribution.
`read_customers`	L’état du consentement du client et les segments clients pour les audiences.
`write_pixels, read_customer_events`	Installe et exécute le pixel web ROASaurus au checkout.
`read_products, read_inventory`	Coûts produits et plans de réassort.
`read_shopify_payments_disputes`	Chargebacks dans les rapports de bénéfice.
`read_reports`	Coûts des étiquettes Shopify Shipping.
`read_markets, read_locations`	Pixels par Market et emplacements de point de vente.

ROASaurus suit les réglages de confidentialité client de la boutique. Un visiteur qui refuse les cookies marketing ne reçoit pas d’identifiant visiteur, et ses événements navigateur ne sont pas envoyés aux plateformes publicitaires. Les noms, e-mails, numéros de téléphone et adresses sont hachés en SHA-256 avant d’être envoyés à une plateforme publicitaire. Les détails figurent dans le guide du consentement, la politique de confidentialité et l’accord de traitement des données.

Désinstallation

Quand vous désinstallez l’app, ROASaurus supprime ses jetons d’accès à votre boutique et cesse d’envoyer les événements encore en file d’attente. 48 heures plus tard, quand Shopify envoie sa demande d’effacement de la boutique, toutes les données de la boutique sont supprimées. Les demandes de vos clients pour consulter ou supprimer leurs données parviennent à ROASaurus via les webhooks de conformité de Shopify et sont traitées automatiquement.

Autres boutiques en ligne

ROASaurus fonctionne aussi avec WooCommerce (via un plugin), Wix, BigCommerce, Magento, PrestaShop, Shopware, Lightspeed, CCV Shop, Squarespace et Ecwid, et avec n’importe quel backend via l’API de commandes. Consultez le centre d’aide pour chacun.

Pour les développeurs

L’API REST lit les rapports et envoie des commandes et des événements avec une clé aux droits limités. Les webhooks, les exports vers un entrepôt de données et un serveur MCP pour les clients IA sont décrits sur les pages fonctionnalités.

Support

Écrivez à hello@roasaurus.com. La façon dont nous protégeons vos données est décrite sur la page sécurité ; les changements récents sont dans les nouveautés.