In qualità di cliente Recensioni Verificate, hai la possibilità di sondare i tuoi consumatori integrando un formulario per il deposito volontario delle recensioni sul tuo sito.
Questo articolo ti spiega la procedura d'integrazione di un formulario di deposito volontario delle recensioni che consente al consumatore d'inviare:
-
una recensione su uno o più prodotti;
-
una recensione sul marchio (in base alla configurazione).
Prerequisiti
Avere un account Recensioni Verificate.
Procedura
Step 1: Generazione del formulario
Principio di funzionamento
Chiamando l'API con i parametri GET come descritto di seguito, sarai reindirizzato al formulario che mostra il/i prodotto/i della richiesta e, se desiderato, la parte relativa al marchio.
URL di accesso all'API
L'URL da utilizzare dipende dal paese in cui è attivo il tuo account. Ecco un elenco non esaustivo, contatta il tuo referente se un paese non compare. Questo URL è indicato come [URL] negli esempi seguenti.
-
- Francia : https://avis2.avis-verifies.com
- Italia : https://recensioni2.recensioni-verificate.com
- Spagna : https://opiniones2.opiniones-verificadas.com
- Stati Uniti : https://reviews2.verified-reviews.com
- Portogallo : https://opinioes2.opinioes-verificadas.com
- Brasile : https://opinioes2.opinioes-verificadas.com.br
- Germania : https://echte2.echte-bewertungen.com
- …
Campi Principali
Ecco i campi relativi all'esperienza di consumo:
| Parametro | Descrizione/Variabile | Richiesto |
| Tipo | Sempre tipo=iframe | sì |
| Token | Permette di proteggere la chiamata tramite la tua chiave segreta | sì |
| idWebsite | Identificativo del tuo account | sì |
| cognome | Cognome del consumatore | sì |
| nome | Nome del consumatore | sì |
| L'email del consumatore | sì | |
| request_products_only |
"false" : mostra la sezione recensione del marchio e del prodotto "true" : mostra solo la sezione recensione del prodotto Importante: "true" o "false" devono essere nel formato stringa e non booleano. |
no, di default 'false'.
|
Ecco i campi relativi al prodotto.
Puoi visualizzare un modulo con uno o più prodotti. Per farlo, devi raggruppare le informazioni di ogni prodotto tramite una tabella come mostrato di seguito. Il [x] deve essere sostituito con 0 per il primo prodotto, 1 per il secondo prodotto, ecc…
| Parametro | Descrizione | Richiesto |
| products[x] | Informazioni del prodotto posizionato nella posizione [x] (inizia da 0, massimo 4) | sì |
| id_product[x] | Identificativo unico del prodotto [x] | sì |
| nome_prodotto[x] | Nome del prodotto [x] | sì |
| nome_marca[x] | Marca del prodotto [x] | no |
| gtin_ean[x] | Codice a barre del prodotto [x] | no |
| url_immagine_prodotto[x] | URL dell'immagine del prodotto [x] | no |
| url_prodotto [x] | URL della scheda prodotto [x] | no |
&idWebsite=8f4gds92-6be9-cc84-f18e-1498dsf701be2
&token=791fa62b2a72aabaeab4af9f434c86af2017e73f
&lastname=dupont
&firstname=charles
&email=charles@avis-verifies.com
&request_products_only=true
&products[0][id_product]=00-0000063459
&products[0][nome_prodotto]=Mountain Trainer Mid GORE-TEX® Scarpe Donna 0674 - 39
&products[0][url_immagine_prodotto]=https://cdn1.mywebsite.com/media/image/0c/cd/aa/f16710fa-eebc-41d8-b681-5b7fbd5681.jpg
&products[0][url_prodotto]=https://www.mywebsite.com/it-it/mountain-trainer-mid-gore-tex-scarpe-donna-00-0000063459
&products[0][nome_marca]=MioMarchio
&products[0][gtin_ean]=9002000004980
Step 2: Generazione del token
Il token è una concatenazione in SHA1 dei campi idWebsite, secretKey e degli identificatori dei prodotti, come mostrato di seguito:
| token | SHA1(idWebsite + secretKey + concatenazione senza separatore degli 'id_product') |
Precisione: i + indicano la concatenazione e non devono essere aggiunti nel calcolo.
Effettuare una richiesta con un prodotto
L'URL generato deve contenere una codifica (url_encode) sui campi speciali come parentesi quadra chiusa, aperta, spazio, punto e virgola, ecc.
Se i parametri sono corretti, verrà registrato un ordine con i dati passati come parametri e sarai reindirizzato al modulo che ha il suo identificativo univoco. Se gli stessi parametri vengono passati di nuovo, nessun ordine verrà registrato, ma verrai comunque reindirizzato al modulo già generato.
Effettuare una richiesta con più prodotti
Se i parametri sono corretti, verrà registrato un ordine con i dati passati come parametri e sarai reindirizzato al modulo che ha il suo identificativo univoco. Se gli stessi parametri vengono passati di nuovo, nessun ordine verrà registrato, ma verrai comunque reindirizzato al modulo già generato.
&idWebsite=8f461c92-6be9-cc84-f18e-14986d701be2
&token=eb793f440b5567b17bfdd22699b1bce2518573aa
&lastname=dupont
&firstname=charles
&email=charles%40avis-verifies.com
&request_products_only=true
&products%5B0%5D%5Bid_product%5D=00-0000063459
&products%5B0%5D%5Bname_product%5D=Mountain+Trainer+Mid+GORE-TEX®+Scarpe+Donna+0674+-+39
&products%5B0%5D%5Burl_image_product%5D=https://cdn1.mywebsite.com/media/image/0c/cd/aa/f16710fa-eebc-41d8-b681-5b7fbd5681.jpg
&products%5B0%5D%5Burl_product%5D=https://www.mywebsite.com/it-it/mountain-trainer-mid-gore-tex-scarpe-donna-00-0000063459
&products%5B0%5D%5Bbrand_name%5D=MyBrand
&products%5B0%5D%5Bgtin_ean%5D=9002000004980-8
&products%5B1%5D%5Bid_product%5D=00-0000063457
&products%5B1%5D%5Bname_product%5D=Mountain+Trainer+Mid+GORE-TEX®+Scarpe+Donna+0674+-+39
&products%5B1%5D%5Burl_image_product%5D=https://cdn1.mywebsite.com/media/image/0c/cd/aa/f16710fa-eebc-41d8-b681-5b7fbd568149.
⚠️ Attenzione, il token deve contenere la concatenazione di tutti gli identificatori dei prodotti id_product come mostrato di seguito: sha1(idwebsiteSecretKey00-000006345900-0000063457)
quindi il token sarà: eb793f440b5567b17bfdd22699b1bce2518573aa