Informazioni su Tyre Reviews
Cos'è tyre.info? L'API dati e i widget di valutazione di Tyre Reviews
tyre.info è il servizio dati di Tyre Reviews, che permette a rivenditori di pneumatici, officine e produttori di mostrare sui propri siti i nostri punteggi, i risultati dei test professionali, le recensioni dei proprietari e i dati dell'etichetta UE, con widget oppure tramite un'API. Questo articolo spiega cosa è disponibile, come funzionano il punteggio t.i e i suoi livelli di affidabilità, gli endpoint dell'API e quanto costa.
In questa pagina
tyre.info è il servizio dati di Tyre Reviews. Permette a rivenditori di pneumatici, officine e produttori di mostrare sui propri siti i nostri punteggi, i risultati dei test professionali, le recensioni dei proprietari e i dati dell'etichetta UE, con widget già pronti oppure tramite un'API.
Esiste da un po', ma non ne abbiamo mai scritto davvero, quindi questo articolo spiega cos'è, quali dati sono disponibili e quanto costa. Se sei qui come automobilista e non come rivenditore, la versione breve è che questo è il modo in cui i dati di questo sito vengono concessi in licenza, e i ricavi tornano nel nostro programma di test.
Due modi di usarlo
Ci sono due modi per portare i dati su un sito, e la maggior parte delle integrazioni li usa entrambi in fasi diverse.
Componenti ospitati che si aggiungono con un solo tag script. Una scheda punteggio, un modulo recensioni, un blocco di confronto o un badge in linea compare nella pagina senza alcun lavoro lato server. Si possono personalizzare nello stile per adattarli al sito che li ospita.
Un'API REST su api.tyre.info che restituisce JSON o XML, per chi costruisce la propria interfaccia, una ricerca al banco o in punto vendita, o un'app. L'autenticazione avviene tramite chiave, con elenchi di domini autorizzati e intestazioni sui limiti di frequenza.
Il punteggio t.i
Il numero principale nei dati è il punteggio t.i, una valutazione da 0 a 10 che combina i risultati dei test professionali con le recensioni dei proprietari. È lo stesso punteggio mostrato nelle pagine degli pneumatici di questo sito, e il modo in cui viene calcolato è spiegato in Il punteggio Tyre Reviews.
Due dettagli sono utili da sapere se intendi mostrarlo. Il primo è che i punteggi sono smussati statisticamente, quindi uno pneumatico con una manciata di recensioni viene avvicinato alla media della categoria invece di balzare in cima alla classifica con poche prove, e i dati più recenti contano più di quelli vecchi. Il secondo è che ogni punteggio ha un livello di affidabilità, alta, media o limitata, in base a quanti test e recensioni ci sono dietro. Questo livello esiste perché un'interfaccia possa trattare uno pneumatico ben documentato in modo diverso da uno appena recensito.
Sotto il numero principale ci sono sette categorie: asciutto, bagnato, neve, ghiaccio, comfort, valore e fuoristrada. La metodologia di punteggio è pubblicata e versionata, e le risposte dell'API indicano quale versione le ha prodotte.
I widget
L'attuale serie copre punteggi, recensioni, sintesi, confronti, dati dell'etichetta UE e un badge in linea compatto. Alcuni esempi:
Scheda punteggio
Il punteggio, il suo livello di affidabilità, il numero di test e recensioni alla base e barre per categoria. Esiste anche una versione badge più piccola che apre il dettaglio completo in una finestra modale.
Confronto
Due o più pneumatici affiancati con i loro punteggi e i dettagli per categoria, per pagine di categoria, risultati di ricerca o uno schermo al banco.
Sintesi
Un paragrafo scritto invece di un grafico, disponibile in tre forme: cosa riferiscono i proprietari, come si comporta lo pneumatico nei test, oppure entrambe le cose insieme, con punti di forza e debolezze elencati separatamente.
Recensioni
Recensioni dei proprietari con valutazione a stelle, distribuzione delle valutazioni, auto e chilometraggio associati a ogni recensione. Le recensioni critiche sono incluse insieme a quelle positive.
Le versioni interattive di tutti i widget, con il codice di incorporamento, si trovano nella pagina degli esempi di widget. Ci sono anche pagine demo per rivenditori e produttori che li mostrano in una pagina prodotto di esempio.
Endpoint dell'API
L'API copre gli stessi dati dei widget, in sette lingue: inglese, tedesco, francese, spagnolo, italiano, turco e svedese. Legge il database di produzione, quindi un test pubblicato qui compare nell'API entro poche ore.
| Endpoint | Restituisce |
|---|---|
/tyres/search | Ricerca per disegno, marca, stagione o punteggio |
/tyres/{id} | Dettaglio completo dello pneumatico con dettaglio del punteggio e chilometraggio atteso |
/tyres/{id}/score | Punteggio complessivo, livello di affidabilità e fonte dei dati |
/tyres/{id}/score-explanation | Dettagli per categoria, versione della metodologia e testo descrittivo |
/tyres/{id}/tests | Posizioni nei test e riconoscimenti, con tutte le misure per i test di Tyre Reviews |
/tyres/{id}/reviews | Recensioni dei proprietari con valutazioni e statistiche |
/tyres/{id}/images | Immagini prodotto e video |
/tyres/{id}/alternatives | Nomi di disegno noti e ID alternativi per l'abbinamento al catalogo |
/brands | Tutte le marche con il numero di pneumatici |
/tests | Test pubblicati |
L'endpoint /alternatives è di solito il più utile per i rivenditori, perché lo stesso pneumatico viene spesso elencato con nomi diversi da fornitori diversi, e serve proprio ad abbinare un file di magazzino ai nostri ID degli pneumatici.
Indipendenza e condizioni
Alcuni punti che emergono in quasi tutte le conversazioni e che sono pubblicati per intero sul sito:
- Nessun produttore vede un punteggio prima della pubblicazione, e in nessuna classifica ci sono posizioni a pagamento. La licenza dei dati non cambia alcun punteggio.
- La metodologia di punteggio è versionata, e le sue modifiche vengono pubblicate e datate.
- Il contratto di servizio si può leggere prima della firma, comprese le condizioni di rimborso e il divieto di usare i dati per addestrare modelli di IA.
- Non vengono raccolti dati degli utenti finali. I parametri delle richieste e il contenuto delle risposte non vengono registrati, e gli indirizzi IP sono conservati come hash irreversibili. L'informativa sulla privacy lo spiega in dettaglio.
Prezzi
C'è un solo piano da 500 euro al mese, che comprende 500.000 richieste API al mese, l'archivio completo, tutte le lingue, widget adattati allo stile del tuo sito e supporto per l'avvio. Integrazioni più grandi ed endpoint personalizzati si concordano a parte.
Le richieste passano dal modulo su data.tyre.info, ed è utile dire subito se si tratta di un sito di vendita, del sito di un produttore, di uno strumento per il punto vendita o di un'app, perché ognuno di questi ha bisogno di cose diverse dagli stessi dati.
Domande frequenti
Quanto velocemente compaiono i nuovi dati?
Entro poche ore. L'API legge lo stesso database che serve questo sito, quindi non c'è alcuna fase separata di esportazione o sincronizzazione.
I widget si possono adattare allo stile del nostro sito?
Sì. I dati e la presentazione sono separati, quindi i widget si possono ridisegnare, oppure si può usare l'API per costruire l'interfaccia da zero.
Cosa succede quando dietro uno pneumatico ci sono pochissimi dati?
Riceve un livello di affidabilità limitata o media invece di un punteggio falsamente preciso, e l'integrazione decide come gestirlo, che si tratti di mostrare il numero di recensioni, usare un badge più discreto o nascondere il modulo.
Serve un'integrazione API per iniziare?
No. La maggior parte inizia con i widget nelle pagine prodotto, che richiedono un tag script e non un progetto, e passa all'API in seguito se ha bisogno di più controllo.