NQL機能の採用

このページでは、ガイド関連のデータをクエリするために使用するAdopt専用のNQLデータモデルを紹介しています。このデータモデルは名前空間とテーブルで構成されています。

Adopt専用のNQLテーブル

Adopt専用のテーブルの詳細については、NQLデータモデルを参照してください。

Adoptは主に次のNQLテーブルを使用します:

  • application.guide: このテーブルは、ウォークスルー、ツールチップ、またはメディアドキュメントのようにエンドユーザーに提供される任意の種類のガイダンスオブジェクトを表します。

  • application.guide_step: このテーブルは、ウォークスルータイプのガイド内の個々のステップオブジェクトを表します。

  • web.context_help_executions: このテーブルは、ウェブアプリケーションのコンテキストヘルプ要素との従業員の対話を追跡します(例: クエスションマークアイコンのクリック、ガイドの検索)。

  • web.guide_executions: このテーブルは、対象のWebアプリケーションを使用する各従業員に対して複数回発生する可能性のあるガイドの実行イベントを記録します。

  • web.guide_step_executions: このテーブルは、ガイド内の個々のステップに対する従業員のインタラクションを収集します。

これらのテーブルは、ガイド、ガイド内のステップ、およびコンテキストヘルプの実行に対するユーザーのインタラクションを追跡します。 このデータは、Nexthink Adopt内での従業員の行動とガイドへのエンゲージメントを理解するために活用できます。

新しいメトリックの主な利点:

  • ガイドのエンゲージメントのクエリ: ガイドのターゲティング、エンゲージメント、実行時間、その他のユーザー相互作用メトリクスを追跡するために、新しいフィールドを使用します。

  • ガイドに関連するデータの粒度を高める: データの粒度を調整することにより、エンドユーザーが特定のステップやエレメントに関与した正確な時刻など、ガイドとのインタラクションについての正確な洞察を得ることができます。

アプリケーションNQL名前空間内のAdoptに関連する構成オブジェクト

guideテーブルのフィールド

以下の例では、アプリケーションNQL名前空間のguideテーブルからのnql_idフィールドオブジェクトを使用しています。

application.guides | list nql_id 
フィールド名
[説明]

nql_id

ガイドの一意識別子。

name

ガイドの一意識別子。

type

ガイドのタイプ (例: ウォークスルー, ツールチップ, メディア)。

status

ガイドのステータス (例: 公開, 下書き)。

guide_step テーブルフィールド

以下の例はapplicationNQL名前空間のguide_stepテーブルからrankフィールドオブジェクトを使用しています。

application.guide_steps | sort rank asc | limit 10 
guide_step テーブルフィールド
[説明]

nql_id

ガイドステップの一意識別子。

name

ガイドステップの名前。

type

ステップのタイプ (例: ウォークスルーステップ, アクション, 意思決定)。

rank

ガイド内のステップの位置またはシーケンス。

guide_nql_id

このステップを含むガイド識別子への関連。

web NQL名前空間におけるAdopt関連イベント

context_help_executions テーブルフィールド

以下の例は、web NQL名前空間のcontext_help_executionsテーブルからbrowser_languageフィールドイベントを使用しています。

web.context_help_executions during past 24h | sort browser_language desc
context_help_executions テーブルフィールド
[説明]

execution_id

コンテキストヘルプ実行の一意識別子。

status

コンテキストヘルプ実行のステータス: open, closed

url

インタラクションが発生したURL。

duration

コンテキストヘルプが開かれていた時間。

browser_language

コンテキストヘルプ実行のユーザーブラウザの言語。

number_of_executions

NQLで集計メトリックを計算するために使用されます(各イベントで常に1)。

guide_executions テーブルフィールド

以下の例は、web NQL名前空間のguide_executionsテーブルからstatusフィールドイベントを使用しています。

web.guide_executions from 2025-02-03 11:00:00 to Feb 4, 2025, 11 AM | list status
guide_executions テーブルフィールド
[説明]

execution_id

ガイド実行の一意識別子。

status

ガイド実行のステータス。

  • targeted: ガイドはユーザーにターゲティングされました(ガイドはユーザーに公開されました)。

  • started: ガイド実行が開始され、ユーザーはそれと接触しました。

  • completed: ガイド実行はユーザーによって完了されました。

  • closed: ガイドがユーザーによって中途で閉じられたか、終了されました。

number_of_executions

NQLでの集計メトリックの計算に使用されます。 全イベントでの値は常に1です。

duration

ガイドがエンドユーザーに表示された時間。

browser_language

ガイド実行のユーザーブラウザの言語。

targeting_count

特定のユーザー/キー・ページ/日をターゲットにしたガイドの回数。

url

ガイドがトリガーされたURL。

time

ガイド実行が行われたタイムスタンプ。

guide_step_executions テーブルフィールド

以下の例は、web NQL名前空間のguide_step_executionsテーブルからnumber_of_executionsフィールドイベントを使用しています。

web.guide_step_executions on 2025-02-04 | list number_of_executions | limit 100
guide_step_executions テーブルフィールド
[説明]

execution_id

ガイドステップ実行の一意識別子。

status

ガイドステップのステータス:

  • completed: ステップが完了されました(ユーザーがそのステップでのやり取りを完了しました)。

  • closed: ステップが閉じられた場合、ユーザーが完了前にそれを閉じるか放棄した場合。

url

ガイドステップが実行されたURL。

duration

ガイドステップがエンドユーザーに表示された期間。

number_of_executions

NQLで集計メトリックの計算に使用されます(カウントのような)。 全イベントでの値は常に1です。

engaged

ユーザーがガイドステップに関与したかどうかを識別します(true/false)。

browser_language

ガイドステップ実行のためのユーザーブラウザの言語。

time

ガイドステップが実行されたタイムスタンプ。


関連トピック

Last updated

Was this helpful?