Data from TripAdvisor widget

When a survey taker submits a review using the TripAdvisor widget, the review bypasses Medallia Experience Cloud and goes directly to TripAdvisor. As part of Social Feedback that collects social reviews after they are posted publicly, most of the information is passed back to Experience Cloud within the following Experience Cloud TripAdvisor Feedback fields:

Before you begin

Complete the following steps to configure the TripAdvisor widget:

1. Request a TripAdvisor Site Key and confirm additional company-specific settings. Contact Medallia support with the following information:

   • Company name (for example, Schrute Farms).
   • Instance URL (for example, schrutefarms.medallia.com/schrutefarms).
   • Brand name.
   • Units to activate TripAdvisor Promote to. Provide a spreadsheet file with the following columns:
     • TripAdvisor IDs.
     • Experience Cloud IDs.
     Alternatively, if you do not have access to TripAdvisor IDs, provide a spreadsheet file with the following columns:

     • Experience Cloud IDs.
     • Unit name.
     • Unit address.
   Important: Medallia Support team handles this request together with the Social media product team. TripAdvisor may take up to 3 weeks to provide the Site Key.

2. Create a new Data field.

3. Populate this newly created Data field for each unit in with the property's TripAdvisor ID. You can either:

   • Ask the company to fill in the field into each unit themselves.

   • Ask the company to send you a list of their TripAdvisor URLs (or property IDs) and fill in the property ID into each unit yourself .

   • Obtain the URLs manually by downloading data from the Units report in Company > Units > Units and fill in the property ID into each unit yourself.

     Note: The property ID is always included in the last digits of the URL, for example for https://www.tripadvisor.com/Hotel_Review-g33031-d12345, the ID is 12345. This is also the same as the ID column in the Promote for TripAdvisor in step 1.

4. Create and validate the launch plan with the company.

   1. If you are planning to launch a pilot before implementing Medallia Social Promote more broadly, identify the pilot properties and define the criteria for a successful pilot. A staged roll-out is highly recommended.

   2. Decide which survey takers should view the embedded review form.

      Restriction: TripAdvisor and Medallia's content integrity on policy prevents you from asking only promoters for reviews. For more information, see Medallia Social Promote.

   3. Create a wide-release plan.

Include TripAdvisor in surveys

To configure the TripAdvisor widget:

1. Optionally, if you are using Promote for TripAdvisor on limited number of units (for example, on a pilot), add a field to the property Auto-importer processor that indicates whether the property is enabled for Promote for TripAdvisor.

   1. Navigate to Importers.

   2. Select the importer that is used to import property information.

      Tip: Create a duplicate property importer for testing purposes, then make the change to the actual property processor at launch time.

   3. Create a Promote for TripAdvisor Feedback field that flags whether Promote for TripAdvisor is enabled for the unit and map to that field. The field should have a Choice set (Yes/No values) data type.

2. Optionally, for Anonymous surveys, obtain the Unit ID:

   1. Include a question in the survey that asks the survey taker to select the unit. The answer to this question is stored on the record as a Feedback field.

   2. Copy that value of that field to Unit ID field (e_unitid). To do so, add the following code as JavaScript validation of the question where the unit is selected. By setting the value of Unit ID for the survey, you can access the Data field that contains the TripAdvisor ID.

      function setUnit() 
      {	
      	var feedbackUnit = fields.get('unit_id');	
      	fields.set('e_unitid',feedbackUnit);
      }
      setUnit();

3. In the Survey editor, add and configure a TripAdvisor page .

4. Optionally, if there is a Multiple choice - one question asking survey takers to submit a review to TripAdvisor, add a condition to Display logic to show the TripAdvisor page only when they answer Yes. Add as many conditions as you need.

   • Exclude any non-supported languages by TripAdvisor. For a list of supported languages and their language codes, see Supported Languages. For example, (((m__language != 'cs_CZ' and m__language != 'fi_FI') and m__language != 'iw') and m__language != 'ms_MY').

     Important: During the test phase, test the widget in every supported language.

   • Verify that a value has been provided for the data field type of the unit. Units that don't have a link to a TripAdvisor profile shouldn't display this page. For example, Schrute Farms TripAdvisor is present (u_schrutefarms_socialmedia_tripadvisor_id PRESENT).

   • Optionally, if piloting TripAdvisor Promote to select properties only, condition the page to show only when the Promote for TripAdvisor field is enabled (u_trip_advisor_enabled in the example below). For example, TripAdvisor enabled equals to Yes (u_trip_advisor_enabled = 1)

5. Before launching Promote for TripAdvisor, follow the steps described in Test the TripAdvisor widget.

Partially-completed surveys

Survey takers might complete the Medallia portion of the survey, but exit the survey once they see the TripAdvisor form, in which case the survey is never submitted and valuable feedback is lost. Use any of the following workarounds:

Auto complete survey after it expires

The recommended workaround is to auto-complete the survey after it expires. For more information, see Auto-completing after a specific page.

Display Promote for TripAdvisor widget link on the survey End page ("Thank-you" page)

An alternative to auto-completing the survey is to display a link on the end page of the survey to the TripAdvisor widget. The URL for routing the survey taker should include parameters and be in the following format:

https://www.tripadvisor.com/WidgetEmbed-collectreview?locationId=[LOCATION ID OF THE PROPERTY]&partnerId=[CLIENT SPECIFIC SITE KEY]&display=true

Send survey takers a Thank-you email with a link to Promote for TripAdvisor

Another alternative to auto-completing the survey is to send a Thank-you email after the survey is completed that prompts the survey taker to submit a TripAdvisor review. Same as in the workaround above, the URL for routing the survey taker should be in the following format:

https://www.tripadvisor.com/WidgetEmbed-collectreview?locationId=[LOCATION ID OF THE PROPERTY]&partnerId=[CLIENT SPECIFIC SITE KEY]&display=true

Test the TripAdvisor widget

To test the TripAdvisor widget:

Add TripAdvisor Promote activity to reports

Complete the following steps to add a custom module to include data about how many users decided to complete the TripAdvisor form (not the data on TripAdvisor) in Admin Suite Reports.

For more information about working with Dashboards, see Dashboards. For more information about the module types in this report, see Custom Module and Section Header.

Tips and best practices