-
Qualtrics Platform -
Customer Journey Optimizer -
XM Discover -
Qualtrics Social Connect
Yotpo Inbound Connector
About the Yotpo Inbound Connector
You can use the Yotpo inbound connector to load ratings and reviews from your Yotpo account into XM Discover.
Qtip: Before you configure a job using the Yotpo inbound connector, make sure you have the following information about your Yotpo account:
- Your Yotpo App Key
- Your Yotpo Secret Key
See Yotpo support for more information.
Setting Up a Yotpo Inbound Connector
Qtip: The “Manage Jobs” permission is required to use this feature.
- Na página Trabalhos, clique em Novo trabalho.
- Select Yotpo.
- Dê um nome ao seu job para poder identificá-lo.
- Selecione o projeto para o qual os dados devem ser carregados.
- Dê uma descrição ao seu cargo para que você saiba o seu objetivo.
- Clique em Seguinte.
- Choose a Yotpo account to use, or select Add New to add a new one.
- If adding a new account, enter the following information:
- Connection Name: Give the connection a name so you can identify it.
- Yotpo Client ID: Your Yotpo app key.
- Yotpo Client Secret: Your Yotpo secret identification token.
- If you want your credentials to expire, then configure the following options:
- Send Expiration Notifications: Select this option to allow your credentials to expire.
- Days prior expiration: If enabling expiration notifications, enter how many days you’d like to be notified before the expiration. 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.
- Clique em Seguinte.
- 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 and the Mapping Conversational Fields section covers how to map data for conversational data.
- Clique em Seguinte.
- Se desejar, você pode adicionar regras de substituição e ocultação de dados para ocultar dados confidenciais ou substituir automaticamente determinadas palavras e frases no feedback e nas interações do cliente. See the Data Substitution and Redaction support page.
Qtip: Click Download Sample Data to download an Excel file with sample data to your computer. - Clique em Seguinte.
- Se desejar, você pode adicionar um filtro de conector para filtrar os dados de entrada a fim de limitar quais dados são importados.
- 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.
Qdica: Para dados conversacionais, o limite é aplicado com base em conversas em vez de linhas.
- Clique em Seguinte.
- Escolha quando você deseja ser notificado. Consulte Notificações de job para mais informações.
- Clique em Seguinte.
- Escolha como os documentos duplicados são tratados. Consulte Tratamento de duplicados para obter mais informações.
- 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.
- If desired, select additional days to process during each incremental run. This additional time range ensures that any data that might be delayed is included.
- Clique em Seguinte.
- 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.
- Clique em Concluir para salvar o trabalho.
Mapeamento de dados padrão
Attention: As field names are case-sensitive in Connectors, the first letter of the field name must be upper-case as displayed in the Data Sample to ensure data mappings are accurate and the job succeeds.
This section contains information on the default fields for Yotpo inbound jobs.
- natural_id: Um identificador exclusivo de um documento. É altamente recomendado ter um ID único para cada documento para processar duplicados corretamente. For Natural ID, XM Discover uses source IDs prefixed by the connector’s name.
- 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 choose one of the following options:
- created_at: The time a review was created.
- Você também pode definir uma data específica do documento.
- feedback_provider: identifica dados obtidos de um provedor específico. For Yotpo documents, this attribute’s value is set to “Yotpo” and cannot be changed.
- source: Identifies data obtained from a specific source. 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 “Yotpo.” 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 “Ratings and Reviews”. Use transformações personalizadas para definir um valor personalizado, definir uma expressão ou mapeá-la para outro campo.
- job_name: identifica dados com base no nome do trabalho usado para carregá-lo. Você pode modificar o valor deste atributo durante a configuração por meio do campo Nome do job que é exibido na parte superior de cada página durante a configuração.
- loadDate: indica quando um documento foi carregado no XM Discover. Este campo é definido automaticamente e não pode ser modificado.