Conector de entrada do Qualtrics

Sobre o Conector de entrada da Qualtrics

Você pode usar o conector de entrada Qualtrics para carregar pesquisas da sua conta Qualtrics.

Upload de dados de uma conta Qualtrics no XM Discover

Antes de começar

Antes de configurar um trabalho usando o conector de entrada Qualtrics, certifique-se de ter as seguintes informações relacionadas à sua conta Qualtrics:

• Seu endereço de instância Qualtrics.
• Seu token da API Qualtrics.
• O nome da pesquisa a partir da qual os dados devem ser carregados.
  Qdica: Para obter mais informações, consulte a Documentação da API Qualtrics.

Configurar a conexão

1. Iniciar sessão nos conectores.
2. Clique no botão Novo job no canto superior direito da página Jobs.
   
3. Na página Conectores, vá para a seção SELECIONAR UMA FONTE.
   
4. Clique no botão Qualtrics.
   

Criação de uma tarefa de conector de entrada do Qualtrics

Depois de configurar a conexão, siga estas etapas para criar pesquisas de carregamento da sua conta Qualtrics para o XM Discover.

• Etapa 1: fornecer nome do job
• Etapa 2: especificar projeto e descrição
• Etapa 3: Fornecer credenciais da Qualtrics
• Etapa 4: Tipo de dados Qualtrics
• Etapa 5: Mapear os campos desejados para o XM Discover
• Etapa 6: Substituição e redação de dados (opcional)
• Etapa 7: Especificar filtro (opcional) e limite de registros
• Etapa 8: Notificação e configuração (opcional)
• Etapa 9: Configurar opções adicionais para job
• Etapa 10: Confirmar todas as configurações de job

Qdica: Clique nos botões Voltar e Avançar para navegar entre as páginas ou use as teclas de seta: ESQUERDA para voltar, DIREITA para avançar. Se você quiser cancelar a configuração, clique no botão Cancelar.

Etapa 1: fornecer nome do job

Insira um nome de job reconhecível na caixa Nome do job na parte superior esquerda da página.

Etapa 2: especificar projeto e descrição

1. Na página Especificar projeto e descrição, selecione o projeto para o qual os dados devem ser carregados a partir do menu suspenso de projetos.
   
   Qdica: você tem a opção de inserir uma observação sobre a tarefa na caixa Descrição do cargo. A descrição do job que você insere na caixa Descrição do job só pode ser acessada na lista Conectores e não é carregada como parte dos dados para um job.
2. Clique em Seguinte.

Etapa 3: Fornecer credenciais da Qualtrics

1. Na página Fornecer credenciais Qualtrics, você pode selecionar um conjunto de credenciais existente no menu suspenso.
   
   Qdica: você pode adicionar um novo conjunto de credenciais do Qualtrics. Para obter informações sobre novas credenciais do Qualtrics, consulte o Adição de novas credenciais Qualtrics Dados integrados.
2. Clique em Seguinte.

Etapa 4: Tipo de dados Qualtrics

1. Na página Tipo de dados da Qualtrics, selecione 1 das seguintes opções para especificar o tipo de dados a serem carregados no XM Discover:

• Pesquisa: carregue dados de uma Qualtrics específica Consulte a subseção Pesquisa abaixo para obter mais informações.
• Gerenciamento de reputação online (ORM): carregar revisões e dados de localização de um projeto de Gerenciamento de reputação Qualtrics. Consulte a subseção Gerenciamento de reputação online (ORM) abaixo para obter mais informações.
• Tíquetes: Ingerir dados do tíquete do Qualtrics Engage. Consulte a subseção Tickets abaixo para obter mais informações.
  

2. Clique em Seguinte.

Pesquisa

1. Se você selecionar Pesquisa, será direcionado para a página Selecionar pesquisa para configuração, onde poderá selecionar uma das pesquisas Qualtrics disponíveis para carregar dados.
   
   Qdica: se você não vir a pesquisa que está procurando, verifique se ela foi compartilhada com a conta que gerou a chave de API a partir do ambiente Qualtrics.
2. Se houver filtros disponíveis para a pesquisa selecionada, selecione 1 dos filtros do Qualtrics no menu (opcional). Para obter maiores informações, consulte Filtrando respostas.
   
