Integração do XM Directory com interceptores digitais

Sobre a integração do XM Directory com interceptores digitais

O XM Directory permite que você crie seu próprio painel interno com perfis avançados de seus clientes e clientes potenciais. Ter um diretório de contatos de toda a organização permite que você visualize perfis de vários pontos de contato de contatos com sua organização, facilitando do que nunca a descoberta de insights sobre a experiência deles com sua marca.

A integração do Website / App Insights com o XM Directory permite que você utilize os benefícios do XM Directory com os visitantes do seu site. Você pode configurar a frequência de contato omnichannel, garantindo que os visitantes do site não recebam um convite por e-mail se já tiverem recebido um interceptor da Web e vice-versa. Você também pode direcionar a exibição de interceptores de site e aplicativo para segmentos específicos de usuários, bem como obter insights específicos de segmento e viagem

Antes de usar esse recurso, você precisa acessar o seguinte:

1. Acesso ao XM Directory.
2. Acesso ao Website / App Feedback.
3. Contatos ou segmentos dentro de um de seus diretórios.

Configurar a integração

Diretório XM

A integração com interceptores de site usará sua configuração existente do XM Directory. Se você ainda não configurou seu diretório, consulte Introdução ao XM Directory.

Para aproveitar ao máximo a integração, siga estas melhores práticas:

• Mantenha seus contatos atualizados. Isso permite que a Qualtrics diferencie se os visitantes do seu site são contatos existentes ou novos visitantes.
  Exemplo: configure uma automação de importação de contatos para manter o XM Directory sincronizado com suas listas de clientes ou trabalhe com sua equipe de desenvolvimento para criar contatos usando o para criar um novo contato e atualizar chamadas de API de contato.
• Mesclar automaticamente contatos duplicados. Você só pode consolidar contatos recém-criados ou todos os contatos existentes. Consulte Mesclagem de contatos duplicados no XM Directory para obter mais informações.
  Qdica: mesclar contatos com base no campo Referência de dados externos garante que cada contato tenha um valor exclusivo.

Interceptores

Para acessar os benefícios do XM Directory a partir do seu projeto Website / App Insights, primeiro você precisará garantir que a Qualtrics saiba quem está visitando seu site e possa combinar essas informações com seus contatos existentes. Para isso, você precisará indicar a expressão JavaScript que é avaliada na sessão de logon do usuário para obter o ID de referência externa para o contato.

Em seguida, você precisará passar informações sobre seus visitantes para a Qualtrics. As etapas são diferentes se você estiver usando um site da Web vs. um aplicativo móvel.

Se você estiver usando um site, trabalhe com sua equipe de desenvolvimento da Web para adicionar o snippet de código abaixo ao seu site, além do código de implementação do projeto. O snippet passa o ID de referência externa do usuário para a Qualtrics para associar o visitante do site a um contato no XM Directory. Coloque este snippet de código no carregamento da página, certificando-se de que o valor do ID já foi recuperado.

Clique aqui para visualizar o snippet de código.

if(tipo de QSI === "indefinido") {

     QSI = {};

     QSI.config = {

       externalReference: extRef

     };

 }

Se você estiver usando um mobile app, trabalhe com sua equipe de desenvolvimento de mobile app para integrar com a versão mais recente do SDK para aplicativos móveis Qualtrics. Consulte a documentação da API para obter mais informações.

Vinculação com XM Directory

O Link com o XM Directory permite que você configure um link entre o interceptor e um dos seus diretórios no XM Directory. Quando esta opção é selecionada, os dados integrados de contato dos usuários são adicionados automaticamente à resposta da pesquisa. Para obter mais informações, consulte Uso de dados integrados com XM Directory. Além disso, um evento na linha do tempo do ponto de contato do XM Directory do visitante será criado sempre que seu interceptor for exibido para ele.

Uso de um único diretório

Recomendamos a vinculação a apenas 1 diretório por projeto. Isso ajuda a garantir que não existem problemas com regras de frequência de contato, especialmente se o mesmo contato existir em diretórios diferentes com regras de frequência diferentes. Ele também consolida todos os pontos de contato digitais em um único local para organização e manutenção.

