Guia de práticas recomendadas para aproveitar ao máximo as visualizações do Looker: personalização de dicas

A dica de ferramenta de visualização mostra o valor das dimensões e medidas selecionadas por padrão e pode ajudar os usuários a entender o significado de um único ponto de dados.

Por exemplo, uma dica para uma visualização de mapa baseada em Margem bruta total agrupada por Estado vai mostrar valores para os dois campos quando um usuário passar o cursor sobre o estado da Califórnia.

Um usuário passa o cursor sobre a Califórnia para mostrar uma dica com o valor do estado "Califórnia" e o valor da margem bruta total "US$ 988.018,58".

Mas e se você quiser incluir campos diferentes dos padrões na dica para que os usuários tenham mais informações ou contexto sobre um ponto de dados sem precisar procurar em outro lugar?

É possível personalizar a dica para mostrar valores de vários campos especificados, incluindo campos que não estão na consulta do recurso Detalhar.

Componentes

Pré-requisitos

Para personalizar a dica, é necessário:

Considerações sobre a personalização de dicas

É importante considerar o seguinte ao personalizar uma dica:

  • Os valores no parâmetro html se tornam o eixo y de uma visualização.
  • O valor que você quer mostrar no eixo y precisa ser o valor no parâmetro sql da métrica.
  • Ao usar qualquer métrica formatada (uma métrica de type: percent_of_total ou uma métrica com um parâmetro value_format_name ou value_format), use a sintaxe Liquid para o valor renderizado {{ field_name._rendered_value }} (em que field_name é o nome real da métrica ou dimensão).

Exemplo

Por padrão, a dica dos pontos de dados de visualização inclui os valores de Margem bruta total e Estado. No entanto, e se você quiser fornecer aos usuários mais informações que não estão indicadas no mapa ou incluídas na consulta "Explorar"? E se você quisesse incluir o valor de um campo chamado Porcentagem da margem bruta total em vez de Estado? Incluir a Porcentagem da margem bruta total ajuda os usuários a entender como o valor da Margem bruta total de um ponto de dados individual se compara à margem bruta total em todo o conjunto de dados.

Para personalizar a dica, siga estas etapas:

measure: total_gross_margin {
  type: sum
  value_format_name: decimal_2
  sql: ${gross_margin} ;;
  html: {{ rendered_value }} | {{percent_of_gross_margin._rendered_value }} of total ;;
}

  1. No modo de desenvolvimento, navegue até a definição do LookML para o campo que você quer personalizar.

    É possível navegar diretamente para a definição do LookML de um campo em uma análise.

  2. Determine os campos e valores que você quer incluir na dica de ferramenta, além do campo original. Por exemplo, Porcentagem da margem bruta total.

  3. Adicione um parâmetro html à métrica original referenciada na consulta da Análise e mostrada na dica. Nesse caso, a métrica que está na consulta de análise e é mostrada na dica é Margem bruta total.

  4. No parâmetro html, crie uma expressão com variáveis Liquid que adicione os campos extras ao valor da métrica atual.

    • Este exemplo usa a variável Liquid _rendered_value para mostrar valores formatados do Looker. Por exemplo, total_gross_margin usa a formatação do Looker para duas casas decimais, e percent_of_total_gross_margin usa a formatação do Looker para porcentagem com duas casas decimais.
    • Você pode usar uma barra vertical,|, para separar os valores de diferentes campos.
    • Você também pode adicionar outras palavras que esclareçam o significado dos outros valores renderizados na dica. Nesse caso, of total é adicionado para esclarecer o que o valor percentual significa.

  5. Salve, valide e envie o código para produção depois de verificar se ele funciona como esperado.

Agora, a dica vai mostrar dois valores quando um usuário passar o cursor sobre um ponto de dados: o valor total_gross_margin do ponto de dados e o valor percent_of_total_gross_margin correspondente.

Próximas etapas

Depois de criar sua visualização com uma dica personalizada, você pode compartilhá-la com outras pessoas: