Creare una chiave API di TripAdvisor

Come creare una chiave API di TripAdvisor su Terra, la loro piattaforma per sviluppatori, in modo da poter aggiornare le recensioni più spesso e aggiungere ulteriori fonti.

Preferiresti che le recensioni di TripAdvisor venissero aggiornate più spesso o che venissero visualizzate più fonti di TripAdvisor?

In questa guida ti spiegheremo quando è necessaria una chiave API di TripAdvisor. Ti illustreremo inoltre come crearne una su Terra, la piattaforma per sviluppatori di TripAdvisor, e come aggiungerla o rimuoverla in Reviews Feed. Se decidi di utilizzare una chiave personale, ti basterà un account Terra, che è indipendente da qualsiasi account TripAdvisor tu possieda già.

Requisiti: i feed di TripAdvisor richiedono il livello di licenza “Elite” per il feed delle recensioni.

Prima di iniziare, assicurati che sul tuo sito WordPress sia installata e attivata l'ultima versione di Reviews Feed.

Hai bisogno di una chiave API di TripAdvisor?

La chiave API è facoltativa. I tuoi feed di TripAdvisor funzionano anche senza.

Senza una chiave, Reviews Feed si collega automaticamente a TripAdvisor. In tal caso, le recensioni su TripAdvisor vengono aggiornate una volta alla settimana. Il tuo sito può inoltre gestire fino a tre fonti TripAdvisor senza una chiave.

L'aggiunta di una chiave personalizzata comporta due modifiche:

  • Aggiornamenti più rapidi: le tue recensioni su TripAdvisor vengono aggiornate ogni 12 ore anziché una volta alla settimana.
  • Altre fonti: è possibile aggiungere più di tre fonti da TripAdvisor.

Quando si tenta di aggiungere una quarta fonte TripAdvisor senza una chiave, Reviews Feed visualizza il messaggio “Limite fonti superato. Inserire la chiave API”. Successivamente, si viene reindirizzati alla schermata in cui è possibile aggiungere una chiave.

La finestra "Aggiungi fonti" nella sezione "Feed delle recensioni", al passaggio "Aggiungi una chiave API per TripAdvisor", con il messaggio "Limite delle fonti superato. Inserisci la chiave API" evidenziato

Se l'aggiornamento settimanale è adeguato al tuo sito e visualizzi tre o meno fonti di TripAdvisor, non hai affatto bisogno di una chiave.

Aggiunta di una fonte TripAdvisor senza chiave

Per iniziare, collegheremo TripAdvisor come nuova fonte di recensioni senza una chiave API.

Quando aggiungi una fonte TripAdvisor, Reviews Feed richiede innanzitutto una chiave API. Se non ne possiedi una, puoi saltare questo passaggio.

Nel passaggio "Aggiungi una chiave API per TripAdvisor", lascia il campo vuoto. Quindi, fai clic su " Salta".

La fase “Aggiungi una chiave API per TripAdvisor” della finestra “Aggiungi fonti”, con il testo che indica che la chiave è facoltativa evidenziato e una freccia che punta al pulsante “Salta”

A questo punto, incolla il link alla pagina dell'attività su TripAdvisor nel campo "URL della pagina". Quindi, clicca su "Fine".

La sezione "URL della pagina" della finestra "Aggiungi fonti", con il link a una scheda di TripAdvisor incollato nel campo e una freccia che punta al pulsante "Fine"

Il feed delle recensioni aggiunge la fonte e visualizza il messaggio “Fonte aggiunta con successo”.

Il campo "URL della pagina" accetta tre tipi di input:

  • Il link alla pagina di un hotel, di un ristorante o di un’attrazione su TripAdvisor. Questi link contengono la lettera “-d” seguita da una serie di numeri.
  • Il link a una recensione dell'attività. Reviews Feed aggiunge l'attività a cui appartiene la recensione.
  • Il solo ID numerico della posizione. Si tratta del numero che segue “-d” nel link della pagina.

Il feed delle recensioni richiede un link a una singola attività commerciale. Quando incolli un link a qualcos’altro, un messaggio sotto il campo ti indica a cosa rimanda il link:

  • Tour ed esperienze: questi link rimandano a Viator, che non è disponibile tramite l'API pubblica di TripAdvisor.
  • Profili degli utenti: questi link rimandano a un utente di TripAdvisor, non a un’attività commerciale.
  • Pagine delle categorie: questi link rimandano a una destinazione o a un elenco di luoghi, non a una singola voce.
