Guia de migração do Adobe Analytics

Migração do Adobe Analytics

Atualmente, o Website Feedback da Qualtrics suporta uma extensão bidirecional com o Adobe Analytics, que permite o direcionamento de interceptores com base em variáveis do Adobe Analytics, bem como a troca de dados da Qualtrics de volta para o Adobe.

A extensão para enviar dados da Qualtrics de volta para a Adobe é atualmente baseada na tecnologia do Adobe Data Connector. A Adobe anunciou o fim da vida útil da tecnologia de conector de dados para extensões, a partir de 1º de agosto de 2021. Embora novos conectores de dados não possam ser criados após o dia 1 de agosto, os conectores de dados existentes continuarão funcionando até pelo menos 31 de dezembro. Isso afetará apenas as pesquisas que estão atualmente enviando dados da Qualtrics para a Adobe. Isso não afetará nenhuma integração que capture dados do Adobe de sites da Qualtrics.

A Qualtrics desenvolveu uma nova extensão do Adobe Analytics usando fluxos de trabalho, que contém duas novas tarefas que enviarão dados da Qualtrics de volta para a Adobe:

• Tarefa de classificação: esta tarefa permite que os usuários carreguem campos de pesquisa para o Adobe Report Suite para fins de mapeamento. Esta tarefa será executada cada vez que uma pesquisa for publicada.
• Tarefa de upload de dados: esta tarefa envia dados de resposta para o Adobe Report Suite. Esta tarefa será executada sempre que uma resposta da pesquisa for enviada.

Como parte da migração, a Qualtrics criará automaticamente os fluxos de trabalho acima para cada pesquisa atualmente ativada para sincronização de dados do Adobe Analytics e tem respostas Adobe. Os usuários só terão que configurar um pequeno conjunto de campos, como informações de autenticação Adobe e IDs.

Workflows criados automaticamente

Como parte da migração, a Qualtrics criou automaticamente dois novos fluxos de trabalho Adobe para todas as pesquisas existentes que atualmente usam um conector de dados para enviar dados de resposta para o Adobe. Os usuários precisarão inserir suas informações de autenticação Adobe para que esses fluxos de trabalho sejam ativados. Até que essas informações de autenticação sejam inseridas, a página Fluxos de trabalho exibirá fluxos de trabalho incompletos.

Ativação da nova integração Adobe Analytics

Para ativar a nova integração do Adobe Analytics, você precisará ativar ambos os novos fluxos de trabalho gerados pela Qualtrics.

1. Navegue para a página Fluxos de trabalho.
   
2. Clique no fluxo de trabalho “Definição da pesquisa” criado pela Qualtrics.
   
   Qdica: Clique em Instruções passo a passo no canto superior direito para ver essas instruções durante a criação do fluxo de trabalho.
3. Escolha se deseja iniciar o fluxo de trabalho quando a pesquisa for Ativada, Fechada ou Publicada.
   
   Qdica: a Qualtrics recomenda iniciar este fluxo de trabalho somente quando a pesquisa é publicada.
4. Clique em Concluir.
5. As condições do fluxo de trabalho serão configuradas automaticamente para iniciar o fluxo de trabalho somente quando o ID da pesquisa for igual ao projeto de pesquisa correto. Clique em Editar condições se você quiser fazer ajustes adicionais. Consulte Criando condições para obter maiores informações sobre a criação e o ajuste de condições.
   
6. Selecione a tarefa Carregar classificações do Adobe Analytics.
7. Selecione sua conta ou clique em Adicionar uma conta de usuário, se você ainda não tiver adicionado uma conta Adobe.
   
   Atenção: se você não tiver criado anteriormente uma conta para autenticar no Adobe, será solicitado que forneça as credenciais Adobe que obteve na seção Adobe Authentication Secrets.
8. Insira os detalhes da sua conta Adobe.
   
9. Selecione Conectar conta.
10. Assim que sua conta for selecionada, clique em Seguinte.
    
11. Verifique se as variáveis ID da suíte de relatórios e Lista de respostas estão corretas e se correspondem ao que você vê em sua conta Adobe.
    
12. Clique em Salvar.
13. Assim que seu workflow for salvo, clique em Voltar.
    
14. Selecione o fluxo de trabalho “Resposta da pesquisa” criado pela Qualtrics.
    
15. Selecione Resposta da pesquisa.
    
16. Confirme se o projeto de pesquisa correto está selecionado na lista suspensa.
    
17. Clique em Avançar.
18. Escolha se deseja iniciar o fluxo de trabalho quando uma nova resposta de pesquisa é criada, uma resposta existente é atualizada via API ou ambos.
    
19. Clique em Concluir.
20. Selecione a tarefa Enviar dados para o Adobe Analytics.
    
21. Selecione sua conta ou clique em Adicionar uma conta de usuário, se você ainda não tiver adicionado uma conta Adobe. Siga as etapas 8 a 9 para conectar uma nova conta de usuário.
    
22. Clique em Seguinte.
23. Verifique se a variável ID do conjunto de relatórios, a variável da lista de respostas e a variável ID da resposta estão corretas e correspondem ao que você vê na sua conta Adobe.
    
