Looker ビジュアリゼーション クックブックを最大限に活用する: ツールチップのカスタマイズ

ビジュアリゼーション ツールチップには、デフォルトで選択したディメンションおよびメジャーの値が表示され、ユーザーがデータの 1 点の重要性を理解することをサポートします。

たとえば、州ごとにグループ化された合計総利益に基づくマップ ビジュアリゼーションのツールチップでは、ユーザーがカリフォルニア州にカーソルを合わせると、両方のフィールドの値を表示します。

ユーザーがカリフォルニア州にカーソルを合わせると、州の値が「カリフォルニア州」で、合計総利益が「$988,018.58」のツールチップが表示されます。

しかし、デフォルト以外のフィールドをツールチップに含めて、ユーザーが他の場所を探すことなくデータポイントに関する詳細な情報やコンテキストを取得できるようにするにはどうすればよいでしょうか。

ツールチップをカスタマイズして、Explore クエリにないフィールドを含む、複数の指定フィールドの値を表示できます。

材料

前提条件

ツールチップをカスタマイズするには、以下のものが必要です。

ツールチップのカスタマイズに関する考慮事項

ツールチップをカスタマイズする場合は、次の点を考慮することが重要です。

  • html パラメータの値は、ビジュアリゼーションの Y 軸になります。
  • Y 軸に表示する値は、measure の sql パラメータの値である必要があります。
  • 書式設定された measure（type: percent_of_total の measure、または value_format_name か value_format パラメータの measure）を使用している場合は、レンダリングされた値 {{ field_name._rendered_value }} に Liquid 構文を使用していることを確認します（field_name は、メジャーまたはディメンションの実際の名前です）。

例

デフォルトでは、ビジュアリゼーション データポイントのツールチップには、合計総利益と州の値が含まれます。しかし、地図上に表示されてなく、Explore クエリにも含まれていない追加情報をユーザーに提供する場合はどうでしょうか。[State] ではなく [Percent of Total Gross Margin] というフィールドに値を含める場合はどうでしょうか。[合計総利益率] を含めると、個々のデータポイントの [合計総利益率] とデータセットの合計総利益を比較できます。

ツールチップをカスタマイズする手順は次のとおりです。

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. Development Mode で、カスタマイズするフィールドの LookML 定義に移動します。

    フィールドの LookML 定義には、Explore から直接移動できます。

  2. 元のフィールドに加えて、ツールチップに含めるフィールドと値を決定します。たとえば、合計総利益率などです。

  3. Explore クエリで参照され、ツールチップに表示される元の measure に html パラメータを追加します。この場合、現在 Explore クエリに含まれ、ツールチップに表示されている measure は、合計総利益です。

  4. html パラメータで、既存の measure 値に追加のフィールドを追加する Liquid 変数を含む式を作成します。

    • この例では、Liquid 変数 _rendered_value を使用して、Looker で書式設定された値を表示します。たとえば、total_gross_margin は小数点以下 2 桁の Looker 形式を使用し、percent_of_total_gross_margin は小数点以下 2 桁の百分率の Looker 形式を使用します。
    • パイプ文字（|）を使用して、異なるフィールドの値を区切ることができます。
    • また、ツールチップに表示される他の値の意味を明確にするために、他の単語を追加することもできます。この場合は、百分率値の意味を明確にするために of total が追加されます。

  5. 保存して検証し、期待通りに動作することを確認したら、コードを本番環境にプッシュしてください。

ユーザーがツールチップを含むデータポイントにカーソルを合わせると、2 つの値（そのデータポイントの total_gross_margin 値と、対応する percent_of_total_gross_margin 値）が表示されるようにしました。

次のステップ

カスタマイズしたツールチップを含むビジュアリゼーションを作成したら、それを他のユーザーと共有できます。