Criando métricas personalizadas no Insights

Se você está criando relatórios de Insights que não incluem elementos pré-fabricados, talvez você tenha de construir uma métrica personalizada. Você pode escrever MAQL (Multi-Dimension Analytical Query Language) no Editor de Métricas Avançado do Insights para criar métricas personalizadas.

Este guia fornece uma visão geral de como desenvolver sua própria métrica personalizada. Para maiores informações sobre o uso do Editor de Métricas Avançado, consulte Documentação de GoodData Como começar a Usar MAQL para Escrever Métricas. Para recursos adicionais usando o Insights, ver recursos do Insights (Professional e Enterprise).

Esta dica abrange as seções a seguir:

• Navegando para Editor de Métricas Avançado
• Escrevendo métricas personalizadas
• Evitando erros comuns

Navegando para Editor de Métricas Avançado

Esta seção irá discutir como abrir o Editor de Métricas Avançado no GoodData.

1. Clique no ícone Relatórios () na interface do agente e, em seguida, clique na aba Insights.
2. Clique no link GoodData no canto superior direito.
3. Clique em Relatórios.
4. Clique em Criar Relatório.
5. No menu O quê, clique no link (avançado), ao lado de Adicionar nova métrica.

   

6. Selecione Personalizar métrica.

Você será redirecionado para o Editor de Métrica Avançado.

Escrevendo métricas personalizadas

Esta seção irá discutir como inserir fórmulas no Editor de Métrica Avançado. Depois de clicar em Personalizar métrica, você será redirecionado para o Editor de Métrica Avançado conforme mostrado abaixo.

1. Insira um nome para sua métrica na caixa Nome da métrica.
2. Verifique a caixa Adicionar a Metricas Globais para acessar sua métrica em qualquer um de seus relatórios. Se você quiser que a métrica fique disponível apenas no presente relatório, deixe-a desmarcada.

   Se você marcar Adicionar a Métricas Globais, escolha uma pasta para armazenar a métrica. Você pode então editar o formato da sua métrica na caixa Formatar cadeia. É possível definir o número de casas decimais ou adicionar um sufixo % para formatar a métrica como porcentagem.

3. Insira sua fórmula MAQL na área do Editor diretamente abaixo de Adicionar a Métricas Globais. Se você não estiver familiarizado com a escrita MAQL na área do Editor, consulte Usando a área do Editor abaixo.
4. Clique em Adicionar.

Usando a Área do Editor

Na Área do Editor, você pode escrever seu MAQL para construir sua métrica personalizada. Todas as métricas começam com SELECT.

Abaixo da área do Editor, há uma lista de funções que você pode aplicar a fatos, métricas e atributos em sua métrica. Cada função contém uma definição, e é possível clicar em uma função para adicioná-la ao seu relatório.

Não é possível escrever diretamente seus fatos, métricas e atributos. Selecione-os no menu Elementos.

O menu Elementos contém as seguintes pastas:

• Fatos: números brutos de seus dados

• Métricas: consultas existentes

• Atributos : campos de data e texto

• Valores de Atributo: uma escolha para um atributo. Por exemplo, o atributo Cor poderia conter valores de atributos como Vermelho, Verde e Azul.

• Rótulos de Atributo: o nome do campo do atributo. No exemplo acima, o rótulo seria"Cor".

• Variáveis: permitem que as métricas sejam dinâmicas, com base no usuário que está visualizando a métrica.

Quando um elemento é adicionado à fórmula métrica personalizada, será automaticamente codificado por cores. Fatos serão marcados em azul; métricas, em verde; atributos e etiquetas de atributo, em roxo; valores de atributos, em laranja; e variáveis, em marrom claro.

Para uma lista completa de Insights de métricas e objetos Zendesk, consulte métricas de referência do Insights e referência de objetos do Insights

Para adicionar um elemento ao seu relatório

1. Clique na pasta que contém o elemento que deseja adicionar.
2. Escolha o elemento ou elementos para adicionar.
3. Clique no botão + Adicionar Selecionados no topo do painel ou dê duplo clique no elemento.

Observação: Se clicar no botão verde Adicionar na parte inferior do relatório, você receberá uma mensagem de erro. O botão Adicionar adiciona a métrica completa, mas não adiciona um elemento.

Evitando erros comuns

Abaixo estão alguns erros comuns que os usuários cometem ao criar métricas personalizadas e como evitá-las.

Ao criar métricas personalizadas, um erro comum é copiar e colar fórmulas diretamente de um documento de texto simples . Para que uma métrica personalizada funcione, escolha suas métricas e atributos no painel Elementos. Digitar os nomes dos elementos ou copiar e colar a partir de uma fonte diferente não vai funcionar.

A imagem abaixo mostra uma fórmula copiada e colada. Esta fórmula está incorreta.

A imagem abaixo mostra uma fórmula que usa o menu Elementos para adicionar os objetos. Esta fórmula está correta.

Outro erro comum são parênteses ausentes. Se você está criando uma consulta que é mais complicada do que uma única ação agregada, fique atento aos seus parênteses e garanta que sub-consultas sejam devidamente aninhadas. Se algum parêntese estiver faltando em sua consulta, ela será interpretada de maneira incorreta. Se você estiver criando uma métrica personalizada complexa, pode ser mais fácil dividi-la em partes.

O último erro comum na criação de sua métrica personalizada são erros de sintaxe. Se você receber uma mensagem de erro vermelha quando clicar no botão Adicionar na parte inferior do editor, talvez seja necessário verificar sua sintaxe e buscar caracteres e espaços extras, parênteses que estiverem faltando ou elementos incorretos. Por exemplo, hashtags extras ou vírgulas em locais incorretos são erros comuns. Antes de salvar e enviar sua métrica, verifique com atenção a sintaxe, procure caracteres e espaços extras, confirme se os parênteses estão corretos e se escolheu os valores adequados no lado direito.

Para alguns exemplos de amostra de relatórios, consulte a referência de receitas de Insights. Você pode usar essas receitas como prática para desenvolver e reproduzir métricas personalizadas. Para as definições de todos os elementos disponíveis de Insights, consulte as Referências de objetos do Insights e as Referências de métricas do Insights.