API di Trustpilot - Linee guida per l’integrazione delle Recensioni dei Servizi

Questa funzione fa parte del modulo aggiuntivo Connect.

Ottieni il modulo

Versione 2.6 - 19 settembre 2018

Desideri creare un'integrazione o un widget personalizzato che mostri i dati sulla recensione dei tuoi servizi? Le nostre linee guida per le integrazioni ti aiuteranno ad implementare il contenuto delle recensioni su Trustpilot e a mostrare correttamente il nostro logo e le immagini. Per saperne di più al riguardo, leggi qui. 

Importante: queste linee guida si applicano a chiunque abbia il permesso di utilizzare le nostre API. Trustpilot si riserva il diritto di revocare il tuo accesso alle API in caso di violazione di tali linee guida. Se vuoi assicurarti di mostrare sempre dati che siano in conformità con le nostre linee guida, ti raccomandiamo di usare uno dei nostri TrustBox.

Requisiti per i contenuti

È importante rispettare i requisiti per i contenuti di Trustpilot quando utilizzi le nostre API. Ecco qui dei suggerimenti:

Cose che puoi fare

  • Archiviare i tuoi dati sul tuo sistema di backend, in modo da poter mostrare recensioni o valutazioni sul tuo sito. Assicurati di aggiornare il sistema regolarmente, utilizzando preferibilmente i webhook.
  • Mostrare il tuo punteggio generale in maniera accurata sotto forma di valutazione in stelle (immagine delle stelle), TrustScore (numero) o classificazione delle stelle (testo).
  • Mostrare il numero totale delle tue recensioni.
  • Indicare quali recensioni vengono mostrate in un widget nel seguente modo: 
    • Se intendi visualizzare tutte le recensioni, mostra il testo "Le nostre recensioni più recenti".
    • Se intendi visualizzare le recensioni per valutazione in stelle, modifica il testo in "Le nostre recensioni a X e X stelle" in base alle valutazioni in stelle che hai scelto. Ad esempio, se intendi visualizzare solo recensioni a 5 stelle, mostra il testo "Le nostre recensioni a 5 stelle".
    • Se intendi visualizzare le tue recensioni preferite o quelle contenenti tag, mostra il testo "Le nostre recensioni preferite".
  • Inserire un link a Trustpilot, così che i clienti possano leggere le tue recensioni per intero.

Cose che non puoi fare

  • Modificare il contenuto di una recensione, inclusi il punteggio, il testo, l'autore, la data, ecc.
  • Rendere pubbliche informazioni personali come gli indirizzi email dei clienti o i numeri di riferimento.
  • Mostrare le informazioni in modo calunnioso, diffamatorio, osceno, denigratorio o discriminatorio.
  • Indicizzare recensioni per ottenere i Rich Snippet o mostrarle come se fossero contenuti di tua proprietà.
  • Condividere la tua API key con parti terze che non sono coinvolte nello sviluppo della tua API.

NB: non è necessario mostrare il tuo posizionamento in categoria, ma se lo fai, assicurati che sia corretto.

Ecco una panoramica su una parte della nostra terminologia: 

Come mostrare correttamente il tuo TrustScore complessivo:

Requisiti per la SEO

Rispetta i requisiti di Trustpilot per la SEO per evitare di ricevere penalizzazioni relative ai contenuti doppi e danneggiare il tuo posizionamento nei motori di ricerca.

Cose che puoi fare

  • Caricare dinamicamente i dati con JavaScript da un sito dove il robots.txt impedisce ai motori di ricerca di indicizzare il JavaScript. Ad esempio, puoi caricare i dati lato cliente dinamicamente, attraverso le API di Trustpilot su developers.trustpilot.com.
  • Utilizzare un Iframe nei casi in cui la pagina incorniciata non è indicizzabile dai motori di ricerca. Ad esempio, puoi "non indicizzare" la pagina incorniciata oppure puoi caricare in remoto la pagina incorniciata da un sito dove robots.txt impedisce al motore di ricerca di indicizzarla.

Cose che non puoi fare

  • Includere le recensioni di Trustpilot direttamente nel tuo codice sorgente.
  • Non marcare il tuo TrustScore per ottenere Stelle dei Rich Snippet sul tuo sito. Per maggiori informazioni, leggi il post sul nostro blog che spiega come i cambiamenti apportati da Google sui Rich Snippet si ripercuotono sui clienti di Trustpilot.

Requisiti per il branding

Seguire la style guide di Trustpilot ti permette di dare credibilità alle tue recensioni, dimostrando che esse provengono da una fonte esterna, affidabile e indipendente.

Cose che puoi fare

  • Includere almeno un logo di Trustpilot in ogni pagina in cui sono mostrate le recensioni o le valutazioni.
  • Posizionare il logo vicino al TrustScore complessivo o alle recensioni.

Cose che non puoi fare

  • Mostrare il contenuto della recensione come se fosse di tua proprietà senza menzionare Trustpilot.

Per maggiori dettagli su come mostrare il logo di Trustpilot e le immagini delle stelle, dai un'occhiata alla nostra Style guide del brand di Trustpilot.

Come mostrare correttamente il logo di Trustpilot:

Do and Don'ts of Trustpilot Reviews

Come i partner possono accreditare Trustpilot quando mostrano le recensioni:

Documentazione API

Ora che hai letto le nostre linee guida, puoi iniziare a creare la tua integrazione API con Trustpilot. La nostra documentazione API contiene tutto ciò che i developer hanno bisogno di sapere.