Conector de entrada do Qualtrics Social Connect

Sobre o conector de entrada do Qualtrics Social Connect

Você pode usar o conector de entrada Qualtrics Social Connect para carregar dados de canais digitais da sua conta Qualtrics Social Connect para o XM Discover.

Upload de dados do Qualtrics Social Connect no XM Discover

Antes de começar

Antes de configurar uma tarefa usando o conector de entrada Qualtrics Social Connect, certifique-se de ter suas credenciais de conta Qualtrics Social Connect.

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 Qualtrics Social Connect.
   

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

Depois de configurar a conexão, siga estas etapas para criar um job de conector de entrada Qualtrics Social Connect e configurar os dados que são enviados para o XM Discover:

• Etapa 1: fornecer nome do job
• Etapa 2: especificar projeto e descrição
• Etapa 3: Conectar sua conta do Qualtrics Social Connect
• Etapa 4: selecionar um tipo de dados e tópicos
• Etapa 5: Configuração da consulta (opcional)
• Etapa 6: Mapear os campos desejados para o XM Discover
• Etapa 7: Substituição e redação de dados (opcional)
• Etapa 8: Especificar filtro (opcional) e limite de registros
• Etapa 9: Configuração de notificação (opcional)
• Etapa 10: Configurar opções adicionais para job
• Etapa 11: 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: Conectar sua conta do Qualtrics Social Connect

1. Na página Conectar sua conta Qualtrics Social Connect, você pode selecionar um conjunto de credenciais existente no menu suspenso.
   
   Qdica: você pode adicionar um novo conjunto de credenciais. Para obter informações sobre novas credenciais, consulte Adicionar novas credenciais Dados integrados.
   Qdica: Se o código de autorização expirar ao conectar sua conta Qualtrics Social Connect ao XM Discover selecionando um conjunto de credenciais existente, clique no botão Reautorizar para emitir um novo código.
2. Clique em Seguinte.

Etapa 4: selecionar um tipo de dados e tópicos

1. Na página Selecionar um tipo de dados e tópicos, selecione o tipo de dados a serem carregados. As opções disponíveis são:

• Processar menções individuais como documentos: processar menções individuais como documentos separados.
• Processar casos resolvidos como conversações: processar casos inteiros como documentos conversacionais.
  
  Qdica: isso só funciona para casos resolvidos (casos em andamento não serão carregados).

2. Selecione os projetos e os tópicos a serem usados para o upload.
   
   Qdica: expanda o nome do projeto para ver todos os tópicos disponíveis, suas definições de pesquisa e perfis monitorados.
3. Clique em Seguinte.
   Qdica: você pode atualizar tópicos depois que uma tarefa é criada.

Etapa 5: Configuração da consulta (opcional)

1. Na página Configuração de consulta, você pode restringir ainda mais sua consulta de pesquisa selecionando os filtros criados no Qualtrics Social Connect no menu.
   
2. Clique em Seguinte.

Etapa 6: 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. Para obter informações sobre campos de dados conversacionais, consulte Campos de dados conversacionais Dados integrados.
   
   Qdica: Para obter mais informações sobre mapeamento de dados, consulte Configuração do mapeamento de dados.
4. Clique em Seguinte.

Etapa 7: 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 8: 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 9: 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 zero registros forem carregados no projeto
   • Notificar quando valores faltantes consecutivos 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 esta tarefa falhar
     

2. Clique em Seguinte.

Etapa 10: 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
    

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 11: 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.

Adicionar novas credenciais

1. Para adicionar um novo conjunto de credenciais, selecione Adicionar Novo no menu suspenso de credenciais.
   
2. Insira o nome do novo conjunto de credenciais na caixa NOME DA CONEXÃO.
3. Selecione o ambiente ao qual se conectar no menu suspenso AMBIENTE DE CONEXÃO SOCIAL QUALTRICS. As opções de ambiente disponíveis são:

• App: EMEA (app.engagor.com)
• us: EUA (us.engagor.com)

4. Verifique se você está conectado ao Qualtrics Social Connect usando a conta correta e clique em Autorizar.
   
   
5. Revise as informações que serão compartilhadas e clique em Autorizar app.
   
6. 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 trabalho, selecione a caixa Enviar notificações de vencimento . Isso ativa a caixa Dias antes do vencimento.
   
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 for executada quando a data de expiração for menor que o número de dias definido na caixa Dias antes da expiração.
8. Selecione a Data de vencimento a partir do selecionador de data de calendário. A data de vencimento será adicionada à caixa Data de vencimento.

