You are viewing the Portuguese (Brazil) site, but your language preference is set to English. Switch to English site →

Menu

Usar métricas personalizadas no Insights

Se você estiver criando relatórios do Insights que não incluem métricas integradas, talvez seja necessário criar uma métrica personalizada. Você pode gravar a consulta MAQL (Multi-Dimension Analytical Query Language, linguagem de consulta analítica multidimensional) no Analytics Portal (Portal de análise) usando o Advanced Metric Editor (Editor de métricas avançadas) para criar métricas personalizadas.

Esta página fornece uma visão geral da criação das métricas personalizadas. Abordaremos:

Navegar até o Advanced Metric Editor (Editor de métricas avançadas)

Você pode abrir o Advanced Metric Editor (Editor de métricas avançadas) no Analytics Portal (Portal de análise).

  1. Abra o Analytics Portal (Portal de análise) quando estiver conectado ao Flex.
  2. Clique em Reports (Relatórios).
  3. Clique em Create Report (Criar relatório).
  4. No menu What (O que), clique no link (advanced) (avançado) ao lado de Add new metric (Adicionar nova métrica).

    What pane

  5. Selecione Custom metric (Métrica personalizada).
    Custom Metric

Agora você será redirecionado para o Advanced Metric Editor (Editor de métricas avançadas), onde poderá escrever suas métricas personalizadas.

Gravar métricas personalizadas

Após clicar em Custom metric (Métrica personalizada), você será redirecionado para o Advanced Metric Editor (Editor de métricas avançadas), conforme mostrado abaixo.

custommetric_3.png

  1. Insira um nome para sua métrica na caixa de texto Name your metric (Nomear a métrica).
  2. Marque a caixa Add to Global Metrics (Adicionar a métricas globais) para acessar sua métrica em qualquer um de seus relatórios. Se desejar que a métrica esteja disponível apenas no relatório atual, deixe essa caixa desmarcada.

    Se você marcar Add to Global Metrics (Adicionar a métricas globais), escolha uma pasta onde armazenar a métrica. Em seguida, você pode editar o formato da sua métrica na caixa Format string (Formatar string). Você pode definir como deseja que os números sejam formatados ao salvar uma métrica global – veja mais sobre formatação de métrica aqui.

  3. Insira sua consulta MAQL no Editor pane (Painel Editor). Se você não estiver familiarizado com a gravação de MAQL no Editor pane (Painel Editor), consulte a seção abaixo sobre como usar o Editor pane (Painel Editor).
  4. Clique em Add (Adicionar).

Usar o Editor pane (Painel Editor)

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

Abaixo do Editor pane (Painel Editor), há uma lista de funções que você pode aplicar aos fatos, às métricas e aos atributos em 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:

functions

Você não pode digitar diretamente seus fatos, métricas e atributos nesse painel do editor, e sim selecionar no menu Elements (Elementos).

Elements

O menu Elements (Elementos) contém as seguintes pastas:

  • Facts (Fatos): números brutos dos seus dados
  • Metrics (Métricas): consultas existentes sobre fatos
  • Attributes (Atributos): campos de data e texto
  • Attribute Values (Valores de atributos): uma opção para um atributo. Por exemplo, o atributo Tipo pode conter valores de atributo como Queue (Fila), Conversation (Conversa), Agent Status (Status do agente) etc.
  • Attribute Labels (Rótulos de atributos): o nome do campo de atributo. Atributos como Handling Team (Equipe de atendimento) contêm várias etiquetas: Handling Team Id (ID da equipe de atendimento), Handling Team Name (Nome da equipe de atendimento) e Handling Team Hierarchy Name (Nome da hierarquia da equipe de atendimento).
  • Variables (Variáveis): elas permitem que as métricas sejam dinâmicas, com base no limite de dados ou no usuário que está visualizando a métrica.

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 a serem adicionados.
  3. Clique no botão + Add Selected (Adicionar selecionados) na parte superior do painel ou faça clique duplo no elemento.

Depois que um elemento for adicionado à fórmula da métrica personalizada, ele será automaticamente codificado por cores da seguinte maneira:

  • Facts (Fatos): azul
  • Metrics (Métricas): verde
  • Attributes and attribute labels (Atributos e rótulos de atributos): roxo
  • Attribute values (Valores de atributo): laranja
  • Variables (Variáveis): marrom claro

Consulte nosso documento no Modelo de dados do Analytics para obter uma lista completa dos pontos de dados do Flex Insights.

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

Práticas recomendadas da MAQL

1. Não copie/cole fórmulas diretamente de um documento de texto sem formatação.

Para que uma métrica personalizada funcione, você deve escolher suas métricas e atributos no painel Elements (Elementos). Digitar nomes de elementos ou copiar e colar de uma fonte diferente não resultará em êxito.

Esta fórmula está incorreta (uma fórmula copiada e colada):

Wrong MAQL

A fórmula abaixo usa o menu Elements (Elementos) para adicionar objetos. Esta fórmula está correta:

MAQL correct

2. Certifique-se de combinar os parênteses.

Se você estiver criando uma consulta mais complicada do que uma única ação agregada, deverá prestar atenção ao uso de parênteses e certificar‐se de que as subconsultas estejam adequadamente aninhadas:

Parentheses

Se sua consulta contiver parênteses ausentes, você não poderá salvar a métrica:

Missing

Se você estiver criando uma métrica personalizada complexa, pode ser mais fácil dividir suas métricas personalizadas em partes.

3. Certifique‐se de selecionar o valor do atributo no atributo correto.

O erro mais comum em métricas personalizadas são erros de sintaxe. Pode acontecer de, em vez de selecionar o valor "Yes" (Sim) do atributo "Abandoned" (Abandonadas), você selecione o valor "Yes" (Sim) de outro atributo; por exemplo, "Productive" (Produtivas).

Embora visualmente a fórmula pareça idêntica em ambos os cenários, você pode receber uma mensagem de erro vermelha ao clicar no botão Add (Adicionar) na parte inferior do editor indicando que você escolheu o valor de um atributo errado:

Incorrect attribute value

Classifique esta página:

Precisa de ajuda?

Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.

Obrigado pelo seu feedback!

Selecione o(s) motivo(s) para seu feedback. As informações adicionais que você fornece nos ajudam a melhorar nossa documentação:

Enviando seu feedback...
🎉 Obrigado pelo seu feedback!
Algo deu errado. Tente novamente.

Obrigado pelo seu feedback!

thanks-feedback-gif