Cet article a pour objectif de vous accompagner dans la mise en place de la configuration de votre flux de récupération d'avis en vous fournissant des instructions claires sur les étapes à suivre.
Il explique également en détail les termes techniques que vous pourriez rencontrer lors de la gestion de ce processus, afin de vous permettre de mieux les comprendre.
Fonctionnement
Les avis collectés sont transférés chaque nuit à 3h du matin sur le serveur FTP/SFTP de votre choix au format CSV ou XML.
Vous avez la possibilité de configurer à tout moment le flux de récupération au sein de votre Back Office (Affichage des avis → Récupérer vos avis → Gestion des flux), dont les identifiants resteront confidentiels.
Si nécessaire, nous pouvons également créer un compte FTP/SFTP sur nos serveurs, n'hésitez pas à nous contacter.
Configuration d'un flux
Voici les valeurs à renseigner :
| Format | Nous proposons deux formats : CSV et XML : La suite de cet article détaillera chacun de ces formats. |
| Méthode de transfert | Nous mettons à disposition deux méthodes de transfert de fichier FTP et SFTP. Attention, modifiez le Port en fonction de votre serveur. |
| Serveur | Spécification de l'adresse IP ou du host auquel nous allons nous connecter. |
| Identifiant | Identifiant de connexion à votre serveur FTP/SFTP (nous devons avoir les droits d’écriture). |
| Mot de passe | Mot de passe d’accès à votre compte FTP/SFTP. |
| Port | Port de communication de votre serveur FTP/SFTP. |
| Chemin du répertoire | Chemin dans lequel nous allons déposer vos fichiers. |
En configurant ce côté il faut choisir le bon type de flux :
Est-ce un flux FTP des avis site, avis produit, délivrabilité ou un flux des utilisateurs désabonnés ?
Pensez à activer le flux :
Vous pouvez ensuite :
- Tester la connexion » : Tester immédiatement que nous arrivons à nous connecter sur votre compte FTP/SFTP.
- «Test the reviews feed » : Envoyer immédiatement un flux de données vers le FTP/SFTP (quotidien ou intégral).
Interpréter une action NEW, DELETE, UPDATE
Chaque ligne du fichier FTP/SFTP ou nœud XML, des fichiers d'avis récupérés, possède un type indiquant l’action qui a été effectuée au sein de la base de données de votre compte Avis Vérifiés :
|
NEW |
Nouvel avis publié, vous devez ajouter cet avis à votre base de données |
| UPDATE |
L’avis a subi une modification, toutes les données de l’avis (données personnelles de l’acheteur, son avis, les réponses sur l’avis) doivent être mise à jour, cas d’exemple une réponse a été apportée à l’avis par l’enseigne ou le client ★ Si le consommateur nous demande l’anonymisation de ses données personnelles, les informations seront remplacées par Anonymous |
| DELETE | L’avis a été définitivement refusé, vous devez retirer cet avis de votre base de données |
- Un exemple d'un fichier CSV (converti en Excel) :
L'action "Update" est liée à une mise à jour effectuée au niveau d'un avis collecté sur la plateforme.
Cela peut être dû à une demande de l'auteur pour masquer son identité, ou bien à la mise en anonyme d'un avis, car nous ne conservons pas les données personnelles au-delà de 18 mois.
L'action "New" signifie qu'un nouvel avis a été déposé sur la plateforme et est passé en statut "publié".
- Un exemple d'un fichier XML :
Format des fichiers
- CSV
- Encodage : UTF8 sans-Bom
- Séparateur : ";" (semicolon separator)
- XML
- Encodage : UTF8 sans-Bom
Retrouvez des exemples de fichiers à télécharger ci-dessous :
Nommage des fichiers
Les fichiers sont nommés en respectant le format suivant :
- Avis marque : reviews_type_<idWebsite>_<date>.<file_type>
- Avis produit : reviews_product_<idWebsite>_<date>.<file_type>
| Champ | Valeur |
|---|---|
| Type |
Nature du contenu Exemple : site ou product |
|
IdWebsite |
Identifiant technique désigné par un code alphanumérique |
| Date |
Format de date Exemple : 2020-01-01 |
| File_type |
Format du fichier |