Tarefa Marketo

Sobre tarefas do Marketo

A tarefa do Marketo permite que você transfira dados da Qualtrics para o Marketo. Você pode utilizar esses dados para criar ou atualizar um Marketo Lead ou criar uma ou mais atividades do Marketo. Atividades personalizadas podem ser usadas no Marketo para filtrar dados ou criar acionadores. Ao configurar esta tarefa, você pode selecionar uma das três opções:

• Criar uma atividade Marketo: vincule uma única atividade à sua tarefa para criar uma atividade para cada resposta que um lead assume. Isso significa que você pode selecionar os campos de resposta que deseja transferir para o Marketo como atributos da atividade.
• Criar várias atividades Marketo: vincule várias atividades à sua tarefa para criar várias atividades para cada resposta que um lead assume. Para esta tarefa, cada ponto de dados conectado a uma resposta será contado como uma nova atividade.
• Criar ou atualizar um lead do Marketo: vincule uma resposta de pesquisa a um lead Marketo novo ou existente. Após a criação do lead, você terá um ID de lead que poderá utilizar na atividade subsequente Criar um Marketo ou Criar várias tarefas de atividades do Marketo.

Configuração do Marketo

Existem algumas ações que você terá que tomar em sua conta do Marketo antes de poder usar esta extensão.

1. Crie atividades personalizadas para as quais você deseja mapear campos do Qualtrics.
2. Crie um usuário e uma função de API para usar na extensão Marketo. Certifique-se de conceder ao usuário e à função permissão para criar e atualizar atividades.
3. Obtenha o ID do cliente, o segredo do cliente e o ID de Munchkin da sua instância.

Consulte a Visão geral da extensão Marketo para obter mais informações sobre como configurar sua conta do Marketo.

Configuração inicial da tarefa Marketo

Depois de preparar sua conta do Marketo, é hora de começar a configurar a tarefa do Marketo na Qualtrics. Esta seção abordará a configuração inicial para conectar uma conta do Marketo e selecionar a tarefa desejada no Marketo.

1. Em sua pesquisa, vá para a guia Fluxos de trabalho.
   
2. Clique em Criar um fluxo de trabalho.
3. Selecione Iniciado quando um evento é recebido.
4. Defina o Evento que acionará o fluxo de trabalho no Marketo. Na maioria das vezes, esta será uma Resposta da pesquisa da Qualtrics.
   
5. Se desejar, clique no sinal de mais ( + ) e, em seguida, em Condições para definir as condições sob as quais o workflow é acionado.
   Qdica: Isso é mais útil se você não quiser que atividades personalizadas sejam criadas no Marketo sempre que uma resposta for enviada à pesquisa.
6. Clique no sinal de mais ( + ) e, em seguida, em Tarefa.
7. Selecione Marketo.
   
8. Selecione a tarefa que você deseja executar no Marketo.
   
   Suas opções incluem:
   • Criar várias atividades Marketo: crie várias atividades Marketo para cada resposta da pesquisa.
   • Criar uma atividade Marketo: crie uma atividade Marketo para cada resposta da pesquisa.
   • Criar ou atualizar um lead Marketo: crie ou atualize um número de telefone, endereço de e-mail e muito mais de um lead.
9. Clique em Seguinte.
10. Escolha uma conta do Marketo à qual se conectar. Você poderá selecionar quaisquer contas conectadas anteriormente, bem como contas conectadas pelos Administradores da marca para uso da marca.
    
11. Para conectar uma nova conta, clique em Adicionar conta de usuário.
    Qdica: Depois de clicar em Adicionar conta de usuário, dê um nome à sua conta para identificá-la. Em seguida, adicione seu ID de cliente e chave secreta do cliente.
    
    Qdica: Seu ID de cliente e Segredo do cliente podem ser encontrados indo para Administrador e, em seguida, Ponto de inicialização no Marketo. Quando chegar lá, clique em Exibir detalhes ao lado do seu serviço.
    
12. Clique em Seguinte.
13. Insira sua ID de Munchkin.
    
    Qdica: A ID do Munchkin é os primeiros 11 caracteres em seu URL de identidade no Marketo.
14. Clique em Verificar.
15. O restante da configuração da tarefa dependerá da opção que você selecionou na etapa 8. Visite as seções vinculadas para obter mais informações:
    • Criar uma atividade Marketo
    • Criar várias atividades Marketo
    • Criar ou atualizar um lead Marketo

Criar uma atividade do Marketo

A vinculação de uma única atividade criará uma atividade do Marketo para cada resposta da pesquisa que um lead realizar. Com esta opção, você pode escolher os campos de resposta que deseja transferir para o Marketo como atributos da atividade.

