Tracciamento server-side per Shopware 6
Aggiungi un’integrazione Shopware con accesso in lettura agli ordini e ROASaurus sincronizza gli ordini pagati dall’Admin API. Un webhook di Flow Builder li fa arrivare nel momento in cui vengono pagati.
| Shopware in sintesi | |
|---|---|
| Gli ordini arrivano tramite | Polling dell’Admin API ogni 5 minuti; istantaneo con un webhook di Flow Builder |
| Credenziali | Access key ID e secret access key dell’integrazione |
| Ordini pagati | Una transazione nello stato paid |
| Order id | Il numero d’ordine Shopware |
| Snippet della thank-you page | Template checkout/finish, con page.order.orderNumber |
Come si collega Shopware
- Aggiungi lo script di ROASaurus al tuo tema (
base.html.twig, bloccobase_script_tracking) oppure con un plugin di tag manager. - Settings › System › Integrations › Add integration, con accesso in lettura agli ordini. Inserisci access key ID e secret access key in ROASaurus.
- Per un abbinamento esatto, aggiungi lo snippet della pagina di ringraziamento a
storefront/page/checkout/finish/index.html.twig.
ROASaurus scambia le chiavi dell’integrazione con un token Admin API di breve durata e cerca gli ordini aggiornati dall’ultima esecuzione, ogni 5 minuti. Un ordine conta come pagato quando una delle sue transazioni è nello stato paid. Come id viene usato il numero d’ordine, che è anche ciò che invia lo snippet della pagina di ringraziamento.
Ordini istantanei con Flow Builder
Su Shopware Evolve e superiori, crea un flow con trigger State Enter / Order Transaction / State / Paid e azione Call URL (Webhook), in POST verso l’URL del tuo webhook ROASaurus. La chiamata è solo un segnale: ROASaurus non si fida del suo contenuto e recupera invece gli ordini delle ultime due ore tramite l’API autenticata. Gli ordini che ha già vengono ignorati.
Cosa legge ROASaurus da ogni ordine
Il totale, la valuta, la data dell’ordine, l’email e il nome del cliente, il telefono, la città, il CAP e il paese di fatturazione, il customer id e le righe d’ordine dei prodotti con quantità, prezzo unitario e numero prodotto.
Collegare gli ordini ai clic sugli annunci
Lo snippet della pagina di ringraziamento fa partire l’acquisto in ROASaurus con il numero d’ordine e il totale, e questo collega l’ordine al visitatore. Senza, ROASaurus usa un’email che il visitatore ha lasciato in precedenza sul tuo sito, per esempio in un popup.
Limiti
- Shopware anonimizza di default l’indirizzo IP del cliente, quindi il ripiego sull’IP serve di rado. Aggiungi lo snippet della pagina di ringraziamento.
- I webhook di Flow Builder richiedono Shopware Evolve o superiore. Senza, gli ordini impiegano fino a 5 minuti.
- 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
Mi serve Flow Builder?
No. Senza, ROASaurus recupera gli ordini pagati ogni 5 minuti. Il webhook di Flow Builder, disponibile da Shopware Evolve in su, serve solo a farli arrivare subito.
Il webhook di Flow Builder è sicuro?
ROASaurus lo considera solo un segnale. Non prende mai i dati dell’ordine dalla chiamata; recupera gli ordini recenti tramite l’Admin API con le chiavi della tua integrazione.
Che accesso serve all’integrazione?
Accesso in lettura agli ordini. ROASaurus usa l’access key ID e il secret dell’integrazione per ottenere un token Admin API di breve durata.
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 →