Conector de saída Qualtrics

Sobre o Conector de saída da Qualtrics

Você pode usar o conector de saída Qualtrics para realizar as tarefas listadas abaixo.

• Atualize as pesquisas existentes da Qualtrics com enriquecimentos do XM Discover.
• Envie os dados de exportação do XM Discover para a Qualtrics por meio de um evento JSON para acionar um fluxo de trabalho Qualtrics.

Entre em contato com a equipe da conta Qualtrics se precisar de orientação adicional.

ANTES DE INICIAR

Pré-requisitos:

Antes de configurar uma tarefa usando o conector de saída Qualtrics, certifique-se de que as condições listadas abaixo sejam atendidas.

• Os campos de dados para enriquecimentos do XM Discover devem fazer parte do registro da pesquisa Qualtrics.
  Qdica: Para obter mais informações sobre a adição de campos de dados para aprimoramentos do XM Discover às suas pesquisas, consulte Dados integrados.
• Os documentos no XM Discover devem conter um campo de dados com IDs de pesquisa quando você utiliza o tipo de conector de saída de pesquisa.

Credenciais necessárias:

Você precisará das seguintes informações relacionadas às suas contas Qualtrics e XM Discover:

• Seu endereço de instância Qualtrics.
• Seu token da API Qualtrics.
• Seu ponto de extremidade de API de exportação do XM Discover.

CONFIGURANDO A CONEXÃO

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

Configuração de uma tarefa de conector de saída do Qualtrics

Depois de configurar a conexão, siga as etapas abaixo para configurar um job.

• Etapa 1: fornecer nome do job
• Etapa 2: especificar projeto e descrição
• Etapa 3: selecionar tipo de dados do Qualtrics
• Etapa 4: Fornecer credenciais da Qualtrics
• Etapa 5: Configurar credenciais de exportação do XM Discover
• Etapa 6: Configuração de consulta
• Etapa 7: selecionar pesquisa para configuração (somente para tipo de dados PESQUISA) -OR- Indicar o ponto de acesso do evento JSON (somente para o tipo JSON EVENTdata)
• Etapa 8: Configuração de consulta de saída
• Etapa 9: Mapear campos desejados na Qualtrics
• Etapa 10: Especificar filtro (opcional) e limite de registros
• Etapa 11: Configuração de notificação (opcional)
• Etapa 12: Configurar opções adicionais para job
• Etapa 13: Confirmar todas as configurações de job

Etapa 1: fornecer nome do job

1. Insira um nome de job reconhecível na caixa Nome do job na parte superior esquerda da página.
   Atenção: o nome que você inserir na caixa Nome do job será adicionado a todos os documentos carregados mediante este job como um valor com programação incondicional para o atributo job_name.
   Qdica: você pode modificar o nome da tarefa durante a configuração usando o campo Nome da tarefa que é exibido na parte superior de cada página durante a configuração.
2. Clique em Seguinte.

Etapa 2: especificar projeto e descrição

1. Na página Especificar projeto e descrição, selecione um projeto a partir do qual carregar dados 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: selecionar tipo de dados do Qualtrics

1. Na página Selecionar tipo de dados do Qualtrics, selecione um dos seguintes tipos de dados para carregar.
   • Pesquisa: selecione esse tipo de dados para atualizar as pesquisas existentes da Qualtrics com enriquecimentos do XM Discover.
   • Evento JSON: selecione este tipo de dados para enviar dados de exportação do XM Discover para o Qualtrics por meio de um evento JSON a fim de acionar uma tarefa de automação xFlow usando enriquecimentos do XM Discover de qualquer fonte de dados.
     Qdica: Para obter mais informações, consulte Evento JSON.
2. Clique em Seguinte.

Etapa 4: Fornecer credenciais da Qualtrics

Na página Fornecer credenciais da Qualtrics, você pode selecionar um conjunto existente de credenciais no menu suspenso ou adicionar um novo conjunto de credenciais.