Para mover os interceptores para um único diretório, primeiro escolha o diretório que deseja conectar aos interceptores. Quaisquer interceptores atualmente vinculados a esse diretório não precisam de edições. Para quaisquer interceptores vinculados a outros diretórios, vá para Opções de interceptor e desmarque Link com XMD. Você também pode vincular esse interceptor ao diretório que deseja usar daqui para frente.

Criação automática de contato

Os contatos do XM Directory podem ser criados cada vez que os usuários visitam páginas da Web com o código de implementação do projeto Qualtrics. Essa opção permite adicionar contatos automaticamente quando um interceptor é avaliado, eliminando a necessidade de uploads manuais de arquivo ou automações baseadas em SFTP.

Para ativar a criação automática de contato, você deve primeiro vincular o interceptor ao XM Directory. Em seguida, clique na marca de seleção ao lado da opção que diz Se o contato ainda não existir, crie-a automaticamente no diretório XM.

Você pode adicionar as seguintes informações para cada contato:

Primeiro nome
Sobrenome
Idioma
Pares de valores-chave adicionais (ex. “Localização”:”Seattle”,”Gênero”:”Feminino”). Você pode adicionar até 200 pares

Configuração de regras de frequência de contato para interceptores

As regras de Frequência de contato podem ser configuradas para limitar a frequência com que um interceptor é mostrado. Você pode usar regras gerais do diretório, bem como regras personalizadas para pesquisas específicas. Para pesquisas que podem ser vistas em muitos dispositivos ou navegadores, como interceptores de feedback passivo, recomendamos não usar a frequência de contato.

1. Abra um de seus projetos existentes de Website / App Feedback ou crie um novo projeto.
2. Abra um dos interceptores existentes ou crie um novo interceptor.
3. Edite as opções Frequência de exibição e Diretório XM.
   
4. Ativar Link com XM Directory.
   
   Qdica: Quando esta opção é selecionada, os dados integrados de contato dos usuários que responderem a esta pesquisa serão adicionados automaticamente às respostas da pesquisa. Consulte Usando dados integrados com XM Directory
5. Selecione o diretório.
6. Ativar regras de frequência de contato e selecionar o diretório no qual os contatos são gravados.
7. Grave suas modificações.
8. As próximas etapas diferem dependendo se você está implementando essa funcionalidade em um site ou aplicativo móvel.
   • Site: em seu site onde você iniciará o interceptor, especifique a expressão JavaScript que será avaliada na sessão do usuário conectado para obter o ID de referência externa para o contato. Esta ID de referência externa é usada para pesquisar o visitante no XM Directory e rastrear se ele viu seu interceptor.
   • App: no aplicativo onde você iniciará o interceptor, você precisará fazer uma atualização no SDK do seu aplicativo móvel para recuperar o ID de referência. Consulte a documentação API.

Configuração de segmentos para direcionamento de interceptação

Depois de criar segmentos no XM Directory, você pode usá-los na Qualtrics em muitos dos mesmos locais que as listas de destinatários e amostras, inclusive com o Website / App Insights. A combinação de XM Directory e Website / App Insights permite que você direcione a exibição de interceptores de site e aplicativo para segmentos específicos de usuários, bem como obter insights específicos de segmento e de viagem.

1. Criar um interceptor em um projeto existente ou novo de Website / App Feedback.
   Qdica: Se, em vez de criar um interceptor independente, você gostaria de assistência durante todo o processo, fique à vontade para usar nossa configuração guiada para projetos de Website / App Feedback. Se você usar a configuração guiada, será solicitado a adicionar um criativo, conectar sua pesquisa e configurar seu interceptor. Para obter mais informações sobre a configuração guiada, visite Escolher como deseja coletar feedback.
2. Navegue até as Opções de interceptor.
   
   Qdica: As etapas são as mesmas nos interceptores do mobile app, mas você verá menos opções de interceptação.
   
3. Ativar “Link com XM Directory” marcando o campo de seleção.
4. Escolha o diretório que contém seus segmentos.
5. Retorne ao editor de interceptores e adicione a lógica de direcionamento que contém seu segmento do XM Directory.
   Exemplo: por exemplo, Segmento do XM Directory É Usuários de Alto Valor.
   Qdica: Nos interceptores do site, você pode testar o interceptor usando o bookmarklet com contatos que estão no segmento e com contatos que não estão no segmento. Durante o teste, você precisará imitar a configuração do ID de referência externa em seu navegador para que a Qualtrics possa identificar o contato.
