Integração Diretório XM com a Digital Intercepts
O que há nesta página
Sobre a integração Diretório XM com a Digital Intercepts
Atenção: Para usar essa funcionalidade, sua marca Qualtrics precisa ter tanto Diretório XM quanto o Website / App Insights. Se você tiver interesse nesse recurso, entre em contato com o Atendimento ao Cliente.
Diretório XM é um diretório de contatos para toda a organização que registra os diversos pontos de interação de cada cliente com a sua empresa. A integração do Website / App Insights com Diretório XM permite que você aproveite os benefícios do Diretório XM com os visitantes do seu site. Com frequência de contato omnicanal, você pode garantir que os visitantes do seu site não recebam um convite por e-mail caso já tenham recebido uma interceptor na web, e vice-versa. Também é possível destino a exibição de interceptações de sites e aplicativos para segmentos específicos de usuários, bem como obter insights específicos de segmentos e jornadas.
Para poder usar esse característica, você precisa ter acesso ao seguinte:
- Acesso ao Diretório XM.
- Acesso ao Website/App Feedback.
- Contatos ou segmentos em um dos seus diretórios.
Configuração da integração
Diretório XM
A integração com interceptações de sites usará sua configuração existente Diretório XM. Se você ainda não tiver configurado seu diretório, consulte Introdução ao Diretório XM.
Qdica: Para utilizar essa integração, é necessário ter uma regra de resolução de identidade configurada no Diretório XM que unifique contatos duplicados com base em um campo identificador, como e-mail ou uma referência de dados externos do .
Qdica: As análises do site funcionam com diversas regras de resolução de identidade, desde que seja utilizado apenas um campo. Os dispositivos móveis funcionam apenas com a resolução de identidade baseada em referência a dados externos.
Para tirar o máximo proveito da integração, siga estas práticas recomendadas:
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 um fluxo de trabalho que mantenha Diretório XM sincronizado com suas listas de clientes ou trabalhe com sua equipe de desenvolvimento para criar contatos usando as chamadas APICriar um novo contato e Atualizar um contato .
- Mesclar automaticamente contatos duplicar. É possível mesclar apenas os contatos recém-criados ou todos os contatos existentes. Consulte Mesclagem de contatos Duplicar no Diretório XM para obter mais informações.
Atenção: A referência de dados externos/identificação de referência externa diferencia maiúsculas de minúsculas ao integrar Diretório XM com interceptações.
Identificação de visitantes
Atenção: A documentação a seguir requer conhecimento de programação para ser implementada. Recomendamos passar essas informações para a equipe que implementará seu código de implementação. Nossa equipe de suporte não oferece assistência nem consultoria em codificação personalizada. Em vez disso, você pode perguntar para nossa comunidade de usuários dedicados. Se quiser saber mais sobre os serviços de codificação personalizada que podem ser encomendados, entre contato seu executivo Conta Qualtrics.
Para aproveitar os benefícios do Diretório XM a partir do seu projeto do Website / App Insights, primeiro você precisará garantir que Qualtrics saiba quem está acessando seu site ou aplicativo e possa associar essas informações aos seus contatos existentes. Para isso, você precisará especificar a expressão JavaScript que é avaliada na sessão em que o usuário está conectado para obter
Nos exemplos a seguir, vamos nos concentrar em um cenário em que a resolução de identidade se baseia em uma referência a dados externos. Mostraremos como definir um ID de referência externa, que precisa corresponder à referência de dados externos no Diretório XM.
Atenção: A integração entre o Diretório XM e as interceptações digital funciona melhor quando seus contatos são exclusivos, e você deve usar uma regra de resolução de identidade no Diretório XM para evitar contatos duplicar. O valor que você atribui a cada usuário deve ser exclusivo e identificável para todos os contatos do seu site. Para evitar muitos contatos duplicar, não use um valor de espaço reservado para valores desconhecidos e use apenas valores estáticos nos testes.
Exemplo: Armazenar o campo “ID de referência externa” por meio de JavaScript, um cookie ou HTML em seu site permite que você identifique cada visitante com base na referência de dados externos armazenada no Diretório XM.
Avançar, você precisará passar informações sobre seus visitantes para o Qualtrics. As etapas são diferentes se você estiver usando um site em vez de um aplicativo móvel.
Configuração do Website Interceptor
Se estiver usando um site, trabalhe com sua equipe de desenvolvimento da Web para adicionar o trecho de código abaixo ao seu site, além do código de implementação do projeto. Consulte a documentação da API “Connecting with Diretório XM para obter mais ajuda.
O trecho de código abaixo passa o ID de referência externa do usuário para Qualtrics, a fim de associar o visitante do site a um contato no Diretório XM. Coloque esse trecho de código no carregamento da página, certificando-se de que o valor do ID já tenha sido recuperado.
if(typeof QSI === "undefined") {
QSI = {};
QSI.config = {
externalReference: extRef
};
}Atenção: O trecho de código para definir o ID externalReference deve estar acima do código de implementação do projeto JavaScript no código do seu site. Esse snippet deve ser incluído em cada página do seu site em que você destino os visitantes com interceptações.
Atenção: Certifique-se de que, em vez de extRef, você especifique a expressão JavaScript que precisa ser avaliada para obter a ID de referência externa apropriada (por exemplo, "UserID"). Essa expressão pode ser tão simples quanto uma variável JavaScript ou uma expressão JavaScript para avaliar um cookie específico.
Configuração Interceptor de aplicativos móveis
Se você estiver usando um aplicativo móvel, trabalhe com sua equipe de desenvolvimento de aplicativos móveis para integrar-se à versão mais recente do Qualtrics Mobile App SDK. Consulte a documentação API para obter mais informações.
Qdica: se um usuário final fizer login no seu site com um ID de referência externa que não esteja atualmente no Diretório XM (ou seja, o registro desse usuário ainda não está no Diretório XM), o interceptor não aparecerá para esse usuário. Você pode usar o Automatic Contato Creation para adicionar esse usuário ao diretório.
Vinculação da experiência Digital com o Diretório XM
Você pode integrar Diretório XM à sua experiência digital tanto no nível do projeto quanto no nível interceptor. Você deve primeiro vincular Diretório XM ao seu projeto antes de poder vinculá-lo a uma interceptor específica.
Cada projeto individual do Website & App Insight pode estar vinculado a apenas 1 diretório. Isso ajuda a garantir que não haja problemas com as regras 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.
Exemplo: Você realizou recentemente um evento sobre o qual deseja coletar feedback, tanto por e-mail quanto pelo site. Mas seu site também tem outras interceptações que você deseja executar e que não têm nenhuma relação. A integração com Diretório XM e a aplicação de regras frequência de contato garantem que os clientes não sejam solicitados a enviar feedback duas vezes sobre o mesmo evento, sem afetar outras oportunidades de feedback em seu site.
Exemplo: Partindo do exemplo anterior, se visitantes que não constavam anteriormente no seu diretório acessarem seu site, você vai querer coletar as informações deles. Você pode ativar as regras frequência de contato para apenas uma interceptor, mas ativar Diretório XM para todo o projeto, de modo que possa coletar mais informações contato.
Quando a opção “Link com Diretório XM estiver ativada, seja no nível interceptor ou de projeto, dados integrados de contato incorporados dos usuários serão automaticamente adicionados às respostas das pesquisa. Para obter mais informações, consulte Uso de dados incorporados com o Diretório XM.
Além disso, um evento na linha do tempo do ponto de contato do Diretório XM do visitante será criado toda vez que seu interceptor for exibido para ele.
No exemplo acima:
Vinculação de todo um projeto do Website & App Insights
Para vincular um projeto inteiro do Website & App Insights a um diretório:
Certifique-se de que você já tenha criado uma regra de resolução de identidade Diretório XM.
Qdica: Você pode solicitar a um Administrador Marca que faça alterações na resolução de identidade ou que lhe dê as permissões de usuário para editá-las você mesmo. Consulte nossa página sobre mesclagem de contatos duplicar para obter as permissões associadas.
Qdica: As referências a dados externos são compatíveis tanto em interceptores na web quanto em dispositivos móveis. No entanto, todas as outras regras de resolução de identidade são, atualmente, suportadas apenas em interceptoresna web .
Acesse “Gerenciar projeto”.
Ativar link para o Diretório XM.
Selecione seu diretório, se houver vários.
Escolha o campo usado em sua regra de resolução de identidade (ou seja, Referência de dados externos ) .
Clique em Aplicar alterações.
Atenção: A partir de maio de 2024, projetos não poderão ser vinculados a vários diretórios.
Qdica: se você tentar mudar um interceptor e o projeto geral para dois diretórios diferentes, não será possível salvar essa alteração e será solicitado a combiná-los ou desvinculá-los dos diretórios.
Vinculando uma interceptor guiada
- Abra a interceptor guiada.
Vá para Configurações.
Acesse o Diretório XM.
- Selecione “Vincular esta interceptor ao Diretório XM ”.
- Como as regras de resolução de identidade já estão definidas no nível do projeto, não é necessário definir tais regras aqui. Você também não precisa definir o diretório específico, já que isso também é definido no nível do projeto.
- Se desejar, aplique regras frequência de contato.
- Clique em Aplicar alterações.
Vinculação de um interceptor individual
Criação automática de Contato
Atenção: Você precisará trabalhar com a equipe de desenvolvimento do seu site para adicionar código a fim de enviar informações contato para o diretório usando API. Para obter mais informações, consulte a documentação API sobre a criação de um contato diretório ou sobre a criação de um contato em uma lista de destinatários.
Os contatos Diretório XM podem ser criados sempre que os usuários visitarem páginas da Web com código de implementação do projeto Qualtrics Website & App Insights. Essa opção permite adicionar contatos automaticamente quando o código de implantação do projeto “Website & App Insights” é executado na página da web, eliminando a necessidade de uploads manuais de arquivos ou automações baseadas em SFTP.
Atenção: A integração Diretório XM com interceptações digital só pode ser usada para criar novos contatos. Ele não atualiza os contatos existentes. Se sua interceptor exibir uma pesquisa, você pode criar um fluxo de trabalho pesquisa para atualizar as informações de contato com base na resposta enviada pelo visitante do site.
Qdica: Não é necessário que um interceptor seja exibido para que a criação do contato funcione; basta que o código de implantação seja executado na página. Observe que a exibição interceptor sua interceptação pode demorar alguns segundos a mais caso seja necessário criar automaticamente um contato junto com a sessão. Para obter mais informações sobre como o código de implantação é executado no seu site, consulte “Visualizações de página”.
Para ativar a criação automática de contatos, primeiro vincule seu projeto do Website / App Insights ao Diretório XM, conforme descrito anteriormente. Em seguida, ative a opção “Adicionar contatos desconhecidos à agenda”. Lembre-se de aplicar suas alterações.
Para cada novo usuário da web (ou seja, visitante do seu site), você pode coletar os seguintes campos de contato por meio da configuração do seu site:
- Nome
- Sobrenome
- Referência de dados externos
- Telefone
- Idioma
Pares de valores-chave adicionais (por exemplo, "Location": "Seattle", "Gender": "Female"). Cada par chave-valor é limitado a 50 caracteres, e o comprimento total combinado de todos os pares pode ter até 400 caracteres.
Qdica: se o diretório tiver várias regras de resolução de identidade XM, um contato criado por meio desse fluxo deve ser exclusivo em todas as regras de resolução do diretório (ou seja, não deve corresponder a nenhum campo contato existente em nenhuma regra de resolução).
Qdica: Em aplicativos móveis, os contatos só podem ser criados por meio da Referência a Dados Externos.
Configuração de regras de frequência de Contato para interceptações
Atenção: A fim de manter os níveis de serviço adequados para todos os clientes, a Qualtrics pode restringir o tráfego para nossos servidores em casos raros, quando ocorrem picos inesperadamente grandes.
As regras Frequência de contato podem limitar a frequência com que uma interceptor é exibida. É possível usar regras gerais diretório, bem como regras personalizadas para pesquisas específicas.
Para pesquisas que possam ser visualizadas em diversos dispositivos ou navegadores, como interceptores de feedback passivo, não recomendamos o uso frequência de contato.
Atenção: No momento, regras personalizadas frequência de contato aplicáveis às listas não são suportadas.
Atenção: Se houver várias interceptores na mesma página que utilizem regras frequência de contato, exibiremos apenas uma dessas interceptores. A interceptor exibida será a mais antiga.
Certifique-se de que o projeto “Website / App Insights” esteja vinculado ao Diretório XM.
Abrir uma interceptor específica.
Vá para Configurações.
Selecione “Link com Diretório XM ”.
Qdica: Quando essa opção for selecionada, os dados integrados do contato serão automaticamente adicionados à resposta dele ao preencher esta pesquisa. Consulte Uso de dados incorporados com o Diretório XM.
Confirme o diretório selecionado.
Habilite as regras Frequência de contato.
Aplique suas alterações.
Os próximos passos variam dependendo se você está implementando essa funcionalidade em um site ou em um aplicativo móvel:
- Site: No site em que você iniciará a interceptor, especifique a expressão JavaScript que será avaliada na sessão em que o usuário está conectado para obter um identificador do contato, como a Referência de Dados Externos. Isso serve para localizar o visitante no Diretório XM e verificar se ele visualizou sua interceptor. Para saber mais, consulte “Configurando a integração”.
- Aplicativo: No aplicativo em que você iniciará a interceptor, atualize o SDK do seu aplicativo móvel para recuperar o ID de referência. Consulte a documentação API.
Qdica: se você não recuperar um ID de referência, a interceptor se comportará como se as regras frequência de contato não estivessem ativadas. Se você recuperar uma ID de referência que não corresponda a nenhuma ID em seu diretório, a interceptor não será exibida.
Configuração de segmentos para direcionamento de Interceptor
Atenção: A fim de manter os níveis de serviço adequados para todos os clientes, a Qualtrics pode restringir o tráfego para nossos servidores em casos raros, quando ocorrem picos inesperadamente grandes.
Atenção: Os segmentos só podem ser criados e editados por usuários que tenham a permissão Manage Diretório ativada. Qualquer usuário com a permissão Access Contacts pode distribuir para segmentos existentes.
Depois de criar segmentos no Diretório XM, você pode usá-los no Qualtrics em muitos dos mesmos lugares em que as listas de discussão e as amostras podem ser usadas, inclusive com o Website / App Insights. A combinação do Diretório XM e do Website/App Insights permite destino a exibição de interceptações de sites e aplicativos para segmentos específicos de usuários, bem como obter insights específicos de segmentos e jornadas.
Qdica: se o interceptor for exibido para o visitante do seu site, esse ponto de contato também será exibido na linha do tempo do ponto de contato do Diretório XM.
Exemplo: Os contatos que optaram por não participar do Diretório não verão nenhuma interceptores vinculada ao Diretório XM. Isso ocorre automaticamente, e você não precisa configurar segmentação por público-alvo nem regras frequência de contato para excluir os contatos que cancelaram o recebimento de comunicações.
Make sure the Website / App Insights project is linked with XM Directory.
Abra as opções do seu interceptor.
Qdica: as etapas são as mesmas nas interceptações de aplicativos móveis, mas você verá menos opções de interceptor.
Ative a opção “Vincular ao Diretório XM ” marcando a caixa de seleção.
Volte ao editor de interceptor e adicione a lógica de direcionamento que contém o segmento Diretório XM.
Exemplo: Por exemplo, o segmento Diretório XM é de usuários de alto valor.
Qdica: Em interceptações de website, você pode testar a 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ê terá que imitar a configuração do External Reference ID no seu navegador para que o Qualtrics possa identificar o contato.
As avançar etapas variam de acordo com o fato de você estar implementando essa funcionalidade em um site ou em um aplicativo móvel.
- Website: On the website where you'll launch the intercept, specify the JavaScript expression that will be evaluated in the user’s logged in session to obtain an identifier for the contact, such as External Data Reference. This is used to look up the visitor in the XM Directory and track if they’ve seen your intercept. For more, see Setting Up the Integration.
- Aplicativo: No aplicativo em que você iniciará a interceptor, será necessário fazer uma atualização no SDK do aplicativo móvel para recuperar o ID de referência. Consulte a documentação API.
Teste da integração do Diretório XM com interceptações de sites
Antes de lançar o interceptor em seu site, teste-o para garantir que frequência de contato, a segmentação ou a criação de contato tenham sido implementadas corretamente.
Embora seja possível identificar contatos por meio de diversos campos, nos exemplos a seguir, vamos nos concentrar em um cenário em que a resolução de identidade se baseia na Referência de Dados Externos. Em sua implementação real, a 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 a seguir mostram como executar um cenário de ponta a ponta utilizando dados de teste e soluções alternativas no navegador da web.
Teste de frequência de Contato
Exemplo: Usaremos aaa123 como nosso exemplo de ID de referência. Sempre que você vir o número de ID nestas etapas, substitua-o pelo ID de referência que você especificou.
- Google Chrome: na barra de menus do Chrome, vá para Exibir → Desenvolvedor → Ferramentas do desenvolvedor. Na janela que aparece, vá para o Console
- Apple Safari: Certifique-se de que o menu Desenvolver esteja ativado no Safari. Para fazer isso, acesse Preferências → Avançado → Mostrar menu Desenvolver na barra de menus. Clique em Develop no menu Safari e selecione Show Web Inspector. Na janela que aparece, vá para o Console
- Mozilla Firefox: Clique no ícone do menu e selecione Desenvolvedor da Web. No menu Desenvolvedor da Web, selecione Console
- Microsoft Edge: Na barra de menus, vá para Ferramentas → Desenvolvedor → Ferramentas do desenvolvedor. 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
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.
if(typeof QSI === "undefined") {
QSI = {};
QSI.config = {
externalReference: UserID
};
}Qdica: por motivos de segurança, a linha lógica de direcionamento que inclui o segmento incluirá apenas a ID do segmento. Para associar uma ID de segmento a um nome de segmento, navegue até o Diretório XM e edite seu segmento. O URL terá a ID do segmento, que está em negrito no exemplo a seguir URL: https://dxdemo.co1.qualtrics.com/iq-directory/#/POOL_2QRmx18nJXf6kuR/segments/SG_1hHhxvjX3PAZ34k
Para repetir essas etapas para testes adicionais, faça o seguinte entre os testes:
TESTE DE CRIAÇÃO DE CONTATO
- Google Chrome: na barra de menus do Chrome, vá para Exibir → Desenvolvedor → Ferramentas do desenvolvedor. Na janela que aparece, vá para o Console
- Apple Safari: Certifique-se de que o menu Desenvolver esteja ativado no Safari. Para fazer isso, acesse Preferências → Avançado → Mostrar menu Desenvolver na barra de menus. Clique em Develop no menu Safari e selecione Show Web Inspector. Na janela que aparece, vá para o Console
- Mozilla Firefox: Clique no ícone do menu e selecione Desenvolvedor da Web. No menu Desenvolvedor da Web, selecione Console
- Microsoft Edge: Na barra de menus, vá para Ferramentas → Desenvolvedor → Ferramentasdo desenvolvedor . 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
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 contato de teste Diretório XM. Você pode alterar esses valores para o que desejar.
Atenção: Não aceitamos endereços de e-mail como atributos de perfil, a fim de garantir um alto nível de segurança interceptores na web. É possível adicionar endereços de e-mail manualmente por meio do diretório ou por meio de uploads de arquivos e fluxos de trabalho automatizados de importação de contato.
Qdica: NÃO é necessário que a interceptor seja exibida para que a criação do contato funcione. Ele só precisa ser avaliado na página.
Qdica: Outras funcionalidades Diretório XM, como a segmentação por público-alvo ou as regras frequência de contato, não funcionarão na mesma sessão de carregamento da página em que o perfil de contato foi criado. No entanto, depois que o contato for criado, todas as interceptações subsequentes avaliarão frequência de contato e as regras de segmentação.
Qdica: Em interceptações de website, você pode testar a 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ê terá que imitar a configuração do External Reference ID no seu navegador para que o Qualtrics possa identificar o contato.
Análise da experiência digital e Diretório XM
As sessões que você registra para o Análise da experiência digital (DXA) podem ser refletidas nos seus perfis contato Diretório XM. Esses dados enriquecem sua compreensão de quais clientes são mais afetados pela experiência do seu site e podem ajudá-lo a decidir como priorizar as lacunas identificadas na experiência digital.
Qdica: as repetições de sessão salvas no Diretório XM não são compatíveis com o característica exclusão de dados pessoais por e-mail. Em vez disso, consulte nosso guia sobre Repetição de sessão e GDPR.
Configuração do DXA e Diretório XM
A integração entre o DXA e o Diretório XM é exatamente igual a vincular um projeto do Website Insights ao Diretório XM!
Qdica: se você já tiver concluído as etapas abaixo para o seu projeto do Website Insights, não precisará repetir essas etapas.
Qdica: para obter ajuda com a implantação do código de projeto do Website Insights em um site, as equipes de TI podem consultar nossa documentação técnica.
Exibição de dados contato em uma repetição de sessão
Para assistir às gravações das sessões, abra Assistência Digital. Em vez de "Usuário anônimo", você verá o nome do contato como ele aparece no diretório.
Você pode expandir o nome do contato para ver outras informações de identificação do contato, como metadados do dispositivo e e-mail.
Exibição de dados de reprodução de sessão em um contato
As experiências de visita ao site podem aparecer na linha do tempo de um contato para indicar interações com uma interceptor ou gravações de sessão. Se uma sessão foi capturada, a entrada terá um botão chamado View session replay (Exibir reprodução da sessão).
Você também verá um resumo dos sinais de frustração detectados durante a sessão.
Dicas de Solução de Problemas
Um novo usuário foi adicionado aos segmentos, mas não consegue ver uma interceptor direcionada ao seu segmento.
Os segmentos são reconstruídos diariamente no Diretório XM. Portanto, é possível que o novo usuário ainda não tenha sido contabilizado como membro do segmento.
A janela do depurador de interceptor não mostra os nomes dos segmentos.
Por motivos de segurança, não mostramos o nome do segmento na janela do depurador para nenhuma lógica de direcionamento que tenha segmentos. Mostraremos a ID do segmento. Para mapear uma ID de segmento para o nome do segmento, edite seu segmento no Diretório XM e veja o URL. A URL conterá o ID do segmento, que está destacado na URL de exemplo a seguir:https://dxdemo.co1.qualtrics.com/iq-directory/#/POOL_2QRmx18nJXf6kuR/segments/SG_1hHhxvjX3PAZ34k
Como alternativa, você pode abrir diretamente um Interceptor e examinar a lógica de segmentação para verificar quais segmentos estão sendo segmentados.
A janela do depurador interceptor não é exibida para contatos que optaram por não participar.
Ao testar o interceptor, se o `externalReference` apontar para um contato que tenha cancelado o recebimento de mensagens, o interceptor não será exibido na janela do depurador. Ao realizar o teste, certifique-se de que o contato ao qual você está se referindo tenha se inscrito no diretório.
A interceptor demora a aparecer para usuários iniciantes.
Por motivos de desempenho, armazenamos temporariamente a associação do segmento na memória e a atualizamos somente quando necessário. Se um usuário ainda não estiver em nosso armazenamento temporário, o interceptor desse usuário poderá demorar um pouco mais para ser exibido inicialmente.
Isso é ótimo! Obrigado pelo seu feedback!
Obrigado pelo seu feedback!