1. Siga as etapas na seção Configuração inicial da tarefa Marketo e escolha Criar uma atividade do Marketo como sua tarefa.
2. Use o menu suspenso Selecionar atividade para escolher uma atividade personalizada.
   
   Qdica: As atividades disponíveis neste menu suspenso dependem das atividades personalizadas que você configurou no Marketo. Consulte a documentação do Marketo sobre atividades para obter assistência.
   Atenção: se você não vir nenhuma atividade na lista suspensa da atividade, poderá ter inserido as credenciais incorretas. Se você estiver usando as credenciais corretas, talvez seja necessário ajustar as permissões concedidas para o usuário ou função no Marketo. Consulte Configuração do Marketo para obter mais informações.
3. Insira o campo ID do lead clicando no ícone de texto transportado {a} e selecionando o campo de dados integrado que corresponde ao ID do lead. Isso pode vir de dados integrados externos salvos em uma lista de destinatários ou dados transferidos de tarefas anteriores.
   Qdica: para que as respostas sejam enviadas ao Marketo, cada resposta deve ter um ID de lead, uma vez que as atividades personalizadas estão conectadas aos leads no Marketo.
   Exemplo: você pode usar a tarefa Criar ou atualizar um lead do Marketo para primeiro criar ou atualizar um lead no Marketo, o que tornará o ID do lead um campo disponível na Qualtrics. Em seguida, utilize a tarefa de atividade Criar um Marketo para inserir uma atividade. O menu de texto transportado conterá o ID do lead a ser transportado.
4. Mapeie o atributo principal da sua atividade, que é obrigatório. Nesse caso, é o ID exclusivo da resposta, então selecionamos o texto transportado para ID da resposta.
5. Para adicionar campos adicionais, clique em Adicionar um campo e escolha o campo Marketo e o campo de origem da Qualtrics. Para seus campos de origem, clique no ícone de texto transportado {a} e escolha o campo da Qualtrics a ser usado. Os campos disponíveis neste menu dependerão de seu evento selecionado. Se você escolheu um evento de resposta de pesquisa, suas opções são:
   • Pergunta da pesquisa: A resposta do respondente a uma pergunta da pesquisa.
   • Campo de dados integrados: um campo de dados integrados.
   • Localização GeoIP: o código postal, cidade, estado/região, código de área ou nome do país para a resposta com base nos dados GeoIP.
   • Data/hora: a data/hora atual ou uma data/hora relativa à data/hora atual
   • Campo do painel: o nome, sobrenome, e-mail, referência de dados externos e idioma do respondente, se salvo em uma lista de destinatários.
   • Cota: indica se a resposta aumentou a cota de uma pesquisa.
   • Resposta: ID das respostas e link de resposta.
   • Status: o status da resposta.
6. Para remover um campo, clique no sinal negativo ( – ) ao lado do campo.
7. Clique em Salvar para concluir.

Criar várias atividades Marketo

Se você vincular várias atividades do Marketo a um evento na Qualtrics, cada ponto de dados conectado a uma resposta será considerado uma nova atividade. Isso inclui todos os campos de perguntas e dados integrados conectados à resposta.

1. Siga as etapas na seção Configuração inicial da tarefa Marketo e escolha Criar uma atividade do Marketo como sua tarefa.
2. Use o menu suspenso Selecionar atividade para escolher uma atividade personalizada.
   
   Qdica: As atividades disponíveis neste menu suspenso dependem das atividades personalizadas que você configurou no Marketo. Consulte a documentação do Marketo sobre atividades para obter assistência.
   Atenção: se você não vir nenhuma atividade na lista suspensa da atividade, poderá ter inserido as credenciais incorretas. Se você estiver usando as credenciais corretas, talvez seja necessário ajustar as permissões concedidas para o usuário ou função no Marketo.
3. Insira o campo ID do lead clicando no ícone de texto transportado {a} e selecionando o campo de dados integrado que corresponde ao ID do lead. Isso pode vir de dados integrados externos salvos em uma lista de destinatários ou dados transferidos de tarefas anteriores.
   Qdica: para que as respostas sejam enviadas ao Marketo, cada resposta deve ter um ID de lead, uma vez que as atividades personalizadas estão conectadas aos leads no Marketo.
   Exemplo: você pode usar a tarefa Criar ou atualizar um lead do Marketo para primeiro criar ou atualizar um lead no Marketo, o que tornará o ID do lead um campo disponível na Qualtrics. Em seguida, utilize a tarefa de atividade Criar um Marketo para inserir uma atividade. O menu de texto transportado conterá o ID do lead a ser transportado.