6. As próximas etapas são diferentes se você estiver implementando essa funcionalidade em um site ou aplicativo móvel.
   • Site: em seu site onde você iniciará o interceptor, especifique a expressão JavaScript que será avaliada na sessão do usuário conectado para obter o ID de referência externa para o contato. Esta ID de referência externa é usada para pesquisar o visitante no XM Directory e rastrear se ele viu seu interceptor. Consulte a seção acima para mais detalhes sobre a expressão JavaScript.
   • App: no aplicativo onde você iniciará o interceptor, você precisará fazer uma atualização no SDK do seu aplicativo móvel para recuperar o ID de referência. Consulte a documentação API.

Teste da integração do XM Directory com interceptores de site

Antes de iniciar seu interceptor em seu site, você deve testá-lo para garantir que a frequência de contato, segmentação de segmento ou criação de contato tenha sido implementada corretamente.

Em sua implantação real, o ID de referência externa do visitante do site estará disponível no contexto da sessão registrada por meio de uma expressão JavaScript ou de um cookie.

As etapas abaixo permitem que você execute um cenário ponta a ponta usando dados de teste e soluções alternativas do navegador da Web.

Frequência de contato de teste

1. Em seu XM Directory, crie um novo contato e especifique um ID de referência exclusivo para esse contato.
   Exemplo: usaremos aaa123 como nosso ID de referência de exemplo. Sempre que você visualizar o número do ID nessas etapas, substitua-o pelo ID de referência que você indicou.
2. Siga as etapas na seção Configuração de segmentos para direcionamento de interceptação para configurar um interceptor para seguir o targeting de segmentos.
3. Ir para Testar interceptor.
   
4. Arraste o bookmarklet para a barra de marcadores do seu navegador.
5. Vá para uma página da Web que você deseja usar para testes.
6. Vá para o console do desenvolvedor. Dependendo do seu navegador, você irá alcançá-lo de forma diferente:
   • Google Chrome: na barra de menu do Chrome, vá para View → Developer → Developer Tools. Na janela exibida, vá para o console
   • Apple Safari: certifique-se de que o menu Desenvolver esteja ativado para o Safari. Para isso, vá para o menu Preferências → Avançado → Mostrar desenvolvimento na barra de menu. Clique em Desenvolver no menu Safari e selecione Exibir Web Inspector. Na janela exibida, vá para o console
   • Mozilla Firefox: clique no ícone do menu e selecione Desenvolvedor Web. No menu Desenvolvedor Web, selecione o console
   • Microsoft Edge: na barra de menu, vá para Tools → Developer → Developer Tools. Na janela que se abre, vá para o console
   • Internet Explorer: clique no ícone de engrenagem e selecione Ferramentas do desenvolvedor. Na janela que se abre, vá para o console
7. No menu Console, digite esta expressão e pressione Enter:
   UserID="aaa123"
   
   Qdica: aaa123 é o nosso exemplo de valor de ID de referência e deve ser substituído pelo valor que você atribuiu ao contato na etapa 1.
8. Cole o snippet de JavaScript abaixo para configurar a variável de JavaScript de referência externa para ser sua expressão JavaScript.
   

   if(tipo de QSI === "indefinido") {
        QSI = {};
        QSI.config = {
            externalReference: UserID
        };
    }

9. Pressione Enter.
10. Clique no bookmarklet e você verá que o direcionamento do segmento será respeitado adequadamente para determinar se o interceptor deve ou não ser exibido.
    Qdica: para fins de segurança, a linha lógica de direcionamento que inclui o segmento incluirá apenas a ID de segmento. Para associar um ID de segmento a um nome de segmento, navegue até o Diretório XM e edite o segmento. O URL terá o ID de segmento em negrito no seguinte URL de exemplo: https://dxdemo.co1.qualtrics.com/iq-directory/#/POOL_2QRmx18nJXf6kuR/segments/SG_1hHhxvjX3PAZ34k

Para repetir estas etapas para testes adicionais, efetue o seguinte entre os testes:

1. Atualize seu navegador sempre.
2. Configure a expressão JavaScript no seu console.
3. Execute seu bookmarklet novamente.
4. Navegue até o XM Directory e valide se o contato foi criado com os valores de entrada.

TESTE DE CRIAÇÃO DE CONTATO

