Area Developer

Integrando la nostra Invitation Api, invieremo in automatico per te una mail di invito alla recensione ai tuoi clienti, ogni qualvolta acquisteranno sul tuo e-commerce. Anche sulle recensioni parte di questo processo di invito verrà apposto il sigillo di "recensione certificata" in quanto conseguente a un reale acquisto effettuato sul tuo e-commerce.

HTTP method: POST
Request Content type: JSON
URL: https://business.eshoppingadvisor.com/api.invitation

Request:

{
'merchant_code' : 'esaxxxxxxxx', // codice che trovi nella tua area riservata
'api_token' : 'xxxxxxxxxxxxxxx', // token che trovi nella tua area riservata
'order_reference' : '12/2018' // riferimento ordine
'order_date' : '11/01/2024', //data ordine
'customer_email' : 'test@example.it', //email del cliente
'customer_firstname' : 'Mario', // nome cliente
'customer_lastname' : 'Rossi', // cognome cliente
'days_after_send' : '2', // numero giorni ritardo spedizione invito
'cell' : '+39328123456', // numero cellulare con prefisso internazionale
'send_type' : '0', // tipo invito: 0 => email, 1 => sms, 2 => email + sms
'lang' : 'it',
'test' : '1', // aggiungere questo parametro SOLO in fase di TEST
'products' : [{"id" : "id prodotto","name" : "nome prodotto","img_prod" : "url immagine prodotto"}] // elenco dei prodotti inseriti nell'ordine
}

Response:

{
'status' : 'success'
}

Integrando la nostra Invitation link Api, potrai ottenere un link codificato da inviare in autonomia ai tuoi clienti all'interno di una email di invito alla recensione ogni qualvolta acquisteranno sul tuo e-commerce. Anche sulle recensioni parte di questo processo di invito verrà apposto il sigillo di “recensione certificata” in quanto conseguente a un reale acquisto effettuato sul tuo e-commerce.

HTTP method: POST
Request Content type: JSON
URL: https://business.eshoppingadvisor.com/api.invitationLink

Request:

{
'merchant_code' : 'esaxxxxxxxx', // codice che trovi nella tua area riservata
'api_token' : 'xxxxxxxxxxxxxxx', // token che trovi nella tua area riservata
'order_reference' : '12/2018', // riferimento ordine
'customer_email' : 'test@example.it', //email del cliente
'customer_lastname' : 'Rossi', // cognome cliente
'lang' : 'it'
'test' : '1' // aggiungere questo parametro SOLO in fase di TEST
}

Response:

{
'status' : 'success'
}

Integrando i nostri Snippet (frammento di codice) nel tuo sistema di conferma acquisto via mail, verranno da noi inviate automaticamente le richieste di recensione ai tuoi clienti successivamente all’ordine. Anche sulle recensioni parte di questo processo di invito verrà apposto il sigillo di "recensione certificata" in quanto conseguente a un reale acquisto effettuato sul tuo e-commerce.

Per iniziare ad inviare gli inviti ai tuoi clienti, aggiungi invitation@eshoppingadvisor.com come destinatario in ccn (copia conoscenza nascosta) negli ordini di conferma che invii ai tuoi clienti.

Come funziona?
Quando i clienti effettuano un ordine d’acquisto, ricevono conferma dell’ordine tramite email. Poiché eShoppingAdvisor è un destinatario in cnn di quest’email, il nostro sistema è in grado di usare l’email per creare un invito alla recensione: a tal fine dovrai includere nel codice sorgente della tua conferma dell’ordine uno Snippet di Dati Strutturati.

<!-- <script type='application/json+eshoppingadvisor'>
{
'merchant_code' : 'esaxxxxxxxx', // codice che trovi nella tua area riservata
'api_token' : 'xxxxxxxxxxxxxxxxxxxxxxxx', // codice che trovi nella tua area riservata
'order_reference' : '120/2018', // riferimento ordine
'order_date' : '12/02/2018', //data ordine<
'customer_email' : 'mario.rossi@gmail.it', //email del cliente
'customer_lastname' : 'Rossi', // cognome cliente
'days_after_send' : '10',
'lang' : 'it',
'products' : '[{"id" : "id prodotto","name" : "nome prodotto","img_prod" : "url immagine prodotto"}]',
}
</script> -->

Integrando la nostra API potrai ottenere il tuo rating e il numero delle recensioni raccolte su eShoppingAdvisor. La funzionalità per ottenere la valutazione dei prodotti è disponibile solo per gli eshop COMPANY ed ENTERPRISE. Impostando il parametro "product_rating" a 1 potrai invece ottenere la valutazione di un tuo prodotto, di cui dovrai indicare l'id nel campo "product_id", e il numero di recensioni raccolte.

HTTP method: POST
Request Content type: JSON
URL: https://business.eshoppingadvisor.com/api_rating

Request:

{
'merchant_code' : 'esaxxxxxxxx', // codice che trovi nella tua area riservata
'api_token' : 'xxxxxxxxxxxxxxx', // token che trovi nella tua area riservata
'product_rating' : 0, 0 = ESA score e numero recensioni eshop; 1 = Valutazione prodotto e numero recensioni prodotto
'product_id' : id prodotto
}

Response:

{
'rating' : 'Valutazione'
'n_reviews' : 'Numero recensioni'
'status' : 'OK/ERROR'
'status_message' : 'Messaggio di risposta'
}