24. Verifique Enviar registro da hora com dados se o seu conjunto de relatórios tiver a configuração “Registros da hora necessários” ativada. Você pode verificar essas configurações em sua conta Adobe. Para mais informações, consulte a documentação do registro da hora Adobe.
25. Marque Incluir respostas parciais se você quiser que respostas parciais sejam enviadas para o seu conjunto de relatórios. Consulte os eventos de resposta da pesquisa para saber mais sobre como iniciar um fluxo de trabalho para respostas incompletas.
26. Clique em Salvar.
27. Volte para a página Fluxos de trabalho e ative os dois fluxos de trabalho ativando-os na coluna Ativar/desativar.
    
28. Teste se a integração está funcionando de uma das seguintes formas:
    • Acesse o Website Feedback Intercept e preencha algumas respostas de teste.
    • Visualize sua pesquisa e preencha algumas respostas de teste.
      Qdica: Se você visualizar sua pesquisa sem acessar o interceptor, precisará codificar com hardware um valor para seu campo de dados integrados Q_AA_PARMS. Por exemplo: {“marketingCloudVisitorID”:”test123″}.
29. Volte para a página Fluxos de trabalho e clique em Executar histórico.
    
30. Certifique-se de que o fluxo de trabalho para o evento de resposta da pesquisa tenha sido executado para cada resposta da pesquisa de teste enviada e tenha o status “Com êxito”.
    Qdica: Pode levar alguns minutos para que os fluxos de trabalho apareçam no Histórico de execuções.

Removendo antigos Adobe Data Connectors

Depois de ativar os novos fluxos de trabalho para envio de dados da Qualtrics para o Adobe, você precisará remover seus antigos conectores de dados Adobe.

1. Navegue até a página de Projetos.
   
2. Clique no projeto de pesquisa com o conector de dados.
   Qdica: Se você não tiver certeza do nome da pesquisa, isso pode ser encontrado consultando qualquer um dos seus novos fluxos de trabalho Adobe.
   
3. Ir para Opções de pesquisa.
   
4. Clique em Adobe Analytics. Isso pode ser encontrado em “Opções avançadas” na parte inferior.
   Atenção: se aparecer uma mensagem de erro, clique em OK. Isso pode aparecer porque a Adobe descontinuou sua tecnologia de conector de dados.
5. Desmarque as integrações selecionadas. Os conectores de dados serão exibidos como “Desconhecidos” porque a Adobe descontinuou sua tecnologia de conector de dados.
   
6. Clique em Salvar.

Adobe Authentication Secrets

Você precisará fornecer suas credenciais da Adobe para permitir que a Qualtrics faça a autenticação no pacote de relatórios do Adobe Analytics. Isso é necessário ao ativar os novos fluxos de trabalho do Adobe Analytics.

CHEGANDO TÍTULOS DE AUTENTICAÇÃO ADÓVEIS

Você precisará fornecer as seguintes credenciais no Qualtrics ao configurar seus fluxos de trabalho Adobe e criar uma conta para interagir com o Adobe Analytics.

• ID do Cliente: o ID do Cliente fornecido no console Adobe como parte dos detalhes da Credencial.
• Segredo do cliente: O segredo do cliente fornecido no console Adobe como parte dos detalhes da credencial.
• ID da conta técnica: o ID da conta técnica fornecido no console Adobe como parte dos detalhes da credencial.
• ID da organização: a ID da organização fornecida no console Adobe como parte dos detalhes da credencial. Este ID é uma cadeia alfanumérica de 24 caracteres, seguida por @AdobeOrg.
• Chave privada: a chave que corresponde à chave pública anexada à sua conexão de conta de serviço.
  Atenção: certifique-se de copiar todo o conteúdo do arquivo de chave privada da Adobe, incluindo as seções “—–BEGIN PRIVATE KEY—–” e “—–END PRIVATE KEY—–“.

CRIAR TÍTULOS DE AUTENTICAÇÃO ADOBE

Se você ainda não tiver segredos de autenticação, siga estas etapas para criá-los. Visite a documentação de suporte da Adobe para obter mais informações.

1. Navegue para a página de projetos da sua conta Adobe.
2. Clique em Criar novo projeto.
   
3. Clique em Adicionar API.
   
4. Selecione “Adobe Analytics”.
   
5. Selecione Conta de serviços (JWT) como método de autenticação.
   
6. Clique em Seguinte.
7. Escolha se você deseja que o Adobe gere um par de chaves para você ou se deseja carregar sua chave pública.
   
   Qdica: Se a Adobe gerar um par de chaves para você, mantenha essa chave privada em um local seguro para usar ao configurar o fluxo de trabalho do Adobe Analytics na Qualtrics.
8. Clique em Avançar.
9. Selecione um perfil de produto que foi configurado para permissões do Adobe Analytics. Para que a integração do Qualtrics funcione, o perfil do produto selecionado precisará de permissões para os seguintes recursos:
   • Ferramentas de análise: serviços da Web e acesso ao espaço de trabalho de análise ou acesso a relatórios e análise.
   • Ferramentas do Report Suite: Classificações.
10. Salve sua API.