This widget displays current Travelers’ Choice-winning hotels, attractions, and destinations in geos that the partner chooses. An automated slideshow will cycle through the winner photos when the page loads, and a user may auto-advance the photos at any time. Each time the page loads, a new list will be displayed.
The widget size is 300x250 pixels. Elements that will be shown in the widget include: the name of the Travelers’ Choice list and Tripadvisor logo, name of property or attraction, geo, rank on the Travelers’ Choice List, scroll arrows to manually advance the slideshow, and a call to action button which opens a new window to a target Tripadvisor page. Revenue sharing can be enabled for the button.
| Option | Description |
| Language | Indicate which languages the partner should be configured for. |
| Geos | Select TC-winning geos to show in the widget. You may only use geo codes that are a recipient of an eligible TC list that is live on the Tripadvisor site: http://www.tripadvisor.com/TravelersChoice |
| Travelers' Choice Campaign Type | This will determine which campaigns are featured in the widget. All sub-categories for a campaign will be included (i.e. If you choose Hotels, you will get lists for Top, Luxury, Small etc. if there is a winning list for that geo.) Choose from Attractions, Destinations, and Hotels. |
| Button Copy | Choose the localized copy for the button. Button will redirect user to default domain associated to language.
Clicking on the button will open a new window with a specific target TC page depending on what type of campaign was chosen.
|
Partner widgets are intended to be displayed in an iframe on the partner site. A sample iframe with a widget invocation might look like:
<iframe src="http://www.tripadvisor.com/WidgetEmbed-tcphoto?geos=191,1,4
&placeTypes=hotel,attraction,geo&partnerId=PARTNER_KEY&display=true&lang=fr</iframe>
All widget URLs include the /WidgetEmbed Tripadvisor page followed by the key value for the widget being requested. This is followed by a question mark and the key/value pairs of URL parameters. URL parameter settings are consistent across all widgets.
| Option Name | Description |
| partnerId | Required. The partner key provided by Tripadvisor to allow partner access to widgets. |
| geos | Required. The geo ID provides input on which Travelers’ Choice lists can be displayed. Comma separated list is supported. |
The Travelers’ Choice Widget can be configured to display hotels, attractions, or destinations that have an active list on Tripadvisor: http://www.tripadvisor.com/TravelersChoice
For example, “Top 25 Luxury Hotels in Europe” may be chosen in the configuration, but the geo for Rome may not be chosen although several hotels in Rome may be an award recipient. Choosing the Hotels Campaign will provide all categories within that campaign that have a TC-winning list. Ask your Account Executive for more information about which campaigns are available for the regions you are interested in.
Hotel
Geo
Attraction
