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 estiver interessado nesse característica, contato Conta Services.
Diretório XM 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 em toda a organização permite visualizar os perfis dos vários pontos de contato dos contatos com a sua organização, tornando mais fácil do que nunca discover insights sobre a experiência deles com a sua marca.
A integração do Website / App Insights com o Diretório XM permite que você utilize os benefícios do Diretório XM com os visitantes do seu site. Você pode configurar frequência de contato omnicanal, garantindo que os visitantes do seu site não recebam um convite por e-mail se já tiverem 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:
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 usar essa integração, você deve ter uma regra de resolução de identidade configurada no Diretório XM que desduplique os contatos com base na Referência de 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. Qdica: a mesclagem de contatos com base no campo External Data Reference garante que cada contato tenha um valor exclusivo. Esse campo diferencia maiúsculas de minúsculas.
Qdica: cada um desses contatos precisará do campo ID de referência (ExternalDataReference) especificado. Esse valor deverá estar disponível na sessão de login para os visitantes do seu site e é usado para determinar se a interceptor será exibida. Esse campo deve corresponder ao campo Referência de dados externos usado em sua regra de resolução de identidade no Diretório XM.
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.
Interceptores
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 acessar os benefícios do Diretório XM partir do seu projeto Website / App Insights, primeiro você precisa ter certeza de que o Qualtrics sabe quem está visitando seu site e pode combinar essas informações com seus contatos existentes. Para fazer isso, você precisará especificar a expressão JavaScript que é avaliada na sessão conectada do usuário para obter o ID de referência externa do contato. Essa ID de referência externa precisa corresponder à ID de referência externa configurada 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: O armazenamento do campo ID de referência externa por meio de JavaScript, cookie ou HTML em seu site permite que você combine cada visitante com base nos IDs de referência externa armazenados 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.
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. O snippet passa o ID externalReference do usuário para o Qualtrics para 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.
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 vincular Diretório XM à sua experiência digital em um nível projeto e 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 só pode ser vinculado a um 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. O vínculo com o Diretório XM e a aplicação de regras frequência de contato permitem garantir que os clientes não sejam solicitados a dar feedback duas vezes para o mesmo evento, sem afetar outras oportunidades de feedback no seu site.
Exemplo: Com base no exemplo anterior, se os visitantes que chegam ao seu site não estiverem anteriormente no seu diretório, você deseja 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 o Link with Diretório XM estiver ativado no nível interceptor ou de projeto, dados integrados de contato dos usuários serão automaticamente adicionados à resposta 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.
Vinculação de um interceptor individual
Qdica: para interceptações guiadas, vá para Display Frequency (Exibir frequência) e Diretório XM ) em vez de Options (Opções).
Vinculação de todo um projeto do Website & App Insights
Para vincular um projeto inteiro do Website & App Insights a um diretório:
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: referências a dados externos são compatíveis com interceptações na Web e em dispositivos móveis. No entanto, todas as outras regras de resolução de identidade são atualmente compatíveis apenas com interceptações na Web.
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.
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 código de implementaçã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 o seu interceptor exibir uma pesquisa, você poderá criar um fluxo de trabalho para atualizar as informações contato com base na resposta da pesquisa enviada pelo visitante do site.
Qdica: não é necessário exibir uma interceptor para que a criação de contato funcione; código de implementação só precisa ser executado na página. Para obter mais informações, consulte Visualizações de página.
Para ativar a criação automática de contato, primeiro vincule o Website & App Insights e o Diretório XM, conforme descrito anteriormente. Em seguida, ative a configuração Se o contato não existir em seu diretório, adicione-o automaticamente. Lembre-se de aplicar suas alterações.
Para cada novo usuário da Web (ou seja, visitante do seu site), é possível adicionar os seguintes campos contato:
- Nome
- Sobrenome
- ExtRef
- 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: Para usuários móveis, não é possível adicionar informações adicionais. O contato será criado apenas com o ExtRef.
Configuração de regras de frequência de Contato para interceptações
Qdica: para ver uma demonstração em vídeo do uso desse característica e vê-lo em ação, confira esta postagem na Comunidade Qualtrics!
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 de frequência de Contato podem ser configuradas para limitar a frequência com que uma interceptor é mostrada. É possível usar regras gerais diretório, bem como regras personalizadas para pesquisas específicas. Para pesquisas que podem ser vistas em vários dispositivos ou navegadores, como interceptações de feedback passivo, recomendamos não usar frequência de contato.
Atenção: No momento, não há suporte para regras personalizadas que aplicar a listas.
Atenção: Se várias interceptações na mesma página usarem regras diretório XM com base em listas (mesmo diretório ou diretórios diferentes), mostraremos apenas uma dessas interceptações. A interceptor exibida será a mais antiga.
Qdica: quando essa opção for selecionada, dados integrados contato dos usuários que responderem a esse pesquisa serão automaticamente adicionados à resposta pesquisa. Consulte Uso de dados incorporados com o Diretório XM.
- Site: No site em que você iniciará a interceptor, especifique a expressão JavaScript que será avaliada na sessão de login do usuário para obter o ID de referência externa do contato. Essa ID de referência externa é usada para procurar o visitante no Diretório XM e rastrear se ele viu sua interceptor.
- 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.
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: Embora os contatos que optaram por sair do Diretório não vejam nenhum e-mail adicional, eles ainda podem ver interceptações. Para garantir que os usuários excluídos não sejam exibidos em nenhuma interceptação, use o status de cancelar adesão ao configurar os critérios do segmento e, em seguida, use a lógica de segmentação do segmento.
Qdica: se, em vez de criar uma interceptor autônoma, você quiser assistência durante todo o processo, fique à vontade para usar nossa configuração guiada para projetos Website/App Feedback. Se você usar a configuração guiada, será solicitado a adicionar um criativo, conectar o pesquisa e configurar a interceptor. Para obter mais informações sobre a configuração guiada, visite Choose How You Want to Collect Feedback.
Qdica: as etapas são as mesmas nas interceptações de aplicativos móveis, mas você verá menos opções de interceptor.
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.
- Site: No site em que você iniciará a interceptor, especifique a expressão JavaScript que será avaliada na sessão conectada do usuário para obter o ID de referência externa do contato. Essa ID de referência externa é usada para procurar o visitante no Diretório XM e rastrear se ele viu sua interceptor. Consulte a seção acima para obter mais detalhes sobre a expressão JavaScript.
- 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.
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 abaixo permitem que você execute um cenário de ponta a ponta usando dados de teste e soluções alternativas do 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 nessa expressão são exemplos de valores contato que serão adicionados ao perfil do Diretório XM do contato de teste. Você pode alterar esses valores para o que desejar.
Atenção: Não oferecemos suporte a endereços de e-mail como atributos de perfil para preservar interceptações da Web altamente seguras. É 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: 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 Diretório XM, como segmentação de segmentos ou regras frequência de contato, não funcionarão como parte do mesmo carregamento de página em que o perfil 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 ver os replays das sessões, abra o Digital Assist. 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 à Web 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 vê um interceptor que foi direcionado 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. O URL terá o ID do segmento, que está destacado no seguinte exemplo de URL: https://dxdemo.co1.qualtrics.com/iq-directory/#/POOL_2QRmx18nJXf6kuR/segments/SG_1hHhxvjX3PAZ34kAlternatively,
você pode abrir diretamente um Interceptor e examinar a lógica de direcionamento para ver quais segmentos estão sendo direcionados.
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!