Integrazione per negozi online

Tracciamento server-side per i negozi Ecwid

ROASaurus legge gli ordini pagati di Ecwid tramite il token di un’app personalizzata e li invia dal server alle tue piattaforme pubblicitarie. Chiedi i webhook al supporto di Ecwid e gli ordini arrivano all’istante.

Ecwid in sintesi
Gli ordini arrivano tramitePolling dell’API ogni 5 minuti; webhook quando il supporto di Ecwid li abilita
CredenzialiStore ID, il token segreto dell’app personalizzata e il suo client secret per i webhook
Verifica del webhookFirma HMAC con il client secret
Ordini pagatiStato del pagamento PAID
Snippet della thank-you pageEcwid.OnOrderPlaced, dopo lo script di tracciamento

Come si collega Ecwid

  1. Aggiungi lo script di ROASaurus al sito che incorpora il tuo negozio Ecwid, oppure al codice personalizzato del tuo Instant Site.
  2. Aggiungi dopo di esso lo snippet della pagina di ringraziamento. Resta in ascolto dell’evento OnOrderPlaced di Ecwid e fa partire l’acquisto in ROASaurus con il numero d’ordine, il totale e l’email.
  3. Su my.ecwid.com/#develop-apps, crea un’app personalizzata con accesso in lettura agli ordini. Inserisci in ROASaurus il tuo store ID (mostrato nell’URL del tuo admin e in Account › Summary) e il token secret_… dell’app.

ROASaurus recupera poi gli ordini aggiornati dall’ultima esecuzione, ogni 5 minuti, e invia quelli con stato di pagamento PAID.

Ordini istantanei con i webhook

Ecwid imposta gli URL dei webhook delle app personalizzate tramite il suo team di supporto API. Chiedi di impostare l’URL del webhook della tua app su quello che trovi nella scheda Connection di ROASaurus, con gli eventi order.created e order.updated. Incolla il client secret dell’app in ROASaurus: ogni webhook viene verificato con la sua firma HMAC, e poi l’ordine viene recuperato dall’API.

Cosa legge ROASaurus da ogni ordine

Il totale, la valuta, l’email, il nome, il telefono e l’indirizzo di fatturazione, il customer id e gli articoli con combinazione, quantità, prezzo e SKU. Gli ordini Ecwid includono l’indirizzo IP e lo user agent del cliente, quindi ROASaurus può abbinare anche in base allo stesso IP e browser, solo quando corrisponde esattamente un visitatore.

Limiti

  • I webhook richiedono una richiesta al supporto di Ecwid. Fino ad allora, gli ordini impiegano fino a 5 minuti.
  • Ecwid fornisce un unico campo nome, che ROASaurus divide in nome e cognome.
  • 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

FAQ

Domande, risposte

Perché devo contattare Ecwid per i webhook?

Ecwid configura l’URL del webhook di un’app personalizzata tramite il suo supporto API. Il polling ogni 5 minuti funziona anche senza.

A cosa serve il client secret?

Serve a verificare che un webhook arrivi davvero da Ecwid. ROASaurus controlla con esso la firma HMAC di ogni webhook prima di recuperare l’ordine.

Funziona con Ecwid incorporato in un altro sito?

Sì. Aggiungi lo script di ROASaurus e lo snippet della pagina di ringraziamento al sito che incorpora il tuo negozio Ecwid.

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 →