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 visualizzare sempre i dati che sono conformi, ti consigliamo di utilizzare uno dei nostri widget TrustBox.

Requisiti per i contenuti

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

Cosa fare

• Obbligatorio: indicare le recensioni che stai mostrando nel tuo widget.
  
  • 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 tutte le recensioni, mostra il testo "Le nostre recensioni più recenti".
  • Se intendi visualizzare le tue recensioni preferite o quelle contenenti tag, mostra il testo "Le nostre recensioni preferite".
• Archiviare i tuoi dati sul tuo sistema di backend, in modo da poter mostrare recensioni o valutazioni sul tuo sito.
• 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.
• Inserire un link a Trustpilot, così che i clienti possano leggere le tue recensioni per intero.

Cosa non 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.

Non devi mostrare la tua categoria di classifica, ma se lo fai, assicurati che sia accurato.

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.

Cosa 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.

Cosa non 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.

Cosa 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.

Cosa non 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:

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.