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. Na página Trabalhos, clique em Novo trabalho.
   
2. Select Trustpilot.
   
3. Selecione o projeto para o qual os dados devem ser carregados.
   
4. Dê uma descrição ao seu cargo para que você saiba o seu objetivo.
5. Clique em Seguinte.
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.
   • Dias antes da expiração: se as notificações de expiração forem ativadas, insira quantos dias você gostaria de ser notificado antes da expiração. Você pode inserir um valor entre 1 e 100 dias.
   • Data de vencimento: defina a data em que as credenciais expirarão. Clique na caixa para abrir um calendário e selecionar a data.
8. Clique em Seguinte.
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. Clique em Seguinte.
13. Se necessário, ajuste seus mapeamentos de dados. Consulte a página de suporte Mapeamento de dados para obter informações detalhadas sobre campos de mapeamento no XM Discover. The Default Data Mapping section has information on the fields specific to this connector.
    
14. Clique em Seguinte.
15. Se desejar, você pode adicionar um filtro de conector para filtrar os dados de entrada a fim de limitar quais dados são importados.
    
16. Você também pode limitar o número de registros importados em um único job inserindo um número na caixa Indicar limite de registros. Insira “Todos” se quiser importar todos os registros.
17. Clique em Seguinte.
18. Escolha quando você deseja ser notificado. Consulte Notificações de job para mais informações.
    
19. Clique em Seguinte.
20. Escolha como os documentos duplicados são tratados. Consulte Tratamento de duplicados para obter mais informações.
    
21. Selecione Programar execuções incrementais se você quiser que seu job seja executado periodicamente em uma programação ou Configurar pull único se quiser que o job seja executado somente uma vez. Consulte Escalonamento do job para mais informações.
22. Clique em Seguinte.
23. Revise sua configuração. Se você precisar modificar uma configuração específica, clique no botão Editar para ir para essa etapa na configuração do conector.
    
24. Clique em Concluir para salvar o trabalho.

Mapeamento de dados padrão

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

• natural_id: Um identificador exclusivo de um documento. É altamente recomendado ter um ID único para cada documento para processar duplicados corretamente. Para ID natural, você pode selecionar qualquer campo de texto ou numérico a partir de seus dados. 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: o campo de data principal associado a um documento. Esta data é usada em relatórios, tendências, alertas do XM Discover e assim por diante. 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 dados obtidos de um provedor específico. For Trustpilot uploads, this attribute’s value is set to “Trustpilot” and cannot be changed.
• source_value: identifica dados obtidos de uma fonte específica. Isso pode ser qualquer coisa que descreva a origem dos dados, como o nome de uma pesquisa ou uma campanha de marketing móvel. By default, this attribute’s value is set to “Trustpilot.” Use transformações personalizadas para definir um valor personalizado, definir uma expressão ou mapeá-la para outro campo.
• feedback_type: Identifica dados com base em seu tipo. Isso é útil para relatórios quando seu projeto contém diferentes tipos de dados (por exemplo, pesquisas e feedback de mídias sociais). By default, this attribute’s value is set to “Rating and Reviews” and cannot be changed.
• job_name: identifica dados com base no nome do trabalho usado para carregá-lo. You can modify this attribute’s value when adding properties while setting up the job.
• loadDate: indica quando um documento foi carregado no XM Discover. Este campo é definido automaticamente e não pode ser modificado.

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. Clique em OK.
7. Double check your properties for any errors. You can manually fix any job names and business names, or upload an updated file.