1. Para adicionar um novo conjunto de credenciais, selecione Adicionar novo no menu suspenso de credenciais e insira os parâmetros de conexão listados na tabela a seguir nas caixas correspondentes.
2. Insira o nome do novo conjunto de credenciais na caixa NOME DA CONEXÃO.
3. Forneça o token de API conectado à sua conta Qualtrics na caixa TOKEN API DE SAÍDA QUALTRICS.
4. Insira o endereço da instância Qualtrics na caixa ID DO DATACENTER DE SAÍDA QUALTRICS.
5. Você pode definir suas credenciais para expirar após um determinado período de tempo (opcional).
6. 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.
7. 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 é executada quando a data de vencimento é inferior ao número de dias definido na caixa Dias de vencimento anterior.
8. 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.
9. Clique em Seguinte.

Etapa 5: Configurar credenciais de exportação do XM Discover

1. Na página Configurar credenciais de exportação do XM Discover, forneça o ponto de acesso da API de exportação do XM Discover na caixa HOST.
2. Clique em Seguinte.

Etapa 6: Configuração de consulta

Na página Configuração de consulta, você pode especificar quais dados devem ser usados para atualizar pesquisas Qualtrics (se você selecionou PESQUISA como tipo de dados) ou enviar para o Qualtrics por meio de um evento JSON (se você selecionou EVENTO JSON como tipo de dados).

1. Selecione uma das seguintes opções no menu suspenso Selecionar o nível de dados para escolher o nível de resolução de dados associado aos dados de saída:
   • Sentenças: Use dados no nível de frase.
   • Documentos: use dados no nível do documento.
2. Forneça uma consulta para filtrar os dados de saída na caixa Inserir a consulta(opcional). Use a mesma sintaxe usada para procurar dados no Designer.
   Exemplo: você pode especificar um ou mais IDs de pesquisa para atualizar apenas os registros de pesquisa selecionados usando a seguinte sintaxe:Surveyid:sv_01
3. Forneça o nome do filtro do seu projeto que deve ser aplicado aos dados de saída na caixa Inserir o nome do filtro(opcional).
4. Para atualizar os registros que foram criados desde a última execução do trabalho de saída, selecione Padrão: Carregar novos registros em Escolher quais registros você deseja recuperar. Para atualizar os registros que foram criados ou atualizados desde a última execução do job de saída, selecione Carregar registros novos e atualizados. Para atualizar somente os registros que foram atualizados desde a última execução do job de saída, selecione Carregar registros atualizados.
   Qdica: Executar ou executar novamente a categorização atualiza um registro no sistema XM Discover.
5. Você pode definir que dados de classificação devem ser incluídos nos dados de saída (opcional). Marque o campo de seleção Todos os modelos para incluir os dados de classificação de todos os modelos disponíveis no projeto. Não marque o campo de seleção Todos os modelos se você só quiser incluir modelos selecionados. Se a opção Todos os modelos não estiver selecionada, você poderá selecionar modelos específicos a serem incluídos nos dados de saída a partir do menu suspenso.
6. Selecione uma das seguintes opções a partir do menu suspenso Filtros resultados aplicando regras de modelo:
   • Ignorar: nenhuma filtragem é aplicada com base nos modelos selecionados.
   • Classificado atualmente: Retorna as frases/documentos que foram classificados pelo(s) modelo(s) selecionado(s) durante a execução de classificação mais recente.
   • Ever Classified: Retorna as frases/documentos que foram classificados pelo(s) modelo(s) selecionado(s) a qualquer momento.
7. Marque o campo de seleção Se devem ser retornados IDs de categoria (verdadeiro) em vez de nomes de categoria (falso) para usar IDs de categoria em vez de nomes de categoria (Opcional).
8. Selecione os resultados de Filtros aplicando a consulta de filtro com todos os caminhos de nós-folha para adicionar vários modelos com o parâmetro “código somente folha” à chamada da API de exportação (opcional).
9. Selecione Ignorar valores vazios se desejar que o conector pule a atualização de um documento de pesquisa se todos os respectivos valores de saída estiverem vazios (opcional).
10. Clique em Seguinte.

