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');