Si vous souhaitez créer une TrustBox personnalisée pour afficher vos avis et notes Trustpilot sur votre site internet, vous pouvez en créer une à l'aide de nos API. Découvrez comment commencer dans cet article.

La configuration requiert des connaissances techniques, alors pensez à demander de l'aide à votre développeur.

Unités commerciales

Avant de commencer à présenter le contenu des avis Trustpilot, il est important de savoir comment nous identifions les domaines via les Business Unit ID, également appelés BUID. La Business Unit, ou unité commerciale, correspond au point de collecte de tout le contenu Trustpilot d'un site internet. En d'autres termes, elle héberge la note d'une entreprise, ses avis et ses réponses. Le BUID est un identifiant unique pour cette unité commerciale et constitue la clé primaire dans bon nombre de vos API calls. Lisez cet article pour en savoir plus sur les BUID.

Trouver un BUID

Votre Business Unit ID est un identifiant unique spécifique à votre domaine. Il est statique et ne changera que si votre domaine sur Trustpilot change. Pour trouver le BUID de votre domaine, vous devez utiliser l'endpoint « Find a business unit ». Le paramètre requis ici est le « nom » de l'unité commerciale, c.-à-d. le domaine de votre site internet. À titre d'exemple rapide, si vous souhaitez rechercher le BUID de Trustpilot, saisissez « trustpilot.com ».

Essayez vous-même et pensez à remplacer la clé API.

https://api.trustpilot.com/v1/business-units/find?apikey={{apikey}}&name=trustpilotdemo.com

Après avoir reçu la réponse, vous devrez trouver le champ « id ». Ceci est votre BUID pour le domaine que vous venez de rechercher.

Extraire des avis

Une fois que vous avez le BUID de votre domaine, vous pouvez commencer à extraire vos avis, notes et réponses à ces avis en utilisant l'API call Get a business unit’s Reviews.

Si vous souhaitez simplement extraire les informations publiques sur l'unité commerciale (c'est-à-dire la note en étoile, le nombre d'avis, le TrustScore, etc.), ces données sont disponibles dans l'endpoint Find a business unit répertorié ci-dessus. Vous pouvez également utiliser Get public business unit.

Directives d'intégration personnalisées

Afin de vous assurer que vous vous conformez à nos directives, nous vous suggérons de consulter notre document d'assistance détaillé sur les API de Trustpilot - Directives d’intégration pour les avis marchands.

Voici quelques points clés à retenir :

• Vous devez toujours divulguer le type d'avis que vous affichez. Par exemple, si vous n'affichez que des avis 4 et 5 étoiles, vous devez l'indiquer.
• N'affichez pas votre clé API dans le frontend. Cela signifie que vous ne devez effectuer que des API calls à partir du backend, puis transmettre les données au frontend pour affichage.
• Pour éviter les problèmes de limitation, ne lancez pas d'API call à chaque chargement de la page : mettez en cache les données de votre côté et mettez-les à jour toutes les 30 minutes/1 heure/24 heures, etc. Vous pouvez également utiliser nos webhooks pour mettre à jour les avis en temps réel.
• Le texte de l'avis dans vos TrustBoxs ne doit pas être indexable par Google. Cela permet d'éviter que les pénalités de contenu en double ne nuisent à votre classement dans les moteurs de recherche. Hébergez plutôt vos widgets sur une page séparée (par exemple, un sous-domaine) où vous avez un tag <meta name="robots" content="noindex"> dans la section « head ». À partir de là, vous pouvez utiliser un <iframe> pour afficher le widget TrustBox sur votre site web principal.

API calls côté serveur

Tous les API calls doivent être effectués côté serveur pour assurer la sécurité. Cela garantira ainsi que votre clé API privée n'est pas exposée sur votre site internet et peut également aider à améliorer les vitesses de chargement des pages/à réduire les coûts du réseau.

Mise en cache des API calls

Lorsque vous affichez des TrustBoxs personnalisées sur votre site, nous vous recommandons de mettre en cache les données. La mise en cache augmente les performances et la fiabilité. Les performances sont meilleures car la source des données mises en cache peut être plus proche du consommateur et le cache peut traiter les demandes de données dupliquées, évitant ainsi les calculs et le trafic réseau inutiles. La fiabilité est accrue car le consommateur de données est isolé des interruptions de service depuis l'origine.