Comment intégrer un formulaire de dépot volontaire sur mon site ?

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.

Cet article vous explique la procédure d’intégration d’un formulaire de dépôt d’avis volontaire permettant au consommateur de déposer :

  • un avis sur un ou des produits ;

  • un avis marque (en fonction de la configuration).

⚠️ Merci de vous rapprocher de votre chargé de compte pour l'activation de cette fonctionnalité.

Pré-requis

Avoir un compte client chez Avis Vérifiés.

Procédure

Etape 1 : Génération du formulaire

Principe de fonctionnement

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
email 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’. 


Important : cette configuration nécessite l’accompagnement par votre chargé de compte

 

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

 

👉 Exemple d’une URL de dépôt d’avis produit (sans avis marque) non fonctionnelle car les paramètres GET devraient être encodés (url_encode). Ils sont laissés “en clair” dans cet exemple pour une meilleure lisibilité: https://[URL]/index.php?type=iframe
&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.

👉 Exemple : SHA1(14b568b3-a9ea-4fb1-a20d-4c8d567359644fb1-a20d-14b568b3-c8d567-a9ea00-0000063459)

 

É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é.

 

👉 Voici un exemple de génération d’une URL de dépôt volontaire possédant des paramètres GET encodés donc fonctionnelle. Pour réutiliser celle-ci, vous devez renseigner [URL], modifier &idWebsite et calculer le bon &token. https://[URL]/index.php?type=iframe
&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é.

👉 Plusieurs produits peuvent être ajoutés dans l’URL comme présenté ci-dessous : https://avis2.avis-verifies.com/index.php?type=iframe
&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

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 0