Tracciamento server-side per Squarespace Commerce
ROASaurus legge gli ordini pagati dalla Commerce API di Squarespace ogni 5 minuti e li invia dal server alle tue piattaforme pubblicitarie. Uno snippet nella pagina di stato dell’ordine collega ogni ordine al clic sull’annuncio.
| Squarespace in sintesi | |
|---|---|
| Gli ordini arrivano tramite | Polling della Commerce API ogni 5 minuti |
| Credenziali | Developer API key con Orders: read |
| Piano | Le chiavi API richiedono il piano Commerce Advanced |
| Ordini pagati | Stato di pagamento PAID |
| Snippet della thank-you page | Code injection della Order Status Page, con {orderId} e {orderGrandTotal} |
Come si collega Squarespace
- Settings › Advanced › Code Injection › Header: incolla il tag script di ROASaurus.
- Nella stessa pagina, in Order Status Page (e in Order Confirmation Page per i prodotti digitali), incolla lo snippet della pagina di ringraziamento.
- Settings › Advanced › Developer API Keys › Generate Key con Orders: read, e inseriscila in ROASaurus.
Perché il polling e non i webhook
Squarespace invia webhook solo alle app OAuth, non alle integrazioni che un commerciante configura con una chiave API. Per questo ROASaurus recupera gli ordini modificati dall’ultima esecuzione, ogni 5 minuti, con una sovrapposizione di 30 minuti. Vengono inviati gli ordini con stato di pagamento PAID; i duplicati vengono ignorati.
Collegare gli ordini ai clic sugli annunci
Lo snippet usa le variabili di Squarespace, {orderId}, {orderGrandTotal} e {customerEmailAddress}, per far partire l’acquisto in ROASaurus con lo stesso order id. È racchiuso in {.if firstPageView}, così un cliente che ricarica la pagina di stato dell’ordine non lo fa partire due volte. Senza lo snippet, ROASaurus ripiega su un’email che il visitatore ha lasciato in precedenza sul tuo sito, per esempio in un popup.
Cosa legge ROASaurus da ogni ordine
Il numero d’ordine, il totale complessivo e la valuta, l’email e l’ID del cliente, il nome, il telefono e l’indirizzo di fatturazione, e per ogni riga d’ordine il prodotto, la variante, la quantità, il prezzo pagato e lo SKU.
Limiti
- Le chiavi API richiedono il piano Commerce Advanced.
- Gli ordini arrivano fino a 5 minuti dopo il pagamento. «Fetch orders now» sincronizza su richiesta.
- Gli ordini Squarespace non includono l’indirizzo IP del cliente, quindi il ripiego sull’IP non è disponibile. Aggiungi lo snippet.
- Il connettore è costruito a partire dalla documentazione ufficiale dell’API della piattaforma. Premi Test connection dopo aver salvato le credenziali, poi fai un ordine di prova e controlla l’Event log.
Correlati
Domande, risposte
Di quale piano Squarespace ho bisogno?
Le chiavi API per sviluppatori per gli ordini richiedono il piano Commerce Advanced. Lo script e lo snippet di tracciamento funzionano tramite Code Injection.
Perché Squarespace non può inviare gli ordini all’istante?
Squarespace invia webhook solo alle app OAuth, non alle chiavi API dei commercianti. ROASaurus interroga quindi la Commerce API ogni 5 minuti.
Ricaricare la pagina dell’ordine conterà l’acquisto due volte?
No. Lo snippet si attiva solo alla prima visualizzazione della pagina di stato dell’ordine, e ROASaurus ignora un secondo acquisto con lo stesso order id.
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 →