Il est possible de récupérer dynamiquement les avis produits ainsi que certaines métriques (note moyenne par produit, avis par produit etc...).
Merci de suivre ces étapes :
1. Se connecter à votre espace et cliquez sur Récupérer mes avis.
2. Cocher le type de données désiré.
3. Enregistrer la configuration.
4. Si c'est la 1ère récupération, cliquer sur Générer tous les fichiers.
Ne pas oublier de sauvegarder les paramètres en bas de la page.
Fonctionnement
Les ressources du Webservice produit sont mises à jour chaque nuit à 3h du matin et disponibles pour chacune des données de transaction dans le format de votre choix :
- CSV
- XML
- JSON
Vous pouvez générer à tout moment le flux de restitution au sein de votre espace (Intégration → Récupérer vos avis → API) dont l'URL d'accès vous est propre grâce à votre identifiant (idWebsite).
Il est ainsi possible d'obtenir :
- Les notes moyennes et nombre d’avis pour tous les produits
- Les avis par produit
- La note moyenne et nombre d'avis par produit
- Liste des produits ayant au moins un avis ainsi que la date de mise à jour
Les fichiers sont générés toutes les nuits, en revanche si vous venez d'activer la génération, il sera nécessaire de patienter de quelques minutes.
*<code_lang> : Code langue ISO 639-1 (ex: fr, en, it, de etc...)
Nomenclature
Chaque fichier aura une URL d'appel propre, sous la forme suivante :
https://cl.avis-verifies.com/fr/cache/[i]/[d]/[W]/[idWebsite]/AWS/PRODUCT_API/[type_de_données]/[id_produit].[format]
Ou
https://cl.avis-verifies.com/fr/cache/[i]/[d]/[W]/[idWebsite]/AWS/PRODUCT_API/[type_de_données]/all_products.[format]
Dans lesquelles, [i], [d] & [W] sont les 3 premiers caractères de l'idWebsite et [format] est le format de fichier choisi (csv, JSON ou XML).
Note moyenne et nombre d’avis pour tous les produits
Cette ressource liste tous les id_product ayant au moins un avis et indique sa note sur et nombre d’avis. Utilisez cette ressource pour afficher les notes sur une liste de produits par exemple.
{ "3819":
{
"id_product":"3819",
"rate":"5",
"nb_reviews":"1" },
"50404":
{
"id_product":"50404",
"rate":"1",
"nb_reviews":"1"
}
}
Avis par produit
Ces ressources listent les avis collectés sur un produit que vous pouvez afficher publiquement. Ces avis ont passé nos filtres de modération et sont anonymisés (1ère lettre du nom et prénom). Utilisez cette ressource pour afficher les avis sur une fiche produit.
Pour retrouver un exemple, rendez-vous sur cette page et rechercher "Products Reviews Web Ressources - Reviews list by product".
Note moyenne et nombre d’avis par produit
Ces ressources identifiées par id_product permettent d’obtenir la note et nombre d’avis d’un produit. Utilisez cette ressource pour afficher la note et nombre d’avis d’un produit dans la partie supérieure de la fiche produit ou pour alimenter vos contenus enrichis (rich-snippets) par exemple.
Pour retrouver un exemple, rendez-vous sur cette page et rechercher " Products Reviews Web Ressources - Rate and count by product".
Liste des produits ayant au moins un avis ainsi que la date de mise à jour
Cette ressource (.txt uniquement) liste les produits ayant au moins un avis ainsi que sa date de dernière mise à jour. Utilisez cette ressource pour connaitre la liste des produits ayant des avis avant d’appeler une des ressources décrites ci-dessus.
La date de dernière mise à jour vous permet de mettre à jour votre cache local uniquement si le produit a subi un changement de note ou nombre d’avis.
Pour retrouver un exemple, rendez-vous sur cette page et rechercher " Products Reviews Web Ressources - list of files with reviews".