Criação de métricas personalizadas no Insights

Se você estiver criando relatórios do Insights que não incluem elementos pré-criados, pode ser necessário criar uma métrica personalizada. Você pode escrever MAQL (Multidimensional Analítico Query Language) no Advanced Metric Editor do Insights para criar métricas personalizadas.

Essa dica fornece uma visão geral da criação de suas próprias métricas personalizadas. Para obter informações mais detalhadas sobre o uso do Advanced Metric Editor, consulte a documentação do GoodData:Como começar a usar MAQL para escrever métricas. Para obter mais recursos sobre o uso do Insights, consulte Recursos do Insights (Professional e Enterprise).

Esta dica abrange as seções a seguir:

• Navegação para o Advanced Metric Editor
• Criação de métricas personalizadas
• Como evitar erros comuns

Navegação para o Advanced Metric Editor

Esta seção discutirá como abrir o Advanced Metric Editor 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 What, clique no link (avançado) ao lado de Adicionar nova métrica.

   

6. Selecione Métrica personalizada.

Você será redirecionado para o Advanced Metric Editor.

Criação de métricas personalizadas

Esta seção discutirá como inserir fórmulas no Advanced Metric Editor. Depois de clicar em Métrica personalizada, você será redirecionado para o Advanced Metric Editor, conforme mostrado abaixo.

1. Insira um nome para sua métrica na caixa de texto Nomeie sua métrica.
2. Marque a caixa Adicionar a métricas globais para acessar sua métrica em qualquer um dos seus relatórios. Se você desejar que a métrica esteja disponível apenas no relatório atual, deixe desmarcada.

   Se você marcar Adicionar a métricas globais , escolha uma pasta para armazenar a métrica. Você pode editar o formato de sua métrica na caixa Formatar cadeia de caracteres. Você pode definir o número de casas decimais ou adicionar um sufixo de % para formatar a métrica como porcentagem.

3. Insira sua fórmula MAQL no painel Editor diretamente abaixo de Adicionar a métricas globais. Se você não estiver familiarizado com a escrita de MAQL no painel do Editor, consulte Uso do painel do editor abaixo.
4. Clique em Adicionar .

Uso do painel Editor

No painel Editor, você pode escrever sua MAQL para criar sua métrica personalizada. Todas as métricas começam com SELECT.

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

Você não pode digitar diretamente seus fatos, métricas e atributos, mas deve selecionar no menu Elementos.

O menuElementos contém as seguintes pastas:

• Fatos: Números brutos de seus dados

• Métricas: Consultas existentes

• Atributos: Campos de data e texto

• Valores do atributo Uma opção para um atributo. Por exemplo, o atributo Cor pode conter valores de atributos como Vermelho, Verde ou Azul.

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

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

Quando um elemento for adicionado à fórmula de métrica personalizada, ele será codificado automaticamente por cores. Os fatos serão azuis, as métricas serão verdes, os atributos e os rótulos de atributos serãoroxos, os valores dos atributos serão laranjae as variáveis serão castanho claro.

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

Como adicionar um elemento ao seu relatório

1. Clique na pasta que contém o elemento que você gostaria de adicionar.
2. Escolha o elemento ou elementos a serem adicionados.
3. Clique no botão + Adicionar selecionado na parte superior do painel ou clique duas vezes no elemento.

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

Como evitar erros comuns

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

Ao criar métricas personalizadas, um erro comum é copiar e colar fórmulas diretamente de um documento em texto sem formatação. Para que uma métrica personalizada funcione, você deve escolher suas métricas e atributos do painel Elementos . Digitar os nomes dos elementos ou copiar e colar de uma fonte diferente não vai funcionar.

A imagem abaixo exibe uma fórmula copiada e colada. Essa fórmula está incorreta.

A imagem abaixo exibe uma fórmula que usa o menu Elementos para adicionar objetos. Essa fórmula está correta.

Outro erro comum é a falta de parênteses correspondentes. Se você estiver criando uma consulta mais complicada do que uma ação agregada simples, tenha cuidado com os parênteses e certifique-se de que as subconsultas estão aninhadas corretamente. Se sua consulta contiver parênteses ausentes, ela será interpretada incorretamente. Se você estiver criando uma métrica personalizada complicada, pode ser mais fácil dividir suas métricas personalizadas em pedaços.

O último erro comum ao criar suas métricas personalizadas são os erros de sintaxe. Se você receber uma mensagem de erro em vermelho ao clicar no botão Adicionar na parte inferior do editor, talvez seja necessário verificar sua sintaxe quanto a caracteres e espaços extras, parênteses ausentes ou elementos incorretos. Por exemplo, hashtags extras ou vírgulas em locais incorretos são erros comuns. Antes de enviar e salvar sua métrica, verifique cuidadosamente sua sintaxe, procure caracteres extras e espaços, certifique-se de que os parênteses estão corretos e de que os valores adequados foram escolhidos do lado direito.

Para ver alguns exemplos de relatórios de exemplo, consulte Referência de receitas do Insights. Você pode usar essas receitas como exercício para criar e replicar métricas personalizadas. Para obter definições de todos os elementos disponíveis do Insights, consulte Referência de objetos do Insights e Referência de métricas do Insights.