Tracciamento server-side per CCV Shop
Collega le tue chiavi API di CCV Shop e premi Create webhook. CCV segnala poi ogni ordine pagato a ROASaurus, che lo invia dal server alle tue piattaforme pubblicitarie.
| CCV Shop in sintesi | |
|---|---|
| Gli ordini arrivano tramite | Webhook (ordine pagato) più polling ogni 5 minuti |
| Configurazione del webhook | Automatica, con il pulsante Create webhook |
| Credenziali | Chiave pubblica e chiave segreta da API gegevens |
| Firma delle richieste | HMAC-SHA512 su ogni chiamata API |
| Snippet della thank-you page | Pagina di successo dell’ordine, con Vertoshop.getOrder().getId() |
Come si collega CCV Shop
- Aggiungi lo script di ROASaurus a tutte le pagine: Mijn webshop › Instellingen › Lay-out › Layout › Header HTML, oppure un blocco di codice di un’app nell’header.
- Aggiungi lo snippet della pagina di ringraziamento alla pagina di successo dell’ordine.
- Mijn webshop › Instellingen › Algemeen › API gegevens: copia la chiave pubblica e la chiave segreta. Se non vedi API gegevens, installa prima l’app API.
- Inserisci entrambe le chiavi in ROASaurus, salva, poi premi Create webhook.
Cosa fa Create webhook
ROASaurus registra un webhook CCV per l’evento order paid. CCV segnala poi ogni ordine pagato immediatamente. Quando CCV restituisce un webhook secret, ROASaurus controlla la firma HMAC-SHA512 di ogni invio; ogni invio deve inoltre portare il token unico del tuo negozio. ROASaurus recupera poi dall’API l’ordine completo e le sue righe.
Ogni chiamata API di ROASaurus è firmata nel modo richiesto da CCV: un hash HMAC-SHA512 della tua chiave pubblica, del metodo, dell’indirizzo, del corpo e di un timestamp.
Il controllo ogni 5 minuti
ROASaurus chiede a CCV gli ordini pagati anche ogni 5 minuti. CCV filtra solo per data di creazione, quindi un ordine segnato come pagato giorni dopo essere stato effettuato viene rilevato dal webhook, non dal controllo.
Cosa legge ROASaurus da ogni ordine
Il numero d’ordine completo, il totale, la valuta, l’email del cliente, il numero di cellulare o di telefono, il nome, la città, il CAP e il paese di fatturazione, il customer id e ogni riga d’ordine con numero prodotto, quantità e prezzo.
Limiti
- Gli ordini CCV non includono l’indirizzo IP del cliente, quindi il ripiego sull’IP non è disponibile. Aggiungi lo snippet della pagina di ringraziamento.
- Tieni attivo il webhook: i pagamenti tardivi dipendono da lui.
- 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
Dove trovo le chiavi API di CCV Shop?
In Mijn webshop › Instellingen › Algemeen › API gegevens. Se quel menu manca, installa prima l’app API di CCV.
Cosa fa lo snippet della pagina di successo dell’ordine?
Legge l’order id con Vertoshop.getOrder().getId() e fa partire con esso l’acquisto in ROASaurus, collegando l’ordine al visitatore e al suo clic sull’annuncio.
Gli ordini pagati più tardi vengono comunque inviati?
Sì, tramite il webhook di ordine pagato. Il controllo ogni 5 minuti guarda solo gli ordini creati di recente, quindi tieni attivo il webhook.
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 →