3. Marque a caixa de seleção Recuperar respostas “Em andamento” se quiser incluir respostas não concluídas no upload. Não marque essa caixa de seleção se você só quiser obter respostas completas.
   
   Qdica: você pode atualizar a configuração da consulta após a tarefa ser criada.

Gerenciamento de reputação online (ORM)

Se você selecionar Gerenciamento de reputação online (ORM), você será levado para a página Especificar ID do conjunto de dados ORM, onde poderá inserir o idpSourceId para o projeto de dados importados na caixa ID de origem do IDP.

Tíquetes

Se você selecionar Tickets, você será levado para o Mapear campos desejados no XM Discover você pode conectar campos de dados de origem a campos de dados em seu projeto XM Discover.

Etapa 5: Mapear os campos desejados para o XM Discover

1. Na página Mapear campos desejados na descoberta XM, selecione a guia MAPEAMENTO DE FONTE para conectar campos de dados de origem a campos de dados em seu projeto XM Discover.
   
2. Na seção Mapeamento de origem padrão, configure os campos de dados padrão que todos os documentos no XM Discover compartilham. Para obter informações sobre o mapeamento de origem padrão, consulte Mapeamento de origem padrão Dados integrados.
3. Na seção Mapeamento de origem, configure quaisquer campos de dados adicionais do arquivo.
   
   Qdica: Para obter mais informações sobre mapeamento de dados, consulte Configuração do mapeamento de dados.
4. Clique em Seguinte.

Etapa 6: Substituição e redação de dados (opcional)

1. Na página Substituição e redação de dados, você pode fornecer regras de substituição e ocultação para ocultar dados confidenciais ou substituir automaticamente determinadas palavras e frases no feedback e nas interações do cliente.
   
   Qdica: Para obter mais informações sobre substituição de dados e redação, consulte Substituição e redação de dados.
2. Clique em Seguinte.

Etapa 7: Especificar filtro (opcional) e limite de registros

1. Na página Indicar filtro, você pode definir uma condição de filtro para um job carregar somente registros que o satisfaçam (opcional).
   
   Qdica: Para obter mais informações sobre como aplicar um filtro, consulte Filtro de conector.
2. Você pode indicar um limite de registros na caixa Indicar limite de registros. Como alternativa, você pode deixar o limite de registros como padrão Tudo se quiser que todos os registros sejam retornados em um único push.
   Qdica: O limite de registros é um limite por execução da tarefa. Se você definir o mesmo como 1.000, o job será executado em qualquer programação que você definir e será interrompido após chamar 1.000 registros. Se você defini-lo como diário, isso significa que ele será executado uma vez por dia e você obterá até 1.000 registros para cada dia.
   Qdica: Para dados conversacionais, o limite é aplicado com base em conversas em vez de linhas.
3. Clique em Seguinte.

Etapa 8: Configuração de notificação (opcional)

1. Na página Configuração de notificação, você pode selecionar as notificações que os observadores de um trabalho devem receber se ocorrer qualquer um dos eventos listados a seguir.

• Notificar quando nenhum registro for carregado no projeto.
• Notificar quando valores consecutivos ausentes forem encontrados.
• Notificar quando a execução do job falhar.
• Notificar quando a execução do job tiver êxito parcial.
• Notificar quando o job terminar com um timeout.
• Notificar o suporte quando este job falhar.
  

2. Clique em Seguinte.

Etapa 9: Configurar opções adicionais para job

1. Na página Configurar opções adicionais para job, na seção Tratamento de documentos novos e existentes, escolha como o sistema deve tratar documentos duplicados selecionando 1 dos seguintes campos de seleção na seção Tratamento de documentos novos e existentes:
   • Rejeitar duplicados para documentos existentes e criar novos registros para novos documentos
   • Atualizar atributos estruturados para documentos existentes e criar novos registros para novos documentos
   • Atualizar atributos estruturados para documentos existentes e não criar registros para novos documentos
     
     Atenção: cada documento deve ter um ID natural exclusivo para que o sistema possa lidar com documentos duplicados que tenham IDs naturais idênticos.

2. Na página Configurar opções adicionais para job, na seção Programar job histórico/incremental, clique em 1 das seguintes opções:

• Programar execuções incrementais para configurar uma programação para recebimentos de dados incrementais.
  Qdica: Para obter mais informações sobre a programação de execuções incrementais, consulte Agendamento de tarefas.
