Como cliente de Opiniones Verificadas, tienes la posibilidad de encuestar a tus consumidores integrando un formulario de envío de opiniones voluntarias en tu sitio web.
Este artículo te explica el procedimiento de integración de un formulario de envío de opiniones voluntarias que permite al consumidor enviar:
-
una opinión sobre uno o varios productos;
-
una opinión sobre la marca (según la configuración).
Requisitos previos
Tener una cuenta de cliente en Avis Vérifiés.
Procedimiento
Paso 1: Generación del formulario
Principio de funcionamiento
Al llamar a la API con parámetros GET como se describe a continuación, el usuario será redirigido al formulario que muestra el o los producto(s) de la solicitud, así como la parte de la marca si así se desea.
URL de acceso a la API
La URL a utilizar depende del país en el que tengas tu cuenta. Aquí tienes una lista no exhaustiva, ponte en contacto con tu gestor de cuenta si un país no aparece. Esta URL está descrita como [URL] en los ejemplos a continuación.
-
- Francia: https://avis2.avis-verifies.com
- Italia: https://recensioni2.recensioni-verificate.com
- España: https://opiniones2.opiniones-verificadas.com
- Estados Unidos: https://reviews2.verified-reviews.com
- Portugal: https://opinioes2.opinioes-verificadas.com
- Brasil: https://opinioes2.opinioes-verificadas.com.br
- Alemania: https://echte2.echte-bewertungen.com
- …
Campos Principales
Aquí están los campos relacionados con la experiencia del consumidor:
| Parámetro | Descripción/Variable | Requerido |
| Tipo | Siempre tipo=iframe | sí |
| Token | Permite asegurar la llamada con tu clave secreta | sí |
| idWebsite | Identificador de tu cuenta | sí |
| lastname | Apellido del consumidor | sí |
| firstname | Nombre del consumidor | sí |
| Correo electrónico del consumidor | sí | |
| request_products_only |
"false" : muestra la parte de la marca y el producto "true" : muestra solo la parte del producto Importante: "true" o "false" deben estar en formato string y no booleano. |
no, por defecto ‘false’.
|
Aquí están los campos relacionados con el producto.
Puedes mostrar un formulario con uno o varios productos. Para ello, debes agrupar la información de cada producto mediante una tabla como se muestra a continuación. El [x] se debe reemplazar por 0 para el primer producto, 1 para el segundo producto, etc…
| Parámetro | Descripción | Requerido |
| products[x] | Información del producto ubicado en la posición [x] (comienza por 0, máximo 4) | sí |
| id_product[x] | Identificador único del producto [x] | sí |
| name_product[x] | Nombre del producto [x] | sí |
| brand_name[x] | Marca del producto [x] | no |
| gtin_ean[x] | Código de barras del producto [x] | no |
| url_image_product[x] | URL de la imagen del producto [x] | no |
| url_product [x] | URL de la ficha del producto [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][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
Paso 2: Generación del token
El token es una concatenación en SHA1 de los campos idWebsite, secretKey y de los identificadores de productos, como se muestra a continuación:
| token | SHA1(idWebsite + secretKey + concatenación sin separador de los 'id_product') |
Precisión: los + describen la concatenación, no deben ser añadidos en el cálculo.
Enviar una solicitud con un producto
La URL generada debe tener una codificación (url_encode) en los campos especiales del tipo corchete cerrado, abierto, espacio, punto y coma, …
Si los parámetros son correctos, se registrará un pedido con los datos proporcionados en los parámetros y se te redirigirá al formulario con su identificador único. Si se pasan los mismos parámetros de nuevo, no se registrará ningún pedido pero serás redirigido al formulario ya generado.
&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
Enviar una solicitud con varios productos
Si los parámetros son correctos, se registrará un pedido con los datos proporcionados en los parámetros y se te redirigirá al formulario con su identificador único. Si se pasan los mismos parámetros de nuevo, no se registrará ningún pedido pero serás redirigido al formulario ya generado.
&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.
⚠️ Ten en cuenta que el token debe incluir la concatenación de todos los identificadores de productos id_product como se muestra a continuación: sha1(idwebsiteSecretKey00-000006345900-0000063457)
por lo que el token será: eb793f440b5567b17bfdd22699b1bce2518573aa