En tant que client Avis Vérifiés, vous avez la possibilité de sonder vos consommateurs en intégrant un formulaire de dépôt d'avis volontaire sur votre site.
Cela vous permettra de solliciter de manière vos consommateurs de manière ponctuelle via une page dédiée.
N'hésitez pas à contacter de votre chargé de compte pour en savoir plus sur l'activation de cette fonctionnalité.
Etape 1 : Génération du formulaire
En appelant l’API avec des paramètres GET tels que décrit ci-dessous, l’utilisateur sera redirigé vers le formulaire affichant le ou les produit(s) de la requête ainsi que la partie marque si souhaitée.
URL d’accès à l’API
L’URL à utiliser dépend du pays sur lequel votre compte existe. En voici une liste non exhaustive, rapprochez-vous de votre chargé de compte si un pays n'apparaît pas. Cette URL est décrite par [URL] dans les exemples ci-dessous.
-
- France : https://avis2.avis-verifies.com
- Italie : https://recensioni2.recensioni-verificate.com
- Espagne : https://opiniones2.opiniones-verificadas.com
- Etats Unis : https://reviews2.verified-reviews.com
- Portugal : https://opinioes2.opinioes-verificadas.com
- Brésil : https://opinioes2.opinioes-verificadas.com.br
- Allemagne : https://echte2.echte-bewertungen.com
- …
Champs Principaux
Voici les champs relatifs à l'expérience de consommation :
| Paramètre | Description/Variable | Requis |
| Type | Toujours type=iframe | oui |
| Token | Permet de sécuriser l’appel via votre clé secrète | oui |
| idWebsite | Identifiant de votre compte | oui |
| lastname | Nom du consommateur | oui |
| firstname | Prénom du consommateur | oui |
| L'email du consommateur | oui | |
| request_products_only |
"false" : affiche la partie avis marque et produit "true" : affiche seulement la partie avis produit Important : "true" ou "false" doivent être au format string et non booléen. |
non, par défaut ‘false’.
|
Voici les champs relatifs au produit.
Vous pouvez afficher un formulaire avec un ou plusieurs produits. Pour cela, vous devez regrouper les informations de chaque produit grâce à un tableau tel que présenté ci-dessous. Le [x] est à remplacer par 0 pour le 1er produit, 1 pour le 2ème produit etc…
| Paramètre | Description | Requis |
| products[x] | Information du produit placé en [x] position (commence par 0, maximum 4) | oui |
| id_product[x] | Identifiant unique du produit [x] | oui |
| name_product[x] | Nom du produit [x] | oui |
| brand_name[x] | Marque du produit [x] | non |
| gtin_ean[x] | code-barres du produit [x] | non |
| url_image_product[x] | URL de l'image produit [x] | non |
| url_product [x] | URL de la fiche produit [x] | non |
&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][name_product]=Mountain Trainer Mid GORE-TEX® Chaussures Femme 0674 - 39
&products[0][url_image_product]=https://cdn1.mywebsite.com/media/image/0c/cd/aa/f16710fa-eebc-41d8-b681-5b7fbd5681.jpg
&products[0][url_product]=https://www.mywebsite.com/fr-fr/mountain-trainer-mid-gore-tex-chaussures-femme-00-0000063459
&products[0][brand_name]=MyBrand
&products[0][gtin_ean]=9002000004980
Etape 2 : Génération du token
Le token est un concaténation en SHA1 des champs idWebsite, secretKey et des identifiants produits, comme ci-dessous :
| token | SHA1(idWebsite + secretKey + concaténation sans séparateur des 'id_product') |
Précision : les + décrivent la concaténation, ils ne doivent pas être ajoutés dans le calcul.
Émettre une requête avec un produit
L’URL générée doit comporter un encodage (url_encode) sur les champs spéciaux du type crochet fermant, ouvrant, espace, point virgule, …
Si les paramètres sont corrects, une commande avec les données passées en paramètres sera enregistrée et vous serez redirigé vers le formulaire possédant son identifiant unique. Si les mêmes paramètres sont passés à nouveau, aucune commande ne sera enregistrée mais vous serez redirigé vers le formulaire déjà généré.
&idWebsite=8f461c92-6be9-cc84-f18e-14986d70f1be2
&token=791fa62b2a72aabaeab4af9f434c86af2017e73f
&lastname=dupont
&firstname=charles
&email=charlesi%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®+Chaussures+Femme+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/fr-fr/mountain-trainer-mid-gore-tex-chaussures-femme-00-0000063459
&products%5B0%5D%5Bbrand_name%5D=MyBrand
&products%5B0%5D%5Bgtin_ean%5D=9002000004980
Émettre une requête avec plusieurs produits
Si les paramètres sont corrects, une commande avec les données passées en paramètres sera enregistrée et vous serez redirigé vers le formulaire possédant son identifiant unique. Si les mêmes paramètres sont passés à nouveau, aucune commande ne sera enregistrée mais vous serez redirigé vers le formulaire déjà généré.
&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®+Chaussures+Femme+0674+-+39
&products%5B0%5D%5Burl_image_product%5D=https://cdn1.mywebsite.com/media/image/0c/cd/aa/f16710fa-eebc-41d8-b681-5b7fbd568149_.jpg
&products%5B0%5D%5Burl_product%5D=https://www.mywebsite.com/fr-fr/mountain-trainer-mid-gore-tex-chaussures-femme-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®+Chaussures+Femme+0674+-+39
&products%5B1%5D%5Burl_image_product%5D=https://cdn1.mywebsite.com/media/image/0c/cd/aa/f16710fa-eebc-41d8-b681-5b7fbd568149.
Attention le token doit comporter la concaténation de l’ensemble des identifiants produits id_product comme ci-dessous : sha1(idwebsiteSecretKey00-000006345900-0000063457)
soit le token suivant : eb793f440b5567b17bfdd22699b1bce2518573aa