SNAnalytics - Cliente

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 7 min. de leitura

    • . SNAnalytics A API fornece métodos para enviar dados de análise personalizados (eventos, páginas e propriedades do usuário) para Análise da experiência do usuário para Portal de serviços painel.

    Análise da experiência do usuário para Portal de serviços Fornece exibições de painel para monitorar os principais indicadores de desempenho (KPIs) de aplicações da Web criadas Portal de serviços. Você pode usar essas informações para otimizar seu portal. Por exemplo, Análise da experiência do usuário rastreia quando um usuário solicita um item do catálogo ou exibe um artigo de conhecimento. Você pode usar esses dados para inferir quais itens ou artigos são os mais populares entre os usuários.

    Para acessar esta API, o plug-in Análise do Portal de serviços (com.glide.service-portal.analytics) deve ser ativado na instância. Em sua aplicação, você deve importar o serviço angular snAnalytics, como:

    <client_script><![CDATA[function($rootScope, $scope, $window, $timeout, spUtil, $sce, spModal, $uibModal, $location, cabrillo, snAnalytics)

    Para obter informações adicionais, consulte Análise da experiência do usuário para o Portal de serviços .

    AddEvent (carga do objeto)

    Armazena as informações do evento especificado no armazenamento de dados de análise.

    Eventos são ações realizadas por um usuário, como clicar em um botão ou enviar um formulário. Chame este método em seu widget de página da web sempre que quiser capturar uma ação do usuário. Em seguida, esses eventos aparecem automaticamente na linha do tempo da sessão do usuário associada e no painel Análise da experiência do usuário.

    A seguir está um exemplo de uma carga passada em um AddEvent() chamada:
    var payload= {};
payload.name = "Manage Account";
payload.data = {};
payload.data["Function Name"] = c.data.function_name;
payload.data["User Type"] = c.data.user_type;
payload.data["Company"] = c.data.company_name;
snAnalytics.addEvent(payload);

    A captura de tela abaixo mostra as informações que aparecem no painel de análise do evento "Gerenciar conta". A linha do tempo na parte superior representa o número de vezes que o evento ocorreu. Os gráficos de pizza abaixo da linha do tempo refletem as propriedades que foram capturadas no AddEvent() chamada. Painel com eventos

    Se você quiser capturar quando os usuários acessam uma página da Web, use SNAnalytics - startpage (nome da cadeia de caracteres, descrição da cadeia de caracteres) em vez deste método.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    carga Objeto Evento a ser armazenado no armazenamento de dados de análise.

    Tipo de dados: Objeto

    "payload": {
  "data": [Array],
  "name": String
}
    carga.data Matriz

    Cada elemento pode ser uma cadeia de caracteres (diferencia maiúsculas de minúsculas), booliano, número ou data.

    		 Opcional. Pares nome-valor de propriedades de evento personalizadas. Essas propriedades podem ser quaisquer valores que você deseja rastrear e ver no painel de análise. Eles aparecem na linha do tempo do evento associado no painel de análise. . ID da página a propriedade sempre aparece primeiro no painel para todos os eventos do sistema de base e todas as outras propriedades são classificadas em ordem alfabética.

    Se nenhuma propriedade for necessária para um evento, somente uma linha do tempo do evento aparecerá no painel de análise. As propriedades podem ser adicionadas posteriormente.

    Os seguintes valores são convertidos automaticamente por este método:
    • Valor da cadeia de caracteres de "sim": Valor booliano de "verdadeiro"
    • Valor da cadeia de caracteres "não": Valor booliano "falso

    Valor padrão: Nulo
    payload.name Cadeia de caracteres Nome descritivo do evento. Caracteres especiais não são permitidos.

    Tamanho máximo: O tamanho do nome e do valor do evento não pode exceder 300 bytes.
    Tabela 2. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como chamar AddEvent() método durante a inicialização de um widget.

    function initialize() {
  c.options.glyph = c.options.glyph || 'search';
  c.options.title = c.options.title || c.data.searchMsg;
  c.options.color = c.options.color || "default";
  c.searchTerm = c.data.q;
  c.searchQuery = "";
  c.pageID = $scope.page && $scope.page.id;
  c.showSuggestions =  c.data.searchTypeBehavior === "suggestions" && c.data.isSuggestionsEnabled === "true";
  c.suggestionsLimit = c.options.limit || "";
  c.latitude = null;
  c.longitude = null;
  c.isLocationTrackerDisabled = c.data.isLocationTrackerDisabled === "true";
  c.isTypeAheadEnabled = c.data.isTypeAheadEnabled === "true";

  c.sendAnalytics = function(type){
    var payload= {};
    payload.name = "Initiate Search";
    payload.data = {};
    payload.data["Keyword"] = (type == 'User Entered' ? c.searchTerm : c.searchQuery);
    payload.data["Type"] = type;
    snAnalytics.addEvent(payload);
  };
}

    SNAnalytics - appendToUserProperty(nome da cadeia de caracteres, valor da cadeia de caracteres)

    Anexa a cadeia de caracteres especificada à propriedade de cadeia de caracteres do usuário especificada no armazenamento de dados de análise.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres ou Cadeia de caracteres[] Nome da propriedade à qual anexar a cadeia de caracteres especificada. Caracteres especiais não são permitidos.
    Nota:
    A propriedade associada deve ser uma cadeia de caracteres ou cadeia de caracteres[].

    Tamanho máximo: O tamanho do nome da propriedade e do valor da propriedade não pode exceder 300 bytes.
    valor Cadeia de caracteres Valor a ser anexado à propriedade de cadeia de caracteres.
    Os seguintes valores são convertidos automaticamente por este método:
    • Valor da cadeia de caracteres de "sim": Valor booliano de "verdadeiro"
    • Valor da cadeia de caracteres "não": Valor booliano "falso
    Tabela 4. Retornos
    Tipo Descrição
    Nenhum(a)

    Este exemplo mostra como adicionar televisão para marcadores propriedade.

    snAnalytics.setUserProperties({
  level: 7,
  lastPurchase: new Date(),
  lastPurchaseId: '41563cd2-1666-4855-8c0d-b9ca778aed23',
  isPremium: true,
  tags: ['chair', 'table'],
});

// Append television to the tags property (now 'tags' will have 'chair', 'table', and 'television')
snAnalytics.appendToUserProperty('tags', 'television');

    SNAnalytics - incUserProperty (nome da cadeia de caracteres, valor numérico)

    Incrementa ou diminui o valor da propriedade do usuário especificado com o valor numérico especificado no armazenamento de dados de análise.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome da propriedade a ser incrementada. O valor diferencia maiúsculas de minúsculas.
    Nota:
    A propriedade associada deve ser um número.
    valor Número Valor para incrementar a propriedade. Se você inserir um número negativo, o valor será diminuído.
    Tabela 6. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como incrementar a propriedade Dias de carência até 5.

    snAnalytics.incUserProperty('Grace days', 5)

    SNAnalytics - removeUserProperty (nome da cadeia de caracteres)

    Remove a propriedade especificada para o usuário atual do armazenamento de dados de análise.

    Além disso, a propriedade não aparece mais no painel de análise.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome da propriedade a ser removida. O valor diferencia maiúsculas de minúsculas.
    Tabela 8. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como remover a propriedade IsAdmin.

    snAnalytics.removeUserProperty('IsAdmin');

    SNAnalytics - setUserProperties(propriedades do objeto)

    Define as propriedades especificadas com os valores especificados para o usuário atual no armazenamento de dados de análise.

    Essas propriedades são salvas no armazenamento de dados de análise e aparecem na página de detalhes da sessão do usuário, conforme ilustrado abaixo. Se uma propriedade já existir no armazenamento de dados de análise, o valor atual será substituído pelo novo valor.

    Página da sessão com propriedades

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    propriedades Objeto

    Cada elemento neste objeto pode ser uma cadeia de caracteres, booliano, número, data, cadeia de caracteres[], ou nulo.

    		 Objeto que contém os pares nome-valor das propriedades do usuário a serem definidas, como:
    {
  level: 7,
  lastPurchase: new Date(),
  lastPurchaseId: '41563cd2-1666-4855-8c0d-b9ca778aed23',
  isPremium: true,
  tags: ['chair', 'table'],
}
    Os seguintes valores são convertidos automaticamente por este método:
    • Valor da cadeia de caracteres de "sim": Valor booliano de "verdadeiro"
    • Valor da cadeia de caracteres "não": Valor booliano "falso
    Tabela 10. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir várias propriedades para o usuário atual.

    snAnalytics.setUserProperties({
  level: 7,
  lastPurchase: new Date(),
  lastPurchaseId: '41563cd2-1666-4855-8c0d-b9ca778aed23',
  isPremium: true,
  tags: ['chair', 'table'],
});

    SNAnalytics - setUserProperty(nome da cadeia de caracteres, valor UserProperty)

    Define a propriedade especificada com o valor especificado para o usuário atual no armazenamento de dados de análise.

    Essas propriedades são salvas no armazenamento de dados de análise e aparecem na página de detalhes da sessão do usuário, conforme ilustrado abaixo. Se uma propriedade já existir no armazenamento de dados de análise, o valor atual será substituído pelo novo valor.

    Página da sessão com propriedades

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome da propriedade a ser atualizada. Este nome aparece como o rótulo da propriedade. Por exemplo, na captura de tela anterior, Domínio, Nome da instância, Empresa, Função, e Tipo de usuário são todos parâmetros de nome. Caracteres especiais não são permitidos.

    Tamanho máximo: O tamanho do nome da propriedade e do valor da propriedade não pode exceder 300 bytes.
    valor UserProperty

    Este valor pode ser cadeia de caracteres, booliano, número, data, cadeia de caracteres[], ou nulo.

    		 Valor a ser definido na propriedade especificada.
    Os seguintes valores são convertidos automaticamente por este método:
    • Valor da cadeia de caracteres de "sim": Valor booliano de "verdadeiro"
    • Valor da cadeia de caracteres "não": Valor booliano "falso
    Tabela 12. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir a propriedade Empresa .

    snAnalytics.setUserProperty('Company', "ABC Company")

    SNAnalytics - startpage (nome da cadeia de caracteres, descrição da cadeia de caracteres)

    Salva o nome e a descrição de uma página no armazenamento de dados de análise.

    Essas informações aparecem na linha do tempo da sessão do usuário e no painel de análise. Chame este método em seus widgets personalizados para rastrear as páginas visitadas por um usuário. Você também pode usar este método para rastrear a navegação do usuário em uma página individual. Para obter mais informações, consulte Exploring User Experience Analytics.
    Nota:
    Em geral, as páginas do portal são marcadas automaticamente com este recurso de acompanhamento. Use este método para cenários personalizados, como um widget personalizado de página única em um cenário de assistente.

    Propriedades da página na linha do tempo

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome descritivo da página ou da seção da página. Caracteres especiais não são permitidos.
    descrição Cadeia de caracteres Opcional. Descrição da página a ser exibida na linha do tempo e no painel de análise.

    Padrão: namevalor do parâmetro
    Tabela 14. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como chamar Startpage() método.

    snAnalytics.startPage('login_view', 'Login');