Trustpilot Inbound Connector

About the Trustpilot Inbound Connector

You can use the Trustpilot inbound connector to import ratings and reviews from Trustpilot into XM Discover. This enables you to aggregate and study feedback from customers using XM Discover’s analytics and reporting features.

Setting Up a Trustpilot Inbound Job

1. En la página Jobs, haga clic en Job nuevo.
   
2. Select Trustpilot.
   
3. Seleccione el proyecto en el que desea cargar los datos.
   
4. Dele una descripción a su trabajo para que conozca su propósito.
5. Haga clic en Siguiente.
6. Choose a Trustpilot account to use, or select Add New to add a new one.
   
7. If adding a new account, enter the following:
   • Connection name: Give the connection a name so you can identify it.
   • Trustpilot API Key: Your Trustpilot API key.
   • Send Expiration Notifications: If you’d like your account credentials to expire after a certain amount of time, select this option.
   • Días antes del vencimiento: si activa las notificaciones de expiración, introduzca cuántos días desea que se le notifique antes del vencimiento. Puede introducir un valor entre 1 y 100 días.
   • Fecha de vencimiento: establezca la fecha en la que vencerán las credenciales. Haga clic en la casilla para abrir un calendario para elegir la fecha.
8. Haga clic en Siguiente.
9. Provide one or more property names of a hotel, restaurant, or attraction for which you wish to pull data. You can do this either manually or via a file.
   
   Qtip: These steps cover adding properties manually. See Uploading Properties via a File for steps on how to upload a file.
10. If adding properties manually, enter the following information:
    • Job Name: A name for the property and for the data job. This is the name that will appear for the job in XM Discover
    • Business Name: The end part of the property’s URL from Trustpilot.
      Qtip: To find the right business name, navigate to the business on Trustpilot and select the text following the final ‘/’ in the URL.
      Example: If the property URL is “https://www.trustpilot.com/review/provo-palace, then you would enter “provo-palace.”
      Qtip: The Business URL field will automatically update based on the business name. You can double check this URL matches the URL from Trustpilot.
11. You can add additional properties by clicking the plus sign ( + ) or remove properties by clicking the minus sign ( – ).
12. Haga clic en Siguiente.
13. Si es necesario, ajuste sus asignaciones de datos. Consulte la página de soporte Asignación de datos para obtener información detallada sobre los campos de asignación en XM Discover. The Default Data Mapping section has information on the fields specific to this connector.
    
14. Haga clic en Siguiente.
15. Si lo desea, puede añadir un filtro de conector para filtrar los datos entrantes para limitar los datos que se importan.
    
16. You can also limit the number of records imported in a single job by entering a number in the Specify Record Limit box. Introduzca “Todos” si desea importar todos los registros.
17. Haga clic en Siguiente.
18. Elija cuándo desea que se le notifique. Consulte Notificaciones de job para obtener más información.
    
19. Haga clic en Siguiente.
20. Seleccione cómo se gestionan los documentos duplicados. Consulte Tratamiento de duplicados para obtener más información.
    
21. Seleccione Programar ejecuciones incrementales si desea que el job se ejecute periódicamente en una programación o Configurar pull único si desea que el job se ejecute solo una vez. Consulte Programación de jobs para obtener más información.
22. Haga clic en Siguiente.
23. Revise su configuración. Si necesita cambiar una configuración específica, haga clic en el botón Editar para ir a ese paso en la configuración del conector.
    
24. Haga clic en Finalizar para grabar el job.

Asignación de datos predeterminados

This section contains information on the default fields for Trustpilot inbound jobs.

• natural_id: un identificador único de un documento. Se recomienda encarecidamente tener un ID único para cada documento para procesar duplicados correctamente. Para el ID natural, puede seleccionar cualquier campo de texto o numérico de sus datos. Alternatively, you can automatically generate IDs by adding a custom field. For Natural ID, XM Discover uses source IDs prefixed by the connector’s name via a custom transformation: Natural ID = Connector-name;Source-ID.
• document_date: el campo de fecha principal asociado a un documento. Esta fecha se utiliza en informes, tendencias, alertas, etc. de XM Discover. You can use 1 of the following:
  • createdAt (default): The date the review was published.
  • updatedAt: The date the review was updated.
  • createdAt: The date the company replied to a review, if available.
  • If your source data contains other date fields, you can select it for the document date.
  • You can also set a specific date by adding a custom field.
• feedback_provider: identifica los datos obtenidos de un proveedor específico. For Trustpilot uploads, this attribute’s value is set to “Trustpilot” and cannot be changed.
• source_value: identifica los datos obtenidos de una fuente específica. Puede ser cualquier cosa que describa el origen de los datos, como el nombre de una encuesta o una campaña de marketing móvil. By default, this attribute’s value is set to “Trustpilot.” Utilice transformaciones personalizadas para establecer un valor personalizado, definir una expresión o asignarla a otro campo.
• feedback_type: identifica los datos en función de su tipo. Esto es útil para la generación de informes cuando su proyecto contiene diferentes tipos de datos (por ejemplo, encuestas y opiniones de medios sociales). By default, this attribute’s value is set to “Rating and Reviews” and cannot be changed.
• job_name: identifica los datos según el nombre del job utilizado para cargarlos. You can modify this attribute’s value when adding properties while setting up the job.
• loadDate: indica cuándo se cargó un documento en XM Discover. Este campo se fija automáticamente y no se puede modificar.

Uploading Properties via a File

This section covers how to upload properties via an Excel file instead of entering them into XM Discover manually.

1. When adding property information, click Actions and then Upload URLs.
   
2. Click the hyperlinked “here” to download a template XLSX file. Open this file in Excel or another spreadsheet editor on your computer.
   
3. Add your property information in the first 2 columns:
   
   • Job Name: A name for the property and for the data job. This is the name that will appear for the job in XM Discover
   • Business Name: The end part of the property’s URL from Trustpilot.
4. Save your file as an XLS or XLSX file.
5. In XM Discover, click Upload File and choose the file saved on your computer.
6. Haga clic en OK.
7. Double check your properties for any errors. You can manually fix any job names and business names, or upload an updated file.