Mapeamento de origem padrão

Estes são os campos de dados padrão para o conector de entrada do Qualtrics Social Connect:

1. natural_id 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 é 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:

• date.added (padrão): Registro da hora UNIX (em UTC) de quando a publicação foi indexada pelo Qualtrics Social Connect.
• date.published: Registro da hora UNIX (em UTC) de quando a publicação foi publicada.
  
• Se os dados de origem contiverem outros campos de data, você pode definir 1 deles como Data do documento, selecionando-os na coluna Nome do campo.
  Qdica: você também pode definir uma data específica adicionando um campo personalizado. Para mais informações, consulte Definir uma data do documento específica.

3. O provedor de feedback ajuda você a identificar dados obtidos de um provedor específico. Para documentos do Qualtrics Social Connect, o valor deste atributo está definido como Qualtrics Social Connect.
4. A fonte de 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 deste atributo é definido como Qualtrics Social Connect, mas você pode fornecer seu próprio valor na coluna Valor codificado.
5. feedack_type 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 Social Connect, o valor deste atributo está definido como Social.
6. job_name 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.
7. loadDate indica quando um documento foi carregado no XM Discover. Este campo é definido automaticamente.

Campos de dados conversacionais

Na seção Mapeamento de origem, você pode configurar os seguintes campos de dados conversacionais.

1. richVerbatim: Para dados conversacionais (como interações de chamada e chat), o XM Discover usa um formato conversacional na íntegra para o campo richVerbatim. Este formato suporta a ingestão de metadados específicos do diálogo necessários para desbloquear a visualização conversacional (turnos do falante, silêncio, eventos conversacionais, etc.) e enriquecimentos (hora de início, duração, etc.). Este campo literal inclui campos “filhos” para rastrear o lado do cliente e do representante da conversa:

• clientVerbatim acompanha o lado do cliente da conversa.
• agentVerbatim rastreia o lado (do agente) do representante da conversa.
• desconhecido rastreia o lado desconhecido da conversa.
  
  Qdica: Transformações não são suportadas para campos textuais conversacionais.
  Qdica: O mesmo texto não pode ser usado para diferentes tipos de dados conversacionais. Se você quiser que seu projeto hospede vários tipos de conversa, use pares separados de conversações textuais por tipo de conversa.

2. clientVerbatim (para dados conversacionais): rastreia o lado do cliente da conversa em interações de chamada e chat. Por padrão, este campo é mapeado para:

• clientVerbatimChat para interações digitais.
• clientVerbatimCall para interações de chamada.
  Qdica: você pode mapear este campo para um campo literal diferente, se necessário.

3. agentVerbatim (para dados conversacionais): rastreia o lado do representante da conversa em interações de chamada e chat. Por padrão, este campo é mapeado para:

• agentVerbatimChat para interações digitais.
• agentVerbatimCall para interações de chamada.
  Qdica: você pode mapear este campo para um campo literal diferente, se necessário.

4. desconhecido (para dados conversacionais): rastreia o lado desconhecido da conversa em interações de chamada e chat. Por padrão, este campo é mapeado para:

• unknownVerbatimChat para interações digitais.
• unknownVerbatimCall para interações de chamada.
  Qdica: você pode mapear este campo para um campo literal diferente, se necessário.

Atualizando tópicos para vagas do Qualtrics Social Connect

Você pode atualizar os tópicos (também conhecidos como fluxos) para que as tarefas do Qualtrics Social Connect adicionem ou removam fluxos e extraiam dados para o XM Discover.

1. Iniciar sessão nos conectores.
2. Certifique-se de que a guia JOBS esteja aberta.
   
3. Localize o trabalho que deseja atualizar.
4. Expanda o menu de ações ao lado do job.
5. Selecione Atualizar tópicos.
6. Na janela Atualizar tópicos que é aberta, selecione o tipo de dados a serem carregados:
   • Processar menções individuais como documentos: processar menções individuais como documentos separados.
   • Processar casos resolvidos como conversações: processar casos inteiros como documentos conversacionais.
     
     Qdica: somente casos resolvidos são processados. Os casos em andamento não são carregados.
7. Selecionar projetos e tópicos a serem usados para o upload.
   
   Qdica: expanda o nome do projeto para ver todos os tópicos disponíveis, suas definições de pesquisa e perfis monitorados.
8. Clique em OK.