Guida

Versione 2024
Addons

TripAdvisor

L'addon di TripAdvisor si collega all'api ufficiale della piattaforma e permette di integrare funzionalità e contenuti di TripAdvisor nelle applicazioni e nei siti web

La registrazione del cliente al servizio API di TripAdvisor è autonoma e nominativa. Può prevedere dei costi di servizio a seconda del traffico e delle richieste. Per ogni informazione aggiuntiva si invita a visitare la pagina ufficiale del portale. 

Requisiti 

Prima di attivare l'addon, è necessario disporre di questi dati:

  • Partner API Key di TripAdvisor
  • LocationId delle strutture

Partner API Key

La chiave si ottiene dopo la registrazione sulla piattaforma TripAdvisor. La chiave deve poi essere inserita nelle impostazioni di autenticazione dell'addon di Arjanna.

TripAdvisor

LocationId

Il parametro LocationId di TripAdvisor identifica la struttura. Si può ricavare facilmente negli url del portale: è il codice numerico dopo la lettera "d" e il trattino.

Esempio: nell'url https://www.tripadvisor.com/Attraction_Review-g194843-d312143-Reviews-Duomo_di_Orvieto-Orvieto_Province_of_Terni_Umbria.html, il parametro LocationId è 312143
TripAdvisor

Il codice ricavato deve essere inserito nella scheda prodotto di Arjanna

Funzioni disponibili

Le Api di TripAdvisor permette l'attivazione e il rendering delle seguenti funzioni:

  • LocationDetails: visualizza informazioni della struttura come nome, indirizzo, valutazione e URL della scheda TripAdvisor.
  • Location Photos: visualizza 5 foto della struttura. I limiti possono essere diversi a seconda del tipo di abbonamento a TripAdvisor.
  • Location Reviews: visualizza 5 recensioni della struttura. I limiti possono essere diversi a seconda del tipo di abbonamento a TripAdvisor.
  • Location Search: visualizza fino a 10 risultati di una ricerca
  • Nearby Location Search: visualizza fino a 10 strutture vicino ad determinate coordinate geografiche. Nota: per attivare questa funzione è necessario che le strutture in Arjanna siano geolocalizzate.

Il Cliente che acquista l'addon, dovrà indicare, in fase di attivazione, in quali pagine dell'app e/o sito web implementare uno o più servizi, tenendo in considerazione i parametri di prestazione dei tempi di risposta illustrati nel paragrafo successivo.

Prestazioni e tempi di risposta

Il tempo medio che l'API di TripAdvisor impiega per restituire le recensioni può variare in base a diversi fattori:

  • Numero di recensioni richieste: Più recensioni richiedi, più tempo può impiegare la risposta.
  • Qualità della connessione: La latenza della rete e la velocità di connessione influenzano i tempi di risposta.
  • Carico del server di TripAdvisor: Se i server API sono particolarmente trafficati, potrebbe esserci un ritardo.
  • In condizioni normali, la maggior parte delle API ben ottimizzate dovrebbe rispondere in pochi secondi (tipicamente tra 0,5 e 2 secondi per una richiesta media). Tuttavia, per richieste di dati più complessi o voluminosi, come recensioni dettagliate o con molti filtri, potrebbe impiegare fino a 5-10 secondi.

Tutte le richieste all'API vengono effettuate dall'addon in modalità asincrona.

La tua sessione è scaduta clicca qui e ricarica il sito