La sezione "URL della pagina" della finestra "Aggiungi fonti", con un link a un tour di TripAdvisor inserito nel campo e il messaggio che spiega che i tour e le esperienze non sono disponibili evidenziato

Se visualizzi uno di questi messaggi, o un messaggio che indica che Reviews Feed non è riuscito a trovare l’ID della località su TripAdvisor, apri la pagina dell’attività su TripAdvisor. Quindi, copia il link e incollalo nel campo. La nostra guida sull’aggiunta di una fonte TripAdvisor elenca i link accettati da Reviews Feed e spiega il significato di ciascun messaggio.

Creazione della chiave API di Terra

Se desideri aggiornamenti più rapidi o un maggior numero di fonti, ti servirà una chiave personale. TripAdvisor rilascia le chiavi API tramite Terra, la sua piattaforma per sviluppatori.

Terra utilizza un proprio account, distinto da qualsiasi account TripAdvisor che tu possieda per la tua attività. Le chiavi e gli account della precedente API Content di TripAdvisor non vengono trasferiti su Terra. Avrai bisogno di una nuova chiave Terra anche se in precedenza hai utilizzato una chiave API di TripAdvisor.

Per prima cosa, vai alla pagina per gli sviluppatori di TripAdvisor e registrati a Terra Discover, il pacchetto che ha sostituito l’API Content. Le FAQ di Terra spiegano come registrarsi.

Discover è un servizio a consumo. Prevede una quota gratuita. L'utilizzo che supera tale quota viene addebitato. La pagina di Terra dedicata ai prezzi in base all'utilizzo riporta i prezzi attuali.

Una volta effettuata la registrazione, genera la tua chiave API dalla dashboard di Terra. Quindi, apri la scheda "Panoramica" per trovare la tua chiave nella scheda "La mia chiave API". Dato che ti servirà tra poco sul tuo sito WordPress, copiala.

Nota: considera la tua chiave API come una password e non renderla pubblica. Se dovesse essere divulgata, rigenerala dalla scheda “La mia chiave API”. Successivamente, aggiungi la nuova chiave a Reviews Feed. La guida alla sicurezza di Terra spiega che la rigenerazione comporta la revoca immediata della vecchia chiave.

Questo è tutto ciò che ti serve da Terra. Ora torna al tuo sito WordPress.

Aggiunta della chiave al feed delle recensioni

Una volta copiata la tua chiave Terra, sei pronto per salvarla in Reviews Feed.

Nella dashboard di WordPress, vai su Feed recensioni » Impostazioni.

Il menu di amministrazione di WordPress con l'opzione "Feed delle recensioni" e poi "Impostazioni" selezionate

Nella scheda "Generale", scorri verso il basso fino alla sezione "Gestisci chiavi API". Quindi, clicca sull'icona a forma di matita sulla scheda di TripAdvisor.

La sezione “Gestisci chiavi API” delle impostazioni del feed delle recensioni, con una freccia che indica l’icona a forma di matita sulla scheda di TripAdvisor

Nella finestra che si apre, incolla la tua chiave nell'apposito campo. Quindi, fai clic su "Aggiorna" per salvarla.

La finestra "Aggiungi chiave API per TripAdvisor" con una chiave incollata nel campo e una freccia che punta al pulsante "Aggiorna"

Il pulsante in questa finestra riporta la dicitura "Aggiungi" finché non si inserisce una chiave. Non appena lo si fa, la dicitura cambia in "Aggiorna".

Reviews Feed verifica la chiave nel momento in cui la salvi. Se la chiave non è valida, Reviews Feed non la salva e ti chiede di controllare i dati inseriti.

In tal caso, copia nuovamente la chiave dalla dashboard di Terra. Quindi, incollala nel campo.

Una volta salvata la chiave, le tue recensioni su TripAdvisor vengono aggiornate ogni 12 ore. Puoi anche aggiungere più di tre fonti TripAdvisor.

La stessa chiave copre tutte le fonti di TripAdvisor presenti nel plugin. Non sarà necessario inserirla nuovamente per ogni fonte aggiunta.

Le chiavi di Google e Yelp vanno inserite nella stessa sezione, come indicato nella sezione “Gestisci chiavi API” della nostra guida alle impostazioni.

Rimozione di una chiave API

Se non desideri più utilizzare la tua chiave, puoi rimuoverla in qualsiasi momento. Reviews Feed tornerà quindi a utilizzare la connessione integrata nel plugin.

