Integrazione per negozi online

Tracciamento server-side per qualsiasi sito web

Aggiungi un tag script al tuo sito e invia gli ordini pagati come JSON dal tuo backend o da uno strumento no-code. ROASaurus associa ogni ordine al suo clic sull’annuncio e lo inoltra alle tue piattaforme pubblicitarie.

Sito personalizzato in sintesi
ScriptUn tag script su ogni pagina: visualizzazioni di pagina, click id, il cookie visitatore _tl
Orders APIPOST /api/v1/orders con una chiave del negozio e una chiave API
Webhook JSONPOST all’URL del tuo webhook dal tuo backend, da Zapier, Make o n8n
Eventi offlinePOST /api/v1/events per lead, demo e rinnovi
Abbinamento degli ordinivisitor_id (il cookie _tl), evento della pagina di ringraziamento, un’email lasciata in precedenza dal visitatore oppure IP e browser

1. Aggiungi lo script

Incolla il tag script della tua pagina Tracking & platforms su ogni pagina, di solito in «custom code», «code injection» o «header scripts». Registra le visualizzazioni di pagina, cattura i click id degli annunci e le UTM e imposta il cookie visitatore _tl. Invia altri eventi con tlq('track', 'AddToCart', {...}).

2. Invia gli ordini pagati

Orders API. Crea una chiave API in Settings › Orders API ed esegui un POST di ogni ordine pagato a /api/v1/orders. Il formato della richiesta è mostrato in quella pagina. Passa il cookie _tl come visitor_id così l’ordine viene associato al clic sull’annuncio.

Webhook JSON. Scegli «Other / custom webhook» quando aggiungi il negozio ed esegui un POST degli ordini all’URL del tuo webhook. Campi: order_id, total, currency, email, phone, first_name, last_name, country, zip, client_ip, user_agent, items (variant_id, quantity, price) e, se puoi, visitor_id. Puoi anche passare click_ids, landing_url e is_first_order, e contrassegnare gli ordini di prova con "test": true così vengono salvati ma non inviati.

3. Fai partire l’evento della pagina di ringraziamento

Nella pagina di conferma, fai partire tlq('track', 'Purchase', ...) con event_id impostato su order- più il tuo order id. Così l’ordine viene collegato al visitatore anche quando non puoi passare il cookie. Quando il tuo server invia gli ordini, gli acquisti del browser servono solo a collegare i visitatori; non creano più ordini.

Lead e abbonamenti

L’API degli eventi offline (POST /api/v1/events) accetta lead, demo, MQL e rinnovi di abbonamenti, associati a un visitatore tramite l’email con hash. Accetta fino a 1.000 eventi al minuto per negozio, di 3 KB ciascuno.

Funnel e cookie first-party

Elenca i domini del tuo funnel e del tuo negozio in Settings › Linked domains, e i link tra di essi porteranno con sé il visitor id e i click id. Servire lo script da un tuo sottodominio (un CNAME) mantiene la raccolta sul tuo dominio e riemette _tl come cookie HTTP. Safari può comunque limitare quel cookie a 7 giorni.

Correlati

FAQ

Domande, risposte

Mi serve uno sviluppatore?

Non sempre. Zapier, Make o n8n possono inviare gli ordini pagati dal tuo negozio o dal tuo strumento di pagamento all’URL del webhook di ROASaurus. Passare il visitor id dal cookie _tl di solito richiede una piccola modifica sul tuo sito.

Come invio gli ordini di prova?

Aggiungi "test": true all’ordine. ROASaurus lo salva così puoi controllare il formato, ma non invia nulla alle piattaforme pubblicitarie.

E se il mio sito non ha affatto un backend?

Fai partire l’acquisto del browser nella pagina di conferma. Quando un negozio non ha una fonte di ordini server-side, quell’evento crea l’ordine e viene inoltrato alle piattaforme pubblicitarie. Una fonte server è più affidabile.

Ogni vendita, ricondotta all’annuncio che l’ha generata

Tracciamento server-side, profitto e lifetime value in un’unica app. Prova gratuita di 14 giorni, senza carta di credito.

Inizia la prova gratuita →