Adicionar contatos e transações à tarefa XMD

Sobre a tarefa Adicionar contatos e transações a XMD

A tarefa Adicionar contatos e transações ao XMD permite que você mapeie dados importados para o Qualtrics para seu XM Directory. Por exemplo, você pode usar uma tarefa Extrair dados de arquivos SFTP para importar dados no Qualtrics e depois mapeá-los para seu diretório.

Esta tarefa é semelhante à tarefa Carregar dados da conta B2B no XM Directory, mas permite que você mapeie dados de contato e dados transacionais para o XM Directory.

Configurando uma tarefa Adicionar contatos e transações para XMD

1. Clique no menu de navegação no canto superior esquerdo.
   
2. Selecione Workflows.
3. Clique em Criar um fluxo de trabalho.
4. Determine se o workflow deve ser Programado ou Baseado em eventos. Para uma comparação dessas opções, consulte Workflows programados vs. workflows baseados em eventos.
   Qdica: Normalmente, você usará um fluxo de trabalho programado para que os dados fiquem atualizados regularmente.
5. Dê um nome ao seu fluxo de trabalho.
6. Determine quando o workflow deve ser executado (se um workflow escalonado) ou o evento que aciona o workflow (se um workflow baseado em eventos) deve ser executado.
7. Clique no sinal de mais ( + ) e depois em Tarefa para configurar a tarefa de extração de dados que importa dados para o Qualtrics. Você deve configurar primeiro uma tarefa de extração de dados antes de usar a tarefa Carregar dados da conta B2B no XM Directory. Consulte o uso de tarefas de fluxos de trabalho para criar fluxos de trabalho ETL para obter mais informações.
   Qdica: os arquivos devem ter menos de 50 MB para serem compatíveis com a tarefa Adicionar contatos e transações ao XMD.
8. Clique no sinal de mais ( + ) e, em seguida, em Tarefa.
   
9. Escolha a tarefa Adicionar contatos e transações ao XMD.
   
10. Selecione o diretório para o qual os dados devem ser mapeados.
    
    Qdica: A maioria das licenças só tem um diretório padrão, mas algumas podem ter vários diretórios.
11. Selecione uma lista de destinatários para a qual os dados devem ser mapeados. Você também pode optar por criar uma nova lista de destinatários para esse diretório cada vez que o fluxo de trabalho for executado.
12. Selecionar uma fonte de dados. Esta deve ser a tarefa do extrator de dados que você instalou anteriormente.
13. Use os menus suspensos para mapear campos da tarefa de extração de dados para o XM Directory.
    
    Qdica: Você também pode mapear valores de campo individuais. Consulte Mapeamento de valores de campo para mais informações.
14. Para adicionar campos personalizados ao seu mapeamento, clique em Adicionar campo.
    Qdica: Os campos de origem só podem ser mapeados para um campo de destino na tarefa.
15. Se você quiser mapear dados transacionais além dos dados de contato, selecione um campo a ser utilizado como a data de transação.
    
    Atenção: ao mapear dados transacionais, você deve mapear pelo menos um campo de contato na seção acima. Você também deve selecionar uma lista de contatos à qual seus dados de transação serão adicionados.

    Qdica: Ao mapear campos de data de transação durante a configuração da sua tarefa, as datas da transação são as datas em que uma transação ocorreu. As datas serão consideradas em UTC, a menos que o fuso horário seja incluído explicitamente no valor da data. Mais informações sobre esses formatos podem ser encontradas na página de suporte Sintaxe de formato de data. Aqui está uma lista de formatos de hora compatíveis:

    • ISO-8601 (2006-01-02T15:04:05+07:00)
    • ANSIC (Seg Jan _2 15:04:05 2006)
    • UnixDate (Seg Jan _2 15:04:05 MST 2006)
    • RFC822 (02 Jan 06 15:04 MST)
    • RFC850 (segunda-feira, 02-Jan-06 15:04:05 MST)
    • RFC1123 (Seg, 02 Jan 2006 15:04:05 MST)
