Looker-Rezeptbuch: Kurzinfos anpassen

Im Visualisierungs-Tooltip werden standardmäßig die Werte der ausgewählten Dimensionen und Messwerte angezeigt. So können Nutzer die Bedeutung eines einzelnen Datenpunkts besser verstehen.

Ein Tooltip für eine Kartenvisualisierung, die auf Gesamtbruttomarge gruppiert nach Bundesland basiert, zeigt beispielsweise Werte für beide Felder an, wenn ein Nutzer den Mauszeiger auf den Bundesstaat Kalifornien bewegt.

Ein Nutzer bewegt den Mauszeiger auf „Kalifornien“, um eine Kurzinfo mit dem Bundesstaat „Kalifornien“ und dem Wert für die Gesamtbruttomarge „988.018,58 $“ aufzurufen.

Was aber, wenn Sie andere als die Standardfelder in den Tooltip aufnehmen möchten, damit Nutzer mehr Informationen oder Kontext zu einem Datenpunkt erhalten, ohne an anderer Stelle suchen zu müssen?

Sie können den Tooltip so anpassen, dass Werte aus mehreren angegebenen Feldern angezeigt werden, einschließlich Feldern, die nicht in der Explore-Abfrage enthalten sind.

Produkte

Vorbereitung

Für die Anpassung des Tooltips sind folgende Voraussetzungen erforderlich:

Überlegungen zur Anpassung von Tooltips

Bei der Anpassung eines Tooltips sollten Sie Folgendes beachten:

  • Die Werte im Parameter html werden zur y-Achse einer Visualisierung.
  • Der Wert, der auf der y-Achse angezeigt werden soll, muss der Wert im Parameter sql des Messwerts sein.
  • Wenn Sie einen formatierten Messwert verwenden (ein Messwert vom Typ type: percent_of_total oder ein Messwert mit einem Parameter value_format_name oder value_format), verwenden Sie die Liquid-Syntax für den gerenderten Wert {{ field_name._rendered_value }}. Dabei ist field_name der tatsächliche Name des Messwerts oder der Dimension.

Beispiel

Standardmäßig enthalten die Tooltips für die Visualisierungsdatenpunkte die Werte für Gesamtbruttomarge und Bundesland. Was aber, wenn Sie Nutzern zusätzliche Informationen zur Verfügung stellen möchten, die nicht auf der Karte angegeben oder in der Explore-Abfrage enthalten sind? Was, wenn Sie anstelle von Bundesland den Wert für ein Feld namens Prozent der Gesamtbruttomarge einfügen möchten? Wenn Sie Prozent der gesamten Handelsspanne einfügen, können Nutzer besser nachvollziehen, wie der Wert für Gesamte Handelsspanne für einen einzelnen Datenpunkt im Vergleich zur gesamten Handelsspanne im gesamten Dataset abschneidet.

So passen Sie den Tooltip an:

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. Rufen Sie im Entwicklungsmodus die LookML-Definition für das Feld auf, das Sie anpassen möchten.

    Sie können direkt von einem Explore zur LookML-Definition eines Felds navigieren von einem Explore.

  2. Bestimmen Sie die Felder und Werte, die Sie zusätzlich zum ursprünglichen Feld in den Tooltip aufnehmen möchten. Beispiel: Prozent der Gesamtbruttomarge.

  3. Fügen Sie dem ursprünglichen Messwert, auf den in der Explore-Abfrage verwiesen wird und der im Tooltip angezeigt wird, einen Parameter html hinzu. In diesem Fall ist der Messwert, der sich derzeit in der Explore-Abfrage befindet und im Tooltip angezeigt wird, Gesamtbruttomarge.

  4. Erstellen Sie im Parameter html einen Ausdruck mit Liquid-Variablen, der die zusätzlichen Felder an den Wert des vorhandenen Messwerts anhängt.

    • In diesem Beispiel wird die Liquid-Variable _rendered_value verwendet, um in Looker formatierte Werte anzuzeigen. Bei total_gross_margin wird beispielsweise die Looker-Formatierung für zwei Dezimalstellen verwendet und bei percent_of_total_gross_margin die Looker-Formatierung für Prozentsätze mit zwei Dezimalstellen.
    • Sie können die Werte für verschiedene Felder mit einem senkrechten Strich (|) trennen.
    • Sie können auch andere Wörter anhängen, die die Bedeutung der anderen Werte im Tooltip verdeutlichen. In diesem Fall wird of total hinzugefügt, um zu verdeutlichen, was der Prozentwert bedeutet.

  5. Speichern, validieren und übertragen Sie den Code in die Produktionsumgebung, nachdem Sie geprüft haben, ob er wie erwartet funktioniert.

Im Tooltip werden jetzt zwei Werte angezeigt, wenn ein Nutzer den Mauszeiger auf einen Datenpunkt mit dem Tooltip bewegt: der total_gross_margin Wert des Datenpunkts und der entsprechende percent_of_total_gross_margin Wert.

Nächste Schritte

Nachdem Sie Ihre Visualisierung mit einem angepassten Tooltip erstellt haben, können Sie sie für andere freigeben: