Aprovechar al máximo el libro de recetas de visualizaciones de Looker: personalización de descripciones emergentes

La descripción emergente de la visualización muestra de forma predeterminada el valor de las dimensiones y las métricas seleccionadas, y puede ayudar a los usuarios a comprender la importancia de un único punto de datos.

Por ejemplo, una descripción emergente de una visualización de mapa basada en Margen bruto total agrupado por Estado mostrará los valores de ambos campos cuando un usuario coloque el cursor sobre el estado de California.

Un usuario coloca el cursor sobre California para que se muestre una descripción emergente con el valor del estado "California" y el valor del margen bruto total "988.018,58 USD".

Sin embargo, ¿qué ocurre si quieres incluir campos distintos a los predeterminados en la descripción emergente para que los usuarios puedan obtener más información o contexto sobre un punto de datos sin tener que buscar en otro sitio?

Puede personalizar la descripción emergente para que muestre los valores de varios campos especificados, incluidos los que no están en la consulta Explorar.

Ingredientes

Requisitos previos

Para personalizar la descripción emergente, se necesita lo siguiente:

Consideraciones sobre la personalización de descripciones emergentes

Es importante tener en cuenta lo siguiente al personalizar una descripción emergente:

  • Los valores del parámetro html se convierten en el eje Y de una visualización.
  • El valor que quiere mostrar en el eje Y debe ser el valor del parámetro sql de la medida.
  • Cuando uses una medida con formato (una medida de type: percent_of_total o una medida con un parámetro value_format_name o value_format), asegúrate de usar la sintaxis de Liquid para el valor renderizado {{ field_name._rendered_value }} (donde field_name es el nombre real de la medida o la dimensión).

Ejemplo

De forma predeterminada, la descripción emergente de los puntos de datos de la visualización incluirá los valores de Margen bruto total y Estado. Sin embargo, ¿qué ocurre si quieres proporcionar a los usuarios información adicional que no se indica en el mapa ni se incluye en la consulta Explorar? ¿Qué ocurriría si quisiera incluir el valor del campo Porcentaje del margen bruto total en lugar de Estado? Si incluye Porcentaje del margen bruto total, los usuarios podrán ver cómo se compara el valor Margen bruto total de un punto de datos concreto con el margen bruto total del conjunto de datos.

Para personalizar la descripción emergente, sigue estos pasos:

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. En Modo de desarrollo, ve a la definición de LookML del campo que quieras personalizar.

    Puedes ir directamente a la definición de LookML de un campo desde un Explore.

  2. Determina los campos y los valores que quieres incluir en la descripción emergente, además del campo original. Por ejemplo, Porcentaje del margen bruto total.

  3. Añade un parámetro html a la medida original a la que se hace referencia en la consulta de Exploración y que se muestra en la descripción emergente. En este caso, la medida que se muestra en la consulta Exploración y en la descripción emergente es Margen bruto total.

  4. En el parámetro html, crea una expresión con variables de Liquid que añada los campos adicionales al valor de la métrica.

    • En este ejemplo se usa la variable de Liquid _rendered_value para mostrar valores con formato de Looker. Por ejemplo, total_gross_margin usa el formato de Looker para dos decimales y percent_of_total_gross_margin usa el formato de Looker para porcentajes con dos decimales.
    • Puede usar una barra vertical (|) para separar los valores de los distintos campos.
    • También puedes añadir otras palabras que puedan aclarar el significado de los demás valores que se muestran en la descripción emergente. En este caso, se añade of total para aclarar qué significa el valor porcentual.
  5. Guarda, valida y envía el código a producción después de verificar que funciona como es debido.

Ahora, la descripción emergente mostrará dos valores cuando un usuario coloque el cursor sobre un punto de datos: el valor total_gross_margin del punto de datos y el valor percent_of_total_gross_margin correspondiente.

Pasos siguientes

Una vez que hayas creado la visualización con la descripción emergente personalizada, podrás compartirla con otros usuarios: