Looker-Visualisierungs-Cookbook optimal nutzen: Kurzinfo-Anpassung

In der Kurzinfo zur Visualisierung wird standardmäßig der Wert der ausgewählten Dimensionen und Messwerte angezeigt. So können Nutzer die Bedeutung eines einzelnen Datenpunkts besser nachvollziehen.

Beispiel: In einer Kurzinfo für eine Kartenvisualisierung, die auf der Bruttomarge gruppiert nach Bundesstaat basiert, werden Werte für beide Felder angezeigt, wenn ein Nutzer den Mauszeiger auf den Bundesstaat Kalifornien bewegt.

Ein Nutzer bewegt den Mauszeiger auf „Kalifornien“, um eine Kurzinfo mit dem Wert „Kalifornien“ für den Bundesstaat aufzurufen. und der Gesamtwert der Bruttomarge beträgt '$988,018.58'.

Was ist jedoch, wenn Sie in der Kurzinfo andere Felder als die Standardfelder einschließen möchten, damit Nutzer mehr Informationen oder Kontext zu einem Datenpunkt erhalten, ohne an anderer Stelle suchen zu müssen?

Sie können die Kurzinfo so anpassen, dass Werte aus mehreren angegebenen Feldern angezeigt werden. Dazu gehören auch Felder, die nicht in der Explore-Abfrage enthalten sind.

Produkte

Liquid-Variablen: Liquid-Variablen rendern die Werte anderer Felder in Verbindung mit der vorhandenen Explore-Abfrage.
html-Parameter: Die im html-Parameter eines Messwerts definierten Felder werden in der Kurzinfo angezeigt, wenn ein Nutzer den Mauszeiger auf eine Visualisierung bewegt.
Visualisierung: Die Kurzinfo wird angezeigt, wenn ein Nutzer den Mauszeiger auf einen Datenpunkt in bestimmten Visualisierungstypen bewegt.

Vorbereitung

Zum Anpassen der Kurzinfo ist Folgendes erforderlich:

Berechtigungen zum Erstellen von Explores und zum Entwickeln von LookML
Kenntnisse in SQL- und LookML-Entwicklung.
Grundkenntnisse der Verwendung von Liquid in Looker und der HTML-Codierung Weitere Informationen finden Sie auf der Seite html im Abschnitt Liquid-Variablen im Parameter html verwenden.
Berechtigungen zum Speichern von Inhalten (wenn Sie die Visualisierung als Look oder Dashboard speichern möchten)

Beachten Sie beim Anpassen einer Kurzinfo Folgendes:

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

Beispiel

Standardmäßig enthält die Kurzinfo für die Visualisierungsdatenpunkte die Werte für Bruttomarge insgesamt und Bundesstaat. Was aber, wenn Sie Nutzern zusätzliche Informationen zur Verfügung stellen möchten, die nicht auf der Karte angegeben oder in der explorativen Datenanalyse enthalten sind? Angenommen, Sie möchten den Wert für ein Feld namens Prozentualer Bruttogewinn anstelle von Bundesland einschließen? Wenn Sie den Prozentsatz der Bruttomarge einbeziehen, können Nutzer besser nachvollziehen, wie sich der Wert der Bruttomarge für einen einzelnen Datenpunkt mit der Gesamtbruttomarge des Datensatzes vergleichen lässt.

So passen Sie die Kurzinfo 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 ;;
}

Gehen Sie im Entwicklungsmodus zur LookML-Definition für das Feld, das Sie anpassen möchten.

Sie können aus einem Explore direkt zur LookML-Definition eines Felds navigieren.
Legen Sie die Felder und Werte fest, die zusätzlich zum ursprünglichen Feld in der Kurzinfo enthalten sein sollen. Beispiel: Prozentsatz der Bruttomarge insgesamt.
Fügen Sie dem ursprünglichen Messwert, auf den in der Explore-Abfrage verwiesen wird und der in der Kurzinfo angezeigt wird, einen html-Parameter hinzu. In diesem Fall ist der Messwert, der sich derzeit in der Abfrage „Erkunden“ befindet und in der Kurzinfo angezeigt wird, Bruttogewinnmarge insgesamt.
Erstellen Sie im Parameter html einen Ausdruck mit Liquid-Variablen, der die zusätzlichen Felder an den vorhandenen Messwertwert anhängt.
- In diesem Beispiel wird die Liquid-Variable _rendered_value verwendet, um von Looker formatierte Werte anzuzeigen. In total_gross_margin wird beispielsweise die Looker-Formatierung für zwei Dezimalstellen verwendet und in percent_of_total_gross_margin die Looker-Formatierung für Prozentsätze mit zwei Dezimalstellen.
- Sie können einen senkrechten Strich | verwenden, um die Werte für verschiedene Felder zu trennen.
- Sie können auch andere Wörter anhängen, um die Bedeutung der anderen Werte zu verdeutlichen, die in der Kurzinfo gerendert werden. In diesem Fall wird of total hinzugefügt, um die Bedeutung des Prozentsatzes zu verdeutlichen.
Speichern, validieren und übertragen Sie den Code in die Produktionsumgebung, nachdem Sie überprüft haben, ob er wie erwartet funktioniert.

Wenn ein Nutzer den Mauszeiger auf einen Datenpunkt mit der Kurzinfo bewegt, werden jetzt zwei Werte angezeigt: der total_gross_margin-Wert des Datenpunkts und der entsprechende percent_of_total_gross_margin-Wert.

Nächste Schritte

Nachdem Sie Ihre Visualisierung mit einer benutzerdefinierten Kurzinfo erstellt haben, können Sie sie mit anderen teilen: