Documentazione dell’app

Nuovo su ROASaurus? Parti dal tutorial. Le guide alla configurazione per piattaforma sono nel centro assistenza, le risposte brevi nelle FAQ.

Come funziona ROASaurus

Rilevare. Un piccolo script sul tuo negozio registra le visualizzazioni di pagina, i click id degli annunci e i parametri UTM dei visitatori che danno il consenso, sul tuo dominio.
Associare. Quando un ordine viene pagato, ROASaurus lo riceve dal tuo negozio e lo associa al visitatore e al clic sull’annuncio che lo ha portato.
Inviare. L’acquisto viene inviato server-side a ogni piattaforma pubblicitaria che colleghi, con lo stesso event id del pixel del browser, così le piattaforme ne tengono una sola copia.
Analizzare. Gli stessi ordini, con i tuoi costi e la spesa pubblicitaria, diventano report su profitto, attribuzione e lifetime value.

L’app nel tuo admin di Shopify

L’app ROASaurus si apre dentro l’admin di Shopify, senza un login separato. Ha cinque pagine:

Home	La checklist di configurazione, lo stato dell’app embed del tema, del pixel web e delle tue connessioni, e i numeri degli ultimi 30 giorni. Qui un nuovo negozio si collega al suo account ROASaurus.
Connessioni	Aggiungi, metti in pausa o rimuovi le piattaforme pubblicitarie che ricevono i tuoi eventi, come Meta, Google Ads, GA4, TikTok e Pinterest.
Setup	Impostazioni del negozio, Shopify Markets e origini degli ordini, punto vendita e bozze di ordine, e la velocità della tua vetrina.
Report	Ricavi, ordini, spesa pubblicitaria, MER, utile netto e ordini associati a una visita per 7, 30 o 90 giorni, con ordini, ricavi, spesa e ROAS per canale.
Piano	Il tuo piano ROASaurus e un link all’app completa, dove si gestisce la fatturazione.

L’app completa su app.roasaurus.com contiene ogni report e impostazione: profitto e conto economico, attribuzione, lifetime value, analisi delle creatività, audience, Ask AI e fatturazione. Aprila dall’app o accedi direttamente.

App embed del tema e pixel web

L’app embed del tema carica lo script di ROASaurus su ogni pagina della vetrina. Cattura i click id degli annunci, salva il visitor id sul carrello e carica i pixel del browser delle tue piattaforme pubblicitarie dopo che un visitatore ha accettato i cookie di marketing. Attivalo dalla pagina Home dell’app, che apre l’editor del tema. Il pixel web viene installato con l’app e traccia i passaggi del checkout e gli acquisti.

Autorizzazioni

L’app chiede queste autorizzazioni di Shopify e usa ciascuna solo per quanto indicato:

Autorizzazione	Usata per
`read_orders`	Webhook degli ordini, profitto e attribuzione.
`read_customers`	Lo stato del consenso del cliente e i segmenti di clienti per le audience.
`write_pixels, read_customer_events`	Installa ed esegue il pixel web di ROASaurus al checkout.
`read_products, read_inventory`	Costi dei prodotti e piani di riassortimento.
`read_shopify_payments_disputes`	Chargeback nei report sul profitto.
`read_reports`	Costi delle etichette di Shopify Shipping.
`read_markets, read_locations`	Pixel per Market e sedi dei punti vendita.

ROASaurus segue le impostazioni sulla privacy dei clienti del negozio. Un visitatore che rifiuta i cookie di marketing non riceve un visitor id e i suoi eventi del browser non vengono inviati alle piattaforme pubblicitarie. Nomi, email, numeri di telefono e indirizzi vengono sottoposti a hash con SHA-256 prima di essere inviati a una piattaforma pubblicitaria. I dettagli sono nella guida al consenso, nell’informativa sulla privacy e nell’accordo sul trattamento dei dati.

Disinstallazione

Quando disinstalli l’app, ROASaurus elimina i suoi token di accesso al tuo negozio e smette di inviare gli eventi ancora in coda. 48 ore dopo, quando Shopify invia la richiesta di cancellazione del negozio, viene eliminato ogni record del negozio. Le richieste dei tuoi clienti di vedere o cancellare i propri dati arrivano a ROASaurus tramite i webhook di conformità di Shopify e vengono gestite automaticamente.

Altri negozi online

ROASaurus funziona anche con WooCommerce (tramite un plugin), Wix, BigCommerce, Magento, PrestaShop, Shopware, Lightspeed, CCV Shop, Squarespace ed Ecwid, e con qualsiasi backend tramite l’API degli ordini. Consulta il centro assistenza per ciascuno.

Per sviluppatori

La REST API legge i report e invia ordini ed eventi con una chiave dai permessi limitati. Webhook, export verso data warehouse e un server MCP per i client AI sono descritti nelle pagine delle funzionalità.

Assistenza

Scrivi a hello@roasaurus.com. Come proteggiamo i tuoi dati è spiegato nella pagina sulla sicurezza; le modifiche recenti sono nelle novità.