16. Clique em Adicionar campo para adicionar mais campos de transação personalizados e use os menus suspensos para mapear valores para esses campos.
    Qdica: o campo de data da transação é obrigatório e você não poderá mapear campos de transação adicionais sem mapear um valor para esse campo.
17. Ao concluir o mapeamento de campos, clique em Salvar.
    Qdica: Esta tarefa obedece às regras de deduplicação de contato do seu diretório.

Mapeamento de valores de campo

Você pode mapear valores de campo individuais para salvar no Qualtrics. Você tem a opção de mapear campos manualmente ou de carregar um arquivo contendo seus mapeamentos. Além disso, você pode determinar o que acontece a campos não mapeados.

Para iniciar o mapeamento de valores de campo, clique em Substituir todos os valores à esquerda pelos valores à direita, abaixo do campo desejado.

VALORES DE MAPEAMENTO COM UM CARREGAMENTO DE ARQUIVO

Você tem a opção de carregar um arquivo CSV ou TSV que contenha seu mapeamento. Isso é recomendado se você tiver muitos valores para mapear. Se você já tiver mapeado alguns valores, carregar um arquivo não substituirá esses mapeamentos. Seus mapeamentos recém-adicionados serão adicionados abaixo dos valores já mapeados.

1. Clique em Substituir todos os valores à esquerda pelos valores à direita.
   
2. Clique em Fazer download do modelo CSV. Recomendamos baixar o modelo, pois ele contém a formatação correta.
3. Abra esse arquivo em um editor de planilhas em seu computador, como Microsoft Excel ou Google Sheets.
4. As duas primeiras células conterão os cabeçalhos “de” e “até”. Estes representam seus valores de origem e de destino, respectivamente.
   
5. Adicione seus valores de campo. Seus valores de origem vão para a coluna “de” e os valores de destino vão para a coluna “para”. Certifique-se de que seu arquivo cumpre os seguintes requisitos:
   • Você pode ter até 500 pares de mapeamento. Se seu arquivo tiver mais de 500 mapeamentos, você receberá uma mensagem de erro e somente as primeiras 500 linhas serão carregadas.
   • Certifique-se de que seu arquivo contenha os cabeçalhos “de” e “até”. Se esses cabeçalhos não forem detectados, a Qualtrics assumirá que a primeira coluna é “de” e a segunda coluna é “até”.
6. Salve seu arquivo como CSV ou TSV com codificação UTF-8.
7. Na tarefa Adicionar contatos e transações ao XMD, clique em Escolher arquivo e, em seguida, selecione o arquivo do seu computador. Seu mapeamento carregado será preenchido na tarefa.
   

VALORES DE MAPEAMENTO MANUALMENTE

Você também pode mapear valores de campo manualmente. Isso é recomendado se você só tiver alguns valores para mapear.

1. Clique em Substituir todos os valores à esquerda pelos valores à direita.
   
2. Inserir o valor de origem na primeira coluna
3. Inserir o valor de destino na segunda coluna
4. Clique no sinal de mais azul ( + ) para adicionar outro par de mapeamento.

PROCESSAMENTO DE CAMPOS NÃO MAPEADOS

Se um valor de campo não for mapeado, o campo será importado para o Qualtrics usando seu valor de origem. No entanto, você pode optar por mapear todos os valores não mapeados para um valor de campo padrão.

1. Clique em Substituir todos os valores à esquerda pelos valores à direita.
   
2. Ative Mapear campos não mapeados para um campo padrão.
3. Insira o valor do campo padrão.

EXCLUIR MAPPINAS

1. Clique no sinal de menos ( – ) ao lado de um par de mapeamento para excluir o mapeamento.
   
2. Clique em Limpar tudo para excluir todos os mapeamentos para esse campo.

Dicas de Solução de Problemas

• Ao investigar o que ocorreu de errado com uma tarefa de workflow, verifique se há erros no relatório Fluxos de trabalho e corrija-os antes de tentar novamente sua tarefa.
• A deduplicação de contato permite que você repita sua tarefa sem criar contatos duplicados. Certifique-se de configurar as regras de deduplicação de contato ao testar e repetir esta tarefa.

Perguntas frequentes