4. Mapeie o atributo principal da sua atividade, que é obrigatório. Nesse caso, é o ID exclusivo da resposta, então selecionamos o campo ID da resposta.
5. Para adicionar campos adicionais, clique em Adicionar um campo e escolha o campo Marketo e o campo de origem da Qualtrics. Para seus campos de origem, você pode escolher a partir de uma lista de atributos predefinidos do Qualtrics:
   • SurveyID: ID exclusivo da pesquisa Qualtrics na qual você está definindo a tarefa.
   • ResponseID: ID da resposta definido pela Qualtrics.
   • QuestionID: ID definido pela Qualtrics para perguntas em sua pesquisa.
   • ExportTag: tag usada para identificar perguntas em sua pesquisa. O usuário pode editá-las. Consulte Exportar tags.
   • Texto da opção de resposta: texto para as opções que o respondente selecionou. Também conhecido como Nomes de variáveis.
   • ChoiceRecode: recodifique valores para as opções que o respondente selecionou.
   • InbeddedDataField: nome do campo Dados integrados definidos pelo usuário.
   • InbeddedDataValue: valor do campo Dados integrados.
     Exemplo: Veja como será seu mapeamento se você adicionar todos os campos disponíveis:
     
6. Para remover um campo, clique no sinal negativo ( – ) ao lado do campo.
7. Quando terminar, clique em Salvar.

Criar ou atualizar um lead do Marketo

A criação ou atualização de um lead no Marketo permite que você obtenha dados do evento da Qualtrics, como uma resposta da pesquisa, e crie um novo lead no Marketo com essas informações ou atualize o lead com novas informações. Como parte de uma criação ou atualização com êxito, o ID do lead será retornado e poderá ser utilizado com a atividade Criar um Marketo ou Criar várias atividades do Marketo.

1. Siga as etapas na seção Configuração inicial da tarefa Marketo e escolha Criar uma atividade do Marketo como sua tarefa.
2. Selecione o Tipo de evento para criar ou atualizar o lead. Cada opção modificará ligeiramente a configuração da tarefa.
   
   • Crie ou atualize um lead: tentará encontrar o lead no Marketo primeiro e atualizar os campos mapeados para esse usuário. Se o lead não for encontrado, um novo lead será criado com os campos mapeados.
   • Apenas para criar: tentará criar um novo lead no Marketo. Se o lead já existir, Marketo retornará um erro.
   • Somente atualização: tentará atualizar um lead existente no Marketo. Se o lead não existir, o marketo retornará um erro.
3. Se você selecionou “Apenas criar”, ignore esta etapa, pois você está criando um novo lead. Se você selecionou “Criar ou atualizar um lead” ou “Apenas atualização”, precisará selecionar um campo de pesquisa para procurar o lead no Marketo. Use o menu suspenso O que pesquisar para selecionar um campo.
   
   Qdica: Os campos que você pode pesquisar normalmente serão um subconjunto de todos os campos principais. Esses são considerados campos pesquisáveis. Veja mais informações sobre campos pesquisáveis nesta página de suporte do Marketo.
4. Se você selecionou “Apenas criar”, ignore esta etapa, pois você está criando um novo lead. Se você selecionou ‘Criar ou atualizar um lead’ ou ‘Só atualizar’, precisará mapear o campo selecionado como um campo obrigatório. Este campo é utilizado para identificar se o lead já existe no Marketo. Use o ícone de texto transportado {a} para selecionar um campo da Qualtrics.
   
5. Para adicionar campos adicionais, clique em Adicionar um campo e escolha o campo Marketo e o campo de origem da Qualtrics. Para seus campos de origem, clique no ícone de texto transportado {a} e escolha o campo da Qualtrics a ser usado. Os campos disponíveis neste menu dependerão de seu evento selecionado. Se você escolheu um evento de resposta de pesquisa, suas opções são:
   
   • Pergunta da pesquisa: A resposta do respondente a uma pergunta da pesquisa.
   • Campo de dados integrados: um campo de dados integrados.
   • Localização GeoIP: o código postal, cidade, estado/região, código de área ou nome do país para a resposta com base nos dados GeoIP.
   • Data/hora: a data/hora atual ou uma data/hora relativa à data/hora atual
   • Campo do painel: o nome, sobrenome, e-mail, referência de dados externos e idioma do respondente, se salvo em uma lista de destinatários.
   • Cota: indica se a resposta aumentou a cota de uma pesquisa.
   • Resposta: ID das respostas e link de resposta.
   • Status: o status da resposta.
6. Para remover um campo, clique no sinal negativo ( – ) ao lado do campo.
7. Clique em Salvar para concluir

Perguntas frequentes