V-TEX est une solution de type SaaS et intègre une API qui permet à Avis vérifiés de communiquer directement avec votre solution e-commerce. Une première configuration du module est nécessaire sur votre back-office Avis Vérifiés.
- Récupération quotidienne des commandes : Chaque jour, notre moteur récupère les commandes pour lesquelles nous devons envoyer des demandes d'avis, et cela en fonction de la configuration renseignée lors du paramétrage décrit dans la suite de ce document.
- Première récupération des commandes : Lors de votre première inscription sur notre plateforme et afin de récolter vos premiers avis, nous avons la possibilité de récupérer un certain nombre de commandes existantes (déjà réalisées) sur votre solution V-TEX directement depuis le back-office Avis Vérifiés.
- Affichage des avis sur votre site : Vous avez la possibilité de faire apparaitre les avis relatifs à vos produits directement sur vos fiches produits, pour cela nous vous mettons à disposition notre système tagJS, il suffira d’insérer un script JS et deux balises HTML sur votre site.
- Configuration du module sur Avis Vérifiés
- Récupération quotidienne des commandes
- Première récupération des commandes existantes
- Affichage des avis produits sur votre site
- Affichage des avis site
- Intégration de l’iframe Avis site
- Annexes
Configuration du module sur Avis Vérifiés
Paramètres de configuration
- Rendez-vous dans Config > Mon compte
- Vérifiez que la section VTEX Integration apparaît bien sur la page
Vous devez enregistrer vos identifiants V-TEX afin d’assurer la connexion entre notre plateforme et votre solution e-commerce :
- VTEX API URL : par défaut le champ « VTEX API URL » prend comme valeur l’URL API de votre environnement VTEX. Si cette donnée vous paraît incorrecte, vous pouvez la modifier.
- VTEX username : il s’agit de l'AppKey
- VTEX password : il s’agit de l'AppToken
- Vous pouvez choisir de collecter des avis sur vos produits ou non via une simple case à cocher « Recevoir les avis produits », et ce en plus de l’avis site.
- Optionnel : Si vous utilisez le mode multi-boutiques de V-TEX, utilisez le lien « Configurer le multiboutique » afin de régler l’automatisation sur la boutique concernée. Plus d’informations ici.
Cliquez sur le bouton « Enregistrer » en bas de page afin de sauvegarder vos modifications. Un message de succès en haut de page vous informera alors si le compte V-TEX a été correctement connecté, dans le cas contraire un message d’erreur apparaîtra.
Une fois cette configuration enregistrée, votre module est connecté et automatisé, nous recevrons automatiquement vos commandes quotidiennement.
Dans le cas où vous ne souhaitiez pas nous communiquer votre jeu d’identifiant principal V-TEX, il est possible de générer un jeu d’identifiants supplémentaire dans votre back-office V-TEX. L’accès au Master Data doit être inclus. Cliquez ici pour plus d’informations.
Que faire si la section “VTEX Integration” n’apparaît pas ?
Cela signifie que votre compte Avis Vérifiés n’a pas été configuré pour VTEX.
- Pour modifier cela, vous devez vous rendre dans Config > Mon compte > encart Mon Attestation > Solution eCommerce, choisir Vtex
- Enregistrer le changement en cliquant sur le bouton “Enregistrer” en bas de page.
Mode multi-boutique
Pour accéder à la configuration multi-boutique, vous devez cliquer sur “Configurer le multiboutique“ dans l’encart VTEX Integration dans Config > Mon compte.
Si plusieurs canaux de vente sont configurés dans votre compte VTEX, par défaut nous récupérerons les commandes de tous ces canaux.
Vous pouvez choisir de spécifier une boutique en particulier. Nous ne récupérerons alors que les commandes associées à cette boutique.
Accès au Master Data
VTEX dispose d’un système de cryptage de mails. Pour que nous puissions obtenir les mails de vos clients en clair et que votre suivi soit simplifié, vous devez inclure le Product MasterData dans le role qui a été attribué à l'appKey/appToken indiqués dans l’encart VTEX Integration.
Lorsque vous enregistrez vos identifiants dans Config > Mon compte > VTEX Integration puis cliquez ensuite en bas de page sur “Enregistrer” pour sauver vos modifications, nous effectuons un test de connexion avec votre boutique et nous vérifions si nous avons accès au Master Data. Si nous n’y avons pas accès, nous vous le spécifions dans le message qui s’affiche en haut de page : "La connexion avec votre site VTEX s'est bien déroulée.Cependant, l'appKey et l'appToken renseignés n'ont pas l'autorisation pour accéder au master data et récupérer les mails de vos clients décryptés. Veuillez modifier les autorisations dans votre back-office Vtex."
Comment modifier les autorisations ?
- Rendez-vous dans le Back-Office VTEX dans l’onglet Account
- Copiez la appKey que vous avez indiquée dans votre compte Avis Vérifiés, située dans la colonne Access key
- Rendez-vous ensuite dans l’onglet Users (toujours dans la section Account management)
- Recherchez la clé que vous venez de copier dans la barre de recherche
- Vérifiez le role qui lui a été attribué. Ex : pour cette appKey, le role attribué est “Netreviews”
- Rendez-vous ensuite dans l’onglet Roles (toujours dans la section Account management)
- Identifiez le Role (Netreviews dans notre exemple)
- Cliquez dessus pour voir le détail des Produits autorisés
- Le Product Master Data doit être inclus. S’il ne l’est pas, cliquez sur “Configure another Product” en bas de la liste pour l’ajouter.
- Une fois que vous avez ajouté l’autorisation d’accès au Master Data, vous pouvez retester la connexion en cliquant sur “Enregistrer” en bas de page Config > Mon compte sur votre compte Avis Vérifiés. Le message d’avertissement devrait avoir disparu.
Récupération quotidienne des commandes
Les commandes récupérées chaque jour par notre système sont les commandes en statut « Invoiced » avec un « invoice_date » correspondant à la date de la veille. Voici le schéma des différents statuts d’une commande dans le système V-TEX :
Une fois le module paramétré comme vu dans la partie précédente, vous n’avez rien à faire, les commandes seront automatiquement récupérées une fois par jour.
Première récupération des commandes existantes
Lors de votre première inscription sur notre plateforme et afin de récolter vos premiers avis, nous avons la possibilité de récupérer un certain nombre de commandes existantes (déjà réalisées) sur votre solution V-TEX directement depuis le back-office Avis Vérifiés (Par exemple vos 2 / 3 / 6 derniers mois de commandes).
- Rendez-vous dans le menu : Activez l'essai > Export des commandes VTEX
- Sur cette page, vous pouvez préciser une plage de dates pour cibler les commandes à récupérer, le statut de la commande et la récupération ou non des avis produits.
- Après l'export, les commandes seront affichées dans un tableau et vous aurez le choix d'envoyer les demandes d'avis au cas par cas.
Affichage des avis produits sur votre site
Via l'app
Remarque : Vous devrez peut-être ajuster les éléments suivants en fonction de votre thème
Store-theme classique :
- Tout d'abord, ajoutez le module Avis vérifiés en tant que dépendance dans votre boutique. Pour ce faire, ajoutez "verifiedreviews.netreviews": "1.x" à la liste des dépendances dans votre manifest.json (attention, vous devez ajouter le connecteur dans la clé "peerDependencies" et non pas dans "dependencies")
- Accédez à votre modèle product.json
- Sous "flex-layout.col#right-col", "children", insérez le bloc "netreviews-rating" où vous souhaitez afficher la note
- Sous "store.product", "children", insérez le bloc "netreviews-reviews" où vous souhaitez afficher les avis
- Ajoutez votre API KEY, SECRET KEY et définissez la langue de l'application dans APP > Mes applications > Module Netreviews > Paramètres
- Si vous avez installé l'application « Reviews and Ratings » sur votre boutique, vous devrez la désinstaller dans APP > Mes applications
Via TagJS
Vous avez la possibilité de faire apparaitre les avis relatifs à vos produits directement sur vos fiches produits, pour cela nous vous mettons à disposition notre système TagJS, il suffira d’insérer un script JS et deux balises HTML dans votre code.
👉 Pour afficher les avis produits sur votre site internet :
- Rendez-vous sur votre compte Avis Vérifiés dans le menu : Intégration > Applications
- Déplier la section « Afficher mes avis produits via TagJS », cliquer sur « Activer la fonctionnalité »
- Suivez les étapes indiquées une par une, en intégrant d’abord le script JS dpuis les deux balises HTML indiquées dans vos templates HTML du site
Une fois ces étapes réalisées et la mise en cache de vos avis sur nos serveurs terminée, vos avis produits doivent s’afficher sur vos fiches produits. Dans le cas contraire, n’hésitez pas à nous contacter afin que nous vous assistions dans cette mise en place des avis.
Affichage des avis site
Mise en place du widget avis site
Vous avez la possibilité de faire apparaitre un widget fixe ou flottant sur votre site. Ce widget permet d’afficher à vos visiteurs votre note globale moyenne Avis vérifiés et rassure ainsi le potentiel client sur la qualité de vos services.
👉 Pour récupérer le code de votre widget fixe ou flottant :
- Accédez à votre compte Avis Vérifiés et cliquez sur « Intégration > Intégration Widget Site ».
- Choisissez le widget que vous préférez, définissez son type (widget flottant ou fixe) puis choisissez l’affichage, la position et le type d’ouverture de l’attestation, et enfin cliquez sur « Créer le widget ».
Vous pouvez combiner les widgets, par ex un widget flottant pour Desktop et un autre pour mobile.
Widget flottant qui s’affichera sur Desktop et sur mobile
Widget flottant qui s’affichera seulement sur Desktop
Widget flottant qui s’affichera seulement sur mobile
- Le widget que vous venez de créer s’affiche en haut de la page dans la section “MES WIDGETS”, cliquez sur « Intégrer » et copiez le code du premier encart ”Récupération du code widget” (sauf exceptions).
- Une fois le code du widget récupéré, rendez-vous dans votre back-office V-TEX dans le menu : Store Setup > CMS > Layout. C’est ici que vous pouvez modifier les templates HTML du site. Choisissez le template qui vous convient en le sélectionnant dans CMS > HTML Templates (footer pour un widget flottant par exemple) et insérez le code du widget.
Une fois ces étapes réalisées, votre widget doit s’afficher sur votre site. Dans le cas contraire, n’hésitez pas à nous contacter afin que nous vous assistions dans cette mise en place du widget.
Vous devez avoir collecté au moins 3 avis site afin de pouvoir générer votre premier widget, ces avis sont nécessaires au calcul de la note moyenne de votre site.
Modifications des Widgets
Pour modifier un widget déjà créé, rendez-vous dans la section « Intégration > Intégration Widget Site > Mes Widgets » et effectuez les modifications voulues sur le widget de votre choix puis cliquez sur « Mettre à jour ». Nous avons du cache sur les widgets, les modifications n’apparaîtront pas immédiatement sur votre site.
Intégration de l’iframe Avis site
Dès lors que vous avez récolté plus de trois avis site vous pouvez ajouter un iframe sur votre site qui affiche directement les avis site récoltés .
- Accédez à votre compte Avis Vérifiés et cliquez sur « Intégration > Intégration Widget Site » puis dans la section « Widget iFrame Vertical » ou « Widget iFrame Horizontal ».
- Choisissez le widget que vous préférez et cliquez sur le bouton « Créer mon Widget », puis copiez le code de l’iFrame et collez-le dans l’emplacement de votre site où vous voulez l’afficher. A la différence du widget, l’iframe n’est pas envoyé dans la configuration du module.
👉 Vous pouvez personnaliser quelques caractéristiques de l’iframe avec les différentes options présentées sous le code, puis cliquer sur le bouton « Mettre à jour ».
👉 Si vous souhaitez personnaliser le CSS de l’iframe, vous pouvez ajouter vos règles CSS dans le bloc “Personnalisation css”, puis cliquer sur le bouton « Mettre à jour ».
Un cache est présent sur les iframes. Il est possible que votre personnalisation ne soit pas visible immédiatement.
Annexes
📍 Suivi des demandes d’avis
Vous pouvez suivre les demandes d’avis envoyés à vos clients depuis « Stats > Reporting - Demandes d’avis ».
Vous pouvez faire une recherche spécifique en utilisant les filtres en haut de la page.
📍 Suivi des avis
Vous pouvez suivre vos avis publiés, en modération et refusés dans le menu « Avis ».
Vous pouvez faire une recherche spécifique en utilisant les filtres en haut de la page.