充分運用 Looker 視覺化工具食譜：自訂工具提示

視覺化工具提示預設會顯示所選維度和指標的值，有助使用者瞭解單一資料點的重要性。

舉例來說，如果地圖圖像可視化工具的資訊方塊是以「總毛利」為依據，並按州別分組，當使用者將滑鼠游標懸停在加州時，系統就會顯示這兩個欄位的值。

使用者將滑鼠游標懸停在加州時，工具提示會顯示「State」值「California」和「Total Gross Margin」值「$988,018.58」。

不過，如果您想在工具提示中加入其他欄位 (而非預設欄位)，讓使用者不必尋找其他位置，就能取得資料點的更多資訊或背景資訊，該怎麼做呢？

您可以自訂工具提示，顯示多個指定欄位的值，包括未包含在探索查詢中的欄位。

食材

  • Liquid 變數：Liquid 變數會與現有的探索查詢搭配，算出其他欄位的值。
  • html 參數：在使用者將滑鼠游標懸停在圖表上時，在度量項目的 html 參數中定義的欄位會顯示在工具提示中。
  • 圖表：當使用者將游標懸停在特定圖表類型的資料點上時，系統就會顯示工具提示。

事前準備

如要自訂工具提示，請完成下列步驟：

自訂工具提示的注意事項

自訂工具提示時，請務必考量下列事項：

  • html 參數中的值會成為視覺化內容的 y 軸。
  • 您要在 y 軸上顯示的值，應為度量項目 sql 參數中的值。
  • 使用任何格式化的評估資料 (type: percent_of_total 的評估資料，或含有 value_format_name 或 value_format 參數的評估資料) 時，請務必使用 Liquid 語法來顯示值 {{ field_name._rendered_value }} (其中 field_name 是評估資料或維度的實際名稱)。

範例

根據預設，視覺化資料點的工具提示會包含「總毛利率」和「狀態」的值。不過，如果您想為使用者提供地圖上未標示或探索查詢未納入的其他資訊，該怎麼辦？如果您想納入「總毛利百分比」欄位值，而非「狀態」，該怎麼做？加入「總毛利率百分比」有助於使用者瞭解個別資料點的「總毛利率」值與資料集的總毛利率有何差異。

如要自訂工具提示，請按照下列步驟操作：

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. 在開發人員模式中，前往要自訂的欄位 LookML 定義。

    您可以直接前往探索，查看欄位的 LookML 定義。

  2. 除了原始欄位之外，請決定要納入工具提示的欄位和值。例如「總毛利率百分比」。

  3. 將 html 參數新增至探索查詢中參照的原始資料表，並顯示在工具提示中。在本例中，目前在探索查詢中顯示在工具提示中的指標為「總毛利率」。

  4. 在 html 參數中，使用 Liquid 變數建立運算式，將其他欄位附加至現有評估值。

    • 本範例會使用 Liquid 變數 _rendered_value 來顯示Looker 格式化的值。舉例來說，total_gross_margin 會使用 Looker 格式設定兩位小數，而 percent_of_total_gross_margin 會使用 Looker 格式設定兩位小數的百分比。
    • 您可以使用直立線字元 | 分隔不同欄位的值。
    • 您也可以附加其他字詞，以便說明工具提示中顯示的其他值的含義。在本例中，我們加入 of total 來說明百分比值的意思。

  5. 確認程式碼正常運作後，請儲存、驗證並將程式碼推送至正式環境。

當使用者將游標懸停在含有工具提示的資料點上時，工具提示現在會顯示兩個值：資料點的 total_gross_margin 值，以及對應的 percent_of_total_gross_margin 值。

後續步驟

建立含有自訂工具提示的視覺化圖表後，您可以與他人分享：