NQL機能の採用

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

Adopt専用のNQLテーブル

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

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

• application.guide: このテーブルはユーザーに提供されるガイダンス（例: ウォークスルー、ツールチップ、メディアドキュメントなど）を表します。

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

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

• web.guide_executions: このテーブルは、ウェブアプリケーションを使用する各従業員に対して、ガイドが複数回実行されるイベントを記録します。

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

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

新しい指標の主な利点:

• ガイドのエンゲージメントをクエリする: 新しいフィールドを使用して、ガイドのターゲティング、エンゲージメント、実行時間など、他のユーザーインタラクション指標を追跡します。

• ガイド関連データの詳細度を上げる: データの詳細度を調整することで、従業員がガイドとどのようにインタラクションするかについて、詳細な洞察を得ることができます。例えば、エンドユーザーが特定のステップや要素と何時に関わるかを正確に把握できます。

application NQL名前空間内のAdopt関連構成オブジェクト

guideテーブルフィールド

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

application.guides 
| list nql_id 

フィールド名	説明
nql_id	ガイドの一意の識別子。
name	ガイドの一意の識別子。
type	ガイドのタイプ（例: ウォークスルー、ツールチップ、メディア）。
status	ガイドのステータス（例: 公開済み、草案）。

guide_stepテーブルフィールド

以下の例は、application NQL名前空間の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	コンテキストヘルプ実行のステータス: 開いている, 閉じた.
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	ガイド実行のステータス。 ターゲティング済み: ガイドがユーザーにターゲティングされた（ガイドがユーザーに提供された）。 開始済み: ガイドの実行が開始され、ユーザーがそれにインタラクションした。 完了済み: ガイドの実行がユーザーによって完了された。 閉じた: ユーザーがガイドをそのステップを完了する前に閉じた。
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	ガイドステップのステータス: 完了済み: ステップが完了された（ユーザーがそのステップとのインタラクションを終えました）。 閉じた: ユーザーがステップを閉じた、通常は完了前に閉じたり放棄したりする時。
url	ガイドステップが実行されたURL。
duration	ガイドステップがエンドユーザーに表示されていた時間の長さ。
number_of_executions	NQLでの集計メトリクス（例えばカウント）の計算に使用される。このイベントの値は常に1。 engaged
婚約中	ユーザーがガイドステップに参加したかどうかを識別します（true/false）。
browser_language	ガイドステップ実行時のユーザーのブラウザの言語。
time	ガイドステップが実行されたタイムスタンプ。

---

関連トピック

• Adoptタブの理解

• ガイドの詳細ダッシュボードを分析する