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テーブルのフィールド
guideテーブルのフィールド以下の例では、アプリケーションNQL名前空間のguideテーブルからのnql_idフィールドオブジェクトを使用しています。
nql_id
ガイドの一意識別子。
name
ガイドの一意識別子。
type
ガイドのタイプ (例: ウォークスルー, ツールチップ, メディア)。
status
ガイドのステータス (例: 公開, 下書き)。
guide_step テーブルフィールド
guide_step テーブルフィールド以下の例はapplicationNQL名前空間のguide_stepテーブルからrankフィールドオブジェクトを使用しています。
nql_id
ガイドステップの一意識別子。
name
ガイドステップの名前。
type
ステップのタイプ (例: ウォークスルーステップ, アクション, 意思決定)。
rank
ガイド内のステップの位置またはシーケンス。
guide_nql_id
このステップを含むガイド識別子への関連。
web NQL名前空間におけるAdopt関連イベント
web NQL名前空間におけるAdopt関連イベントcontext_help_executions テーブルフィールド
context_help_executions テーブルフィールド以下の例は、web NQL名前空間のcontext_help_executionsテーブルからbrowser_languageフィールドイベントを使用しています。
execution_id
コンテキストヘルプ実行の一意識別子。
status
コンテキストヘルプ実行のステータス： open, closed。
url
インタラクションが発生したURL。
duration
コンテキストヘルプが開かれていた時間。
browser_language
コンテキストヘルプ実行のユーザーブラウザの言語。
number_of_executions
NQLで集計メトリックを計算するために使用されます（各イベントで常に1）。
guide_executions テーブルフィールド
guide_executions テーブルフィールド以下の例は、web NQL名前空間のguide_executionsテーブルからstatusフィールドイベントを使用しています。
execution_id
ガイド実行の一意識別子。
status
ガイド実行のステータス。
targeted: ガイドはユーザーにターゲティングされました（ガイドはユーザーに公開されました）。
started: ガイド実行が開始され、ユーザーはそれと接触しました。
completed: ガイド実行はユーザーによって完了されました。
closed: ガイドがユーザーによって中途で閉じられたか、終了されました。
number_of_executions
NQLでの集計メトリックの計算に使用されます。 全イベントでの値は常に1です。
duration
ガイドがエンドユーザーに表示された時間。
browser_language
ガイド実行のユーザーブラウザの言語。
targeting_count
特定のユーザー/キー・ページ/日をターゲットにしたガイドの回数。
url
ガイドがトリガーされたURL。
time
ガイド実行が行われたタイムスタンプ。
guide_step_executions テーブルフィールド
guide_step_executions テーブルフィールド以下の例は、web NQL名前空間のguide_step_executionsテーブルからnumber_of_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?