Documentația aplicației

Nou în ROASaurus? Începe cu tutorialul. Ghidurile de configurare pe platforme sunt în centrul de ajutor, iar răspunsurile scurte în Întrebări frecvente.

Cum funcționează ROASaurus

Captare. Un mic script din magazinul tău înregistrează vizualizările de pagină, click id-urile reclamelor și parametrii UTM pentru vizitatorii care își dau consimțământul, pe propriul tău domeniu.
Potrivire. Când o comandă este plătită, ROASaurus o primește de la magazinul tău online și o potrivește cu vizitatorul și cu click-ul pe reclamă care l-a adus.
Trimitere. Achiziția pleacă server-side către fiecare platformă de publicitate conectată, cu același event id ca pixelul din browser, așa că platformele păstrează o singură copie.
Raportare. Aceleași comenzi, împreună cu costurile și cheltuielile tale cu reclamele, devin rapoarte de profit, atribuire și lifetime value.

Aplicația din adminul tău Shopify

Aplicația ROASaurus se deschide în adminul Shopify, fără autentificare separată. Are cinci pagini:

Acasă	Lista de verificare a configurării, starea theme app embed, a web pixelului și a conexiunilor tale, plus cifrele din ultimele 30 de zile. Un magazin nou se conectează aici la contul său ROASaurus.
Conexiuni	Adaugă, pune pe pauză sau elimină platformele de publicitate care primesc evenimentele tale, precum Meta, Google Ads, GA4, TikTok și Pinterest.
Configurare	Setările magazinului, Shopify Markets și sursele comenzilor, punctul de vânzare (POS) și comenzile draft, plus viteza vitrinei tale.
Rapoarte	Venituri, comenzi, cheltuieli cu reclamele, MER, profit net și comenzi potrivite cu o vizită pentru 7, 30 sau 90 de zile, cu comenzi, venituri, cheltuieli și ROAS pe canal.
Plan	Planul tău ROASaurus și un link către aplicația completă, unde se gestionează facturarea.

Aplicația completă de pe app.roasaurus.com conține toate rapoartele și setările: profitul și P&L, atribuirea, lifetime value, analiza creativelor, audiențele, Ask AI și facturarea. Deschide-o din aplicație sau autentifică-te direct.

Theme app embed și web pixel

Theme app embed încarcă scriptul ROASaurus pe fiecare pagină a vitrinei. Captează click id-urile reclamelor, salvează id-ul vizitatorului în coș și încarcă pixelii din browser ai platformelor tale de publicitate după ce vizitatorul acceptă cookie-urile de marketing. Activează-l din pagina Acasă a aplicației, care deschide editorul de teme. Web pixelul se instalează odată cu aplicația și urmărește pașii de checkout și achizițiile.

Permisiuni

Aplicația cere aceste permisiuni Shopify și o folosește pe fiecare doar pentru ce este listat:

Permisiune	Folosită pentru
`read_orders`	Webhook-uri pentru comenzi, profit și atribuire.
`read_customers`	Starea consimțământului clientului și segmentele de clienți pentru audiențe.
`write_pixels, read_customer_events`	Instalează și rulează web pixelul ROASaurus la checkout.
`read_products, read_inventory`	Costurile produselor și planurile de reaprovizionare.
`read_shopify_payments_disputes`	Chargeback-uri în rapoartele de profit.
`read_reports`	Costurile etichetelor Shopify Shipping.
`read_markets, read_locations`	Pixeli per Market și locațiile punctelor de vânzare.

ROASaurus respectă setările de confidențialitate ale clienților magazinului. Un vizitator care refuză cookie-urile de marketing nu primește un id de vizitator, iar evenimentele lui din browser nu sunt trimise platformelor de publicitate. Numele, adresele de email, numerele de telefon și adresele sunt hash-uite cu SHA-256 înainte de a fi trimise unei platforme de publicitate. Detaliile sunt în ghidul despre consimțământ, politica de confidențialitate și acordul de prelucrare a datelor.

Dezinstalarea

Când dezinstalezi aplicația, ROASaurus șterge token-urile de acces pentru magazinul tău și oprește trimiterea evenimentelor care erau încă în coadă. După 48 de ore, când Shopify trimite cererea de ștergere a datelor magazinului, toate înregistrările magazinului sunt șterse. Cererile clienților tăi de a-și vedea sau șterge datele ajung la ROASaurus prin webhook-urile de conformitate Shopify și sunt procesate automat.

Alte magazine online

ROASaurus funcționează și cu WooCommerce (printr-un plugin), Wix, BigCommerce, Magento, PrestaShop, Shopware, Lightspeed, CCV Shop, Squarespace și Ecwid, precum și cu orice backend prin API-ul de comenzi. Vezi centrul de ajutor pentru fiecare.

Pentru dezvoltatori

REST API citește rapoarte și trimite comenzi și evenimente cu o cheie cu acces limitat. Webhook-urile, exporturile în data warehouse și un server MCP pentru clienții AI sunt descrise pe paginile de funcții.

Suport

Scrie-ne la hello@roasaurus.com. Cum îți protejăm datele afli pe pagina de securitate; ce s-a schimbat recent este în jurnalul de modificări.