Personalizar Guide Analytics Usando API
Você pode rastrear o comportamento do visitante em Guide usando NiCE CXone Legacy Dashboard e visualizando as métricas de Guide.
Use as seguintes API para definir eventos personalizados, armazenar variáveis do visitante, armazenar dados de conversão, atribuir e remover tags da web, entre outras funções. Os eventos personalizados que você envia com set Visitor Event são salvos com os demais dados de visita de Guide. Se você usar o Data Share, você pode encontrá-los nas exibições de atividade de visita.
Definir Evento do Visitante
Armazena o comportamento do visitante (evento) definido para fins de relatório. Guide adiciona custom. ao início do nome do evento que você enviar. Quando esta chamada é usada com Guide, 'event_type' é alterado para 'custom_event_type'. Substitua 'custom_event_data' por um parâmetro de dados de qualquer tipo, incluindo uma estrutura de objeto.
cxone('analytics','setVisitorEvent', 'event_type', 'custom_event_data');
Manter estas regras em mente ao enviar um evento personalizado:
-
Manter o nome do evento com 23 caracteres ou menos. Com custom. adicionado, o nome completo pode ter até 30 caracteres. Se o nome for mais longo, Guide não salva o evento.
-
Você pode enviar texto, uma lista (matriz) ou um objeto como os dados do evento. Texto e listas são salvos como { value: <seus dados> }. Objetos são salvos como você os envia. Se você não enviar dados, Guide salva o evento sem dados.
Por exemplo, esta chamada registra a página que o visitante visualizou:
cxone('analytics','setVisitorEvent', 'page_view', window.location.pathname);
In Data Share, cada evento personalizado aparece na visualização de atividade da visita com o nome do evento em CUSTOM_EVENT_ATTRIBUTE_NAME e os dados do evento em CUSTOM_EVENT_ATTRIBUTE_VALUE. Para obter detalhes das colunas, consulte a biblioteca Data Share.
Definir Variável do Visitante
Armazena as informações do visitante definidas para fins de relatório.
cxone('analytics','setVisitorVariable', 'variable_identifier', 'variable_value');
Conversão de Store
Armazena o comportamento do visitante como uma conversão para fins de geração de relatórios. Se o parâmetro conversion_date for omitido, a data e a hora atuais serão usadas para a conversão.
cxone('analytics','storeConversion', 'conversion_type', conversion_value, conversion_date);
Defina-as da seguinte forma:
-
Substitua 'conversion_type' por um valor como USD.
-
Substituir conversion_value por um valor numérico para usar em relatórios Guide para rastrear a eficácia dos engajamentos.
-
Substitua conversion_date por um objeto de data JavaScript. Se omitido, new Date() é usado.
Atribuir tag de visitante da web
Adiciona tags especificadas a um visitante. No exemplo de sintaxe a seguir, substitua tagID por uma tag de visitante.
cxone('analytics','addVisitorTags', tagID);
Remover tag de visitante da web
Remove tags específicas de um visitante. No exemplo de sintaxe a seguir, substitua tagID por uma tag de visitante.
cxone('analytics','removeVisitorTags', [tagID, tagID]);
Limpar Dados da Visita
Remove informações sobre a visita atual. A visita é a sessão de navegação. Se o usuário recarregar uma página, Guide considera isso como uma nova visita.
cxone('analytics','clearVisit');
Definir País
Permite definir um valor de país personalizado. A Entrada é uma string. Substitua 'Country' por um código de país do navegador.
cxone('analytics','setDeviceCountry','Country');
Definir Localização
Permite definir um valor de localização personalizado. Entrada é uma string. Substitua 'Location' por um código de localização do navegador.
cxone('analytics','setDeviceLocation','Location');
Desativar a detecção de SPA
Desativa a detecção automática de aplicativo de página única.
cxone('analytics', 'setSPADetection', false);
Página carregada
Permite que Guide reconheça que uma página foi atualizada. Isso é usado quando a detecção de aplicativo de página única está desativada. Entrada é uma string. Substitua 'page-url' pela URL da página ou substitua 'page-title' pelo título da página.
cxone('analytics', 'sendPageView', {url: 'page-url'});cxone('analytics', 'sendPageView', {title: 'page-title'});
Desabilitar monitoramento da web
Desabilita o módulo de monitoramento da web.
cxone('disableModule', 'analytics');