1. Abra um dos interceptores existentes ou crie um novo interceptor em um projeto de feedback do site/app.
2. Edite as opções Frequência de exibição e Diretório XM.
   
3. Ativar Link com XM Directory.
4. Selecione um diretório a partir da lista drop-down.
5. Clique na caixa de seleção ao lado de Se o contato ainda não existir, crie-o automaticamente no diretório XM.
6. Clique em Salvar.
7. Clique em Visualizar interceptor.
   
8. Arraste o bookmarklet para a barra de marcadores do seu navegador.
9. Vá para uma página da Web que você deseja usar para testes.
10. Vá para o console do desenvolvedor. Dependendo do seu navegador da web, você entrará em contato diferente:
    • Google Chrome: na barra de menu do Chrome, vá para View → Developer → Developer Tools. Na janela exibida, vá para o console
    • Apple Safari: certifique-se de que o menu Desenvolver esteja ativado para o Safari. Para isso, vá para o menu Preferências → Avançado → Mostrar desenvolvimento na barra de menu. Clique em Desenvolver no menu Safari e selecione Exibir Web Inspector. Na janela exibida, vá para o console
    • Mozilla Firefox: clique no ícone do menu e selecione Desenvolvedor Web. No menu Desenvolvedor Web, selecione o console
    • Microsoft Edge: na barra de menu, vá para Tools → Developer → Developer Tools. Na janela que se abre, vá para o console
    • Internet Explorer: clique no ícone de engrenagem e selecione Ferramentas do desenvolvedor. Na janela que se abre, vá para o console
11. No menu Console, digite essa expressão com os valores de contato do XM Directory de exemplo e pressione Enter.

    QSI = {config: {externalReference:"test123", contactEmbeddedData: {"Location":"Seattle"}, language:"English", firstName:"Jane", lastName:"Smith"}}

    

    Qdica: os valores nesta expressão são exemplos de valores de contato que serão adicionados ao perfil do XM Directory do contato de teste. Você pode modificar esses valores para o que desejar.
    Atenção: não suportamos endereços de e-mail como atributos de perfil para preservar interceptores da Web altamente seguros. Você pode adicionar endereços de e-mail manualmente por meio do diretório ou por uploads de arquivo e automações SFTP.
12. Clique no bookmarklet e você verá que o interceptor será exibido.
    Qdica: o interceptor NÃO precisa ser exibido para que a criação do contato funcione. Ele só precisa ser avaliado na página.
    Qdica: outras funcionalidades do XM Directory, como segmentação de segmentos ou regras de frequência de contato, não funcionarão como parte do mesmo carregamento de página que aquele em que o perfil de contato foi criado. No entanto, assim que o contato for criado, quaisquer interceptores subsequentes irão avaliar a frequência de contato e segmentar regras de direcionamento.
13. Navegue até o XM Directory indicado na lista suspensa da etapa 3 e verifique se o contato foi criado com os valores inseridos na etapa 9.

Dicas de Solução de Problemas

Um novo usuário foi adicionado a segmentos, mas não vê um interceptor visado em seu segmento.

Os segmentos são recriados diariamente no XM Directory. Portanto, existe a possibilidade de o novo usuário ainda não ter sido contabilizado como membro do segmento.

A janela do depurador de interceptores não mostra nomes de segmento.

Por motivos de segurança, não exibimos o nome do segmento na janela do depurador para qualquer lógica de direcionamento que tenha segmentos. Mostraremos o ID do segmento. Para mapear um ID de segmento para o nome de segmento, edite seu segmento no XM Directory e veja o URL. O URL terá a ID de segmento, que é destacada no seguinte URL de exemplo: https://dxdemo.co1.qualtrics.com/iq-directory/#/POOL_2QRmx18nJXf6kuR/segments/SG_1hHhxvjX3PAZ34kAlternately

, você pode abrir diretamente um Interceptor e examinar a lógica de segmentação para ver quais segmentos estão sendo direcionados.

O interceptor é lento para ser exibido para os usuários da primeira vez.

Por motivos de desempenho, armazenamos temporariamente a associação do segmento na memória e a atualizamos apenas conforme necessário. Se um usuário ainda não estiver em nosso armazenamento temporário, o interceptor desse usuário pode demorar um pouco mais para ser exibido inicialmente.