• Configurar pull único para executar um pull de dados único.
  

3. Clique em Seguinte.
   

Etapa 10: Confirmar todas as configurações de job

1. Na página Confirmar todas as configurações do trabalho, você pode visualizar um resumo de todas as configurações de um trabalho e editar as configurações, se necessário, antes de executar o carregamento de dados.
   
2. Para executar o upload de dados, clique no botão Concluir quando estiver pronto para executar o upload de dados. Será exibida uma mensagem de confirmação confirmando que a tarefa foi enviada com êxito.

Quando você clica em Concluir, acontece o seguinte: Puxadores únicos são executados imediatamente. A menos que você tenha ativado a opção “Criar tarefa, mas não extrair dados”, os pull programados são executados imediatamente e, em seguida, definidos para serem executados de acordo com a programação que você definiu.

Para mais informações sobre a monitorização de jobs, consulte Síntese de página de jobs.

Adição de novas credenciais Qualtrics

1. Para adicionar um novo conjunto de credenciais, selecione Adicionar Novo no menu de credenciais.
   
2. Insira o nome do novo conjunto de credenciais na caixa NOME DA CONEXÃO.
   
3. Forneça o ID do datacenter da Qualtrics na caixa ID DO DATACENTER DA QUALTRICS.
   Qdica: Para obter informações sobre como localizar seu datacenter, leia a seção Localização do ID do centro de dados na página Localização de IDs da Qualtrics.
4. Forneça o token de API para sua conta da Qualtrics na caixa TOKEN da API QUALTRICS.
   Qdica: Para saber como encontrar um token da API Qualtrics, consulte Autenticação de token da API.
5. Você pode definir suas credenciais para expirar após um determinado período de tempo (opcional). Para definir uma data de vencimento para este conjunto de credenciais e definir um lembrete para todos os observadores de trabalhos, marque a caixa de seleção Enviar notificações de vencimento. Isso ativa a caixa Dias de vencimento anterior.
   
6. Insira um valor na caixa Dias antes da expiração para definir quantos dias antes do vencimento as notificações devem começar. Os valores possíveis variam de 1 a 100 dias.
   Qdica: este lembrete é acionado sempre que a tarefa for executada quando a data de expiração for menor que o número de dias definido na caixa Dias antes da expiração.
7. Selecione a Data de vencimento a partir do selecionador de data de calendário. A data de expiração será adicionada à caixa Data de vencimento.

Mapeamento de origem padrão

Estas são as opções de campos de dados padrão para o conector de entrada do Qualtrics:

1. natural_id: o ID natural serve como um identificador exclusivo de um documento e permite o processamento correto de documentos duplicados. Para ID natural, o XM Discover usa IDs de origem com prefixo do nome do conector por meio de uma transformação personalizada: ID natural = Nome do conector;ID da fonte
   
2. document_date: Data do documento é 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. Para Data do documento, selecione 1 das seguintes opções:

• endDate (padrão): a data e a hora em que o entrevistado enviou sua pesquisa. Se a entrada for uma resposta parcial, essa data indicará a última vez que o entrevistado interagiu com a pesquisa.
  
• startDate: a data e a hora em que o entrevistado clicou pela primeira vez no link da pesquisa.
• recordedDate: Este é um registro de quando uma resposta da pesquisa foi iniciada, enviada ou atualizada no Qualtrics.
  Qdica: se os dados de origem contiverem outros campos de data, você poderá definir 1 deles como Data do documento selecionando-os na coluna Nome do campo.
  

3. job_name: Nome do job ajuda você a identificar dados com base no nome do job utilizado para carregar os mesmos. 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.
4. loadDate: Load Date indica quando um documento foi carregado no XM Discover. Este campo é definido automaticamente.
5. feedback_provider: O provedor de feedback ajuda você a identificar dados obtidos de um provedor específico. Para documentos Qualtrics, o valor deste atributo está definido como Qualtrics.
6. feedback_type: Tipo de feedback ajuda você a identificar 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). Para documentos Qualtrics, o valor deste atributo está definido como Pesquisa.
7. fonte: a fonte ajuda você a identificar 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. Por padrão, o valor desse atributo é definido como Qualtrics, mas você pode fornecer seu próprio valor na coluna Valor codificado.