La rimozione di una chiave rappresenta anche la soluzione per le chiavi relative alla precedente API Content di TripAdvisor. TripAdvisor ha dismesso tale API il 31 agosto 2026. Quelle chiavi non funzionano più.

Se una di queste chiavi è ancora salvata e visualizzi le fonti di TripAdvisor, Reviews Feed mostra un avviso nella pagina Impostazioni. Per accedere alle tue chiavi da lì, clicca su “Gestisci chiavi API” nell’avviso.

L'avviso "La tua chiave API di TripAdvisor non funziona più" nella pagina "Impostazioni feed recensioni", con una freccia che punta al pulsante "Gestisci chiavi API"

È possibile distinguere i due tipi di chiavi in base alla loro forma. Le chiavi API Content sono composte da 32 caratteri senza trattini. Le chiavi Terra sono più lunghe e contengono trattini.

A questo punto, apri la finestra relativa alla chiave di TripAdvisor dalla sezione “Gestisci chiavi API”, proprio come hai fatto quando hai aggiunto la chiave. Nella finestra, clicca su “Rimuovi”.

La finestra "Aggiungi chiave API per TripAdvisor" con una chiave salvata e una freccia che punta al pulsante "Rimuovi"

Il feed delle recensioni rimuove la chiave. L'avviso non viene più visualizzato. Le tue recensioni su TripAdvisor ora vengono aggiornate una volta alla settimana.

Se desideri continuare a utilizzare la tua chiave, aggiungi una chiave Terra al posto di quella precedente. I passaggi sono gli stessi descritti nella sezione “Aggiunta della chiave al feed delle recensioni”.

Ecco fatto! Ora sai quando ti serve una chiave API di TripAdvisor, come crearne una su Terra e come aggiungerla o rimuoverla. Ora dai un’occhiata alla nostra guida su come visualizzare il feed delle recensioni per sfruttare al meglio le recensioni sul tuo sito.

Domande frequenti

Di seguito abbiamo risposto ad alcune delle domande più frequenti relative alle chiavi API di TripAdvisor nel feed delle recensioni.

È necessaria una chiave API di TripAdvisor per visualizzare le recensioni di TripAdvisor?

No. I tuoi feed di TripAdvisor funzionano anche senza chiave.

Consulta la sezione “Hai bisogno di una chiave API di TripAdvisor?” qui sopra per scoprire cosa cambia con una chiave.

Perché non riesco ad aggiungere un'altra fonte di TripAdvisor?

Il messaggio “Limite fonti superato. Inserisci la chiave API” indica che il tuo sito dispone già di tre fonti TripAdvisor senza chiave. Per aggiungerne altre, crea una chiave API Terra. Successivamente, aggiungila al feed delle recensioni.

Perché in "Feed delle recensioni" mi viene segnalato che la mia chiave API di TripAdvisor non funziona più?

La chiave salvata proviene dalla precedente API Content di TripAdvisor, che TripAdvisor ha dismesso il 31 agosto 2026. Tali chiavi non sono trasferibili su Terra. È possibile rimuovere la chiave per utilizzare la connessione integrata nel plugin. È inoltre possibile sostituirla con una chiave Terra.

Come faccio a capire se la mia chiave è una chiave API Content o una chiave Terra?

Lo si capisce dalla forma. Le chiavi API Content sono composte da 32 caratteri senza trattini. Le chiavi Terra sono più lunghe e contengono trattini.

Quali link di TripAdvisor posso utilizzare come fonte?

Nel campo "URL della pagina", inserisci il link alla pagina di un hotel, di un ristorante o di un'attrazione che contenga "-d" seguito da una serie di numeri. Puoi anche inserire solo quella serie di numeri. Se il tuo link rimanda a un tour, al profilo di un membro o a una pagina di categoria, apri la pagina TripAdvisor dell'attività in questione e copia invece quel link.

Devo pagare per ottenere una chiave API di Terra?

Terra Discover prevede un modello di pagamento a consumo, con una quota gratuita. L'utilizzo che supera tale quota viene addebitato. I prezzi attuali sono disponibili sulla pagina dedicata ai prezzi in base all'utilizzo di Terra.

Perché Reviews Feed non ha salvato la mia chiave?

Reviews Feed verifica la chiave al momento del salvataggio e non salva una chiave non valida. Se la chiave non è stata salvata, copiala nuovamente dalla dashboard di Terra. Se hai rigenerato la chiave su Terra, quella precedente non è più valida. In tal caso, incolla invece quella nuova.

supporto

Non è stato possibile trovare la risposta nei documenti?

Contatto con l'assistenza