Etapa 7: Selecionar pesquisa para configuração -OR- Especificar o ponto de extremidade do evento JSON

SELECIONAR PESQUISA PARA CONFIGURAÇÃO

1. Selecione uma das pesquisas Qualtrics disponíveis para atualizar.
   Qdica: Se você não vir a pesquisa que está procurando, verifique se ela está compartilhada com a conta que gerou a chave de API no ambiente Qualtrics.
2. Clique em Seguinte.

ESPECIFICAR O ENDPOINT DO EVENTO JSON

1. Especifique o URL do ponto de extremidade do evento JSON para enviar os dados de exportação do XM Discover para a Qualtrics por meio de um evento JSON.
2. Qdica: Para saber mais sobre a configuração de um evento JSON, consulte Evento JSON.
3. Clique em Seguinte.

Etapa 8: Configuração de consulta de saída

1. Selecione o atributo do projeto XM Discover que armazena o ID da pesquisa da Qualtrics.
   Qdica: Somente os documentos com ID de pesquisa que correspondam à pesquisa selecionada na etapa anterior serão atualizados.
2. Clique em Seguinte.

Etapa 9: Mapear os campos desejados para o XM Discover

Na página Mapear campos desejados para o XM Discover, você pode mapear atributos do XM Discover e resultados de classificação para campos de dados integrados definidos no Qualtrics.

1. Clique dentro da caixa de campo personalizado vazio e selecione o campo XM Discover que você deseja adicionar a uma pesquisa na Qualtrics.
2. Selecione o tipo de dados de um campo incorporado correspondente criado no XM Engage no menu suspenso Tipo de dados.
3. Insira o nome do campo incorporado no XM Engage que deve ser preenchido com os valores do campo XM Discover selecionado na caixa Nome do atributo.
4. Clique no ícone de adição (+) para adicionar mais campos personalizados e mapeá-los para campos incorporados do Qualtrics, se necessário.
5. Clique em Seguinte.

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

1. Na página Indicar filtro, você pode definir uma condição de filtro para que um job carregue somente registros que cumpram o mesmo (opcional).
   Qdica: Para obter mais informações sobre a aplicação de 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 11: 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 abaixo.
   • Os registros zero são carregados no projeto.
   • Foram encontrados valores em falta consecutivos.
   • Uma execução de job falha.
   • Uma execução de job tem êxito parcial.
   • Um job termina com um timeout.
   • Um trabalho falha.
     Qdica: você pode selecionar qualquer combinação de notificações ou decidir não escolher nenhuma notificação. Neste caso, as observações de um job não recebem notificações.
     Qdica: Para obter mais informações sobre os parâmetros de configuração de notificação, consulte Notificações de tarefas.
2. Clique em Seguinte.

Etapa 12: Configurar opções adicionais para job

1. Na página Configurar opções adicionais para job, na seção Programar job histórico/incremental, selecione uma das seguintes opções:
   • Programar execuções incrementais para configurar uma programação para recebimentos de dados incrementais.
     Qdica: Use a opção Criar tarefa, mas não extrair dados se quiser validar a tarefa e suas configurações antes de os dados serem atualizados. Para mais informações sobre o escalonamento de execuções incrementais, consulte Escalonamento do job.
   • Configurar pull único para executar um pull de dados único.
     Qdica: Você pode alterar as configurações de programação mais tarde; consulte Recuperando dados para obter mais informações sobre execuções únicas e Programação de tarefas para obter mais informações sobre execuções regulares.
2. Na seção Dados incrementais adicionais, você pode indicar quantos dados adicionais (em dias ou horas) devem ser chamados durante uma execução incremental para garantir que todos os dados históricos relevantes estão disponíveis para transferência de saída (opcional).
   Qdica: o valor máximo para este campo é 30 dias.
3. Clique em Seguinte.

Etapa 13: 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. 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.
2. Quando você clica em Concluir, acontece o seguinte: Os pulls ú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

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