高度なユースケースの導入
このページでは、Adopt内のエッジケースをナビゲートするための追加のヒントとガイドを提供します。 ここでは、高度な概念、構成オプション、および組織のニーズに応じて役立つかもしれないその他の情報を取り扱います。
Nexthinkブラウザ拡張機能での複数テナントの設定
これらの構成オプションは、Nexthink Infinityのテナントが2つ以上ある組織でNexthink Adoptが有効になっている場合にのみ適用され、管理者にのみ利用可能です。
Nexthinkブラウザ拡張機能を複数のNexthinkテナントと統合できます。 これにより、Adopt Editor を使用して、さまざまな Nexthink 環境に関連するガイドコンテンツを開発できます。
この機能は、たとえば、同じWebアプリケーションに対するAdoptガイドを作成し、異なるNexthink環境にリンクさせ、干渉や重複を防ぐ場合に便利です。
このページには、Nexthinkブラウザ拡張機能から複数のテナントを設定および切り替え、Adopt Editorでテナント固有のガイドコンテンツを開く手順が含まれています。
Nexthinkブラウザ拡張機能用に新しいテナントを設定するには：
ブラウザの Google Chrome または Microsoft Edge を開き、ブラウザツールバーの拡張機能アイコンを選択し、Nexthink を探します。
ピンアイコンをクリックして、ブラウザツールバーに拡張機能を追加します。
ピンされている拡張機能（Nexthinkアイコン）を右クリックし、Tenants Configurationを選択します。これにより、拡張機能の設定ページが開き、デフォルトのテナントが表示されます。
Add tenantをクリックし、NameとURLフィールドにAdd tenantポップアップから記入します。
NexthinkインスタンスのURLを追加します。 例：
https://nexthink.tet.nexthink.saasURLの末尾にはスラッシュ（
/）—通称トレイリングスラッシュ—を含めることはできません。
新しいテナントのアクションメニューを開き、Authenticateを選択します。 これにより、新しいウィンドウで認証ページが開きます。 認証が完了したら、このテナントを選択して、Adopt Editorで関連するガイドを開くことができます。
テナントを切り替えて Adopt Editor でインスタンス固有のガイドを開く
Nexthinkテナントへの認証
Adopt Editorで特定のNexthink Infinity環境に関連付けられたガイドにアクセスするには、そのNexthink環境での認証が必要です。
Nexthinkブラウザ拡張機能のTenants Configurationページにアクセスし、アクションメニューからAuthenticateを選択します。
または、デフォルトのNexthinkテナントに認証するには、ブラウザツールバーのNexthinkアイコンを右クリックし、Sign in as adminを選択します。
Adopt Editorでのテナント切り替え
認証が完了したら、ブラウザツールバーから Nexthink アイコンをクリックします。
ドロップダウンメニューから目的のテナントを選び、ターゲットのウェブアプリケーションを選択します。
興味のあるガイドをクリックして、Adopt Editorを直接ウェブアプリケーションのURLで開きます。
Nexthinkブラウザ拡張機能は、関連するNexthink Infinity環境で作成され、まだ公開されていないガイドのみをリストします。
ガイドコンテンツの作成と編集の詳細については、アプリ内Adopt Editorからのガイドコンテンツ開発 のドキュメントを参照してください。
デフォルトテナントの選択
マルチテナントアーキテクチャにおいて、特定の環境に関連付けられたガイドをウェブアプリケーションでの表示として確認するには（例: テスト目的など）、そのテナントをデフォルトに設定する必要があります。
これをするには:
Nexthinkブラウザ拡張機能のテナント設定ページに移動します。
希望するテナントのアクションメニューを開きます。
デフォルトに設定を選択します。
通常のケースでは、組織は単一のNexthinkインスタンスの下で運営されています。 ただし、組織が開発環境を使用している場合、複数のテナントが必要になることがあります。その目的は、別々の環境で採用ガイドをテストするためです。
NQL機能を採用する
特定の採用ガイドイベントは、データ収集、ガイドの関与測定、または分析の目的で調査を通じてクエリを実行できます。
採用特有のNQLテーブルを採用
採用では主に以下のNQLテーブルが使用されます:
application.guide: このテーブルはガイドオブジェクトを表します。エンドユーザーに提供されるさまざまなタイプのガイダンス（例：ウォークスルー、ツールチップ、メディア文書）を含みます。application.guide_step: このテーブルは、ウォークスルータイプのガイドの個別ステップオブジェクトを表します。web.context_help_executions: このテーブルは、Webアプリケーションのコンテキストヘルプ要素との従業員のやりとりを追跡します（例：質問マークアイコンをクリックする、ガイドを検索する）。web.guide_executions: このテーブルはガイドの実行イベントを記録します。このイベントは、ターゲットのWebアプリケーションを使用している各従業員のために複数回発生することがあります。web.guide_step_executions: このテーブルは、ガイド内の個々のステップとの従業員のやりとりを捕捉します。
これらのテーブルは、ガイドやガイド内のステップ、コンテキストヘルプの実行に関するユーザーのやりとりを追跡します。 このデータは、Nexthink Adopt内の従業員の行動やガイドの関与を理解するために活用できます。
これらのメトリクスは次の利点を提供します:
ガイドの関与をクエリする: ガイドのターゲティング、関与度、実行時間、その他のユーザーのやりとりのメトリクスを追跡するために新しいフィールドを使用します。
ガイド関連のデータの詳細度を高める: データの詳細度を調整することで、エンドユーザーが特定のステップまたは要素と関わる正確なタイミングに関する詳細な洞察を得ることができます。
application NQLネームスペース内の採用関連の設定オブジェクト
application NQLネームスペース内の採用関連の設定オブジェクトguideテーブルのフィールド
guideテーブルのフィールド以下の例ではapplication NQLネームスペースのguide テーブルからnql_id フィールドオブジェクトを使用しています。
application.guides
| list nql_idnql_id
ガイドの一意の識別子。
name
ガイドの一意の識別子。
type
ガイドのタイプ（例：ウォークスルー、ツールチップ、メディア）。
status
ガイドのステータス（例：公開済み、下書き）。
guide_stepテーブルのフィールド
guide_stepテーブルのフィールド以下の例では、application NQLネームスペースのguide_step テーブルからrank フィールドオブジェクトを使用しています。
application.guide_steps
| sort rank asc
| limit 10nql_id
ガイドステップの一意の識別子。
name
ガイドステップの名前。
type
ステップのタイプ（例：ウォークスルーステップ、アクション、決定）。
rank
ガイド内のステップの位置や順番。
guide_nql_id
このステップを含むガイド識別子への関係。
web NQLネームスペースの採用関連イベント
web NQLネームスペースの採用関連イベントcontext_help_executionsテーブルのフィールド
context_help_executionsテーブルのフィールド以下の例では、web NQLネームスペースのcontext_help_executions テーブルからbrowser_language フィールドイベントを使用しています。
web.context_help_executions過去24時間
| sort browser_language descexecution_id
コンテキストヘルプ実行の一意の識別子。
status
コンテキストヘルプ実行のステータス： 開く、閉じる。
url
やりとりが発生したURL。
duration
コンテキストヘルプが開いたままでいた時間の長さ。
browser_language
コンテキストヘルプ実行でユーザーのブラウザの言語。
number_of_executions
NQLで集計メトリクスを計算するのに使用（各イベントで常に1）。
guide_executions テーブルのフィールド
guide_executions テーブルのフィールド以下の例では、web NQLネームスペースのguide_executions テーブルからstatus フィールドイベントを使用しています。
2025-02-03 11:00:00から2025年2月4日午前11時までのweb.guide_executions
| list statusexecution_id
ガイド実行の一意の識別子。
status
ガイド実行のステータス。
ターゲット: ガイドがユーザーにターゲットされました（ユーザーへガイドが提供されました）。
開始: ガイド実行が開始され、ユーザーがやりとりしました。
完了: ガイド実行がユーザーによって完了しました。
閉じる: ユーザーがガイドを完了、またはそのステップを完了せずに閉じました。
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 フィールドイベントを使用しています。
2025-02-04にweb.guide_step_executions
| list number_of_executions
| limit 100execution_id
ガイドステップ実行の一意識別子。
status
ガイドステップのステータス。
完了: ステップが完了されました（ユーザーがそのステップとやりとりを終了しました）。
閉じる: ステップが閉じられた、通常はユーザーがそれを完了前に閉じるまたは放棄する場合。
url
ガイドステップが実行されたURL。
duration
ガイドステップがエンドユーザーに表示されていた時間。
number_of_executions
NQLでの集計メトリクス（例：カウント）計算に使用。 各イベントの値は常に1です。
engaged
ユーザーがガイドステップと関わったかどうかを識別（true/false）。
browser_language
ガイドステップ実行時のユーザーのブラウザの言語。
time
ガイドステップ実行が発生したタイムスタンプ。
Adoptエディターのユースケース
以下のユースケースはAdoptエディターに適用されます。 それらを適用してガイドを持続可能に構成および管理します。
非表示ステップ
非表示ステップは、ユーザーにオーバーレイを表示せずにアクションを実行したり、ユーザー操作を待ったりするために使用されます。 これらのステップは、ガイド内の背景ロジックを処理します。例えば特定のページに移動したり、ページの読み込みを待ったり、要素までスクロールしたり、要素の周りに枠を表示したり、ユーザー操作が発生するまで一時停止したりします。
非表示ステップを追加するには:
新しいステップを追加し、適切にラベルを付けてコンテンツを追加しないようにします。
ステップの設定を開きます。 外観で、ステップオーバーレイを非表示に設定します。 これにより、ユーザーは空のオーバーレイを表示しません。 シャドウをオフに設定して、短い視覚的なちらつきを防ぎます。
ステップを必要に応じて設定します。 以下のユースケースは非表示ステップを利用しており、その有用性に洞察を提供します。
設定を保存します。
ボタンのホバーでステップをトリガーする
特定の要素、ボタンなどの上にユーザーがホバーするときにステップをトリガーすることで、ステップ条件を検証します。 このアプローチにより、必須フィールドまたは条件が満たされる前にユーザーが続行しないことを確認し、各アクションが適切なタイミングで実行されることを保証します。
Adoptエディターでガイドを開きます。
ホバーアクションを検出するために新しいステップを追加します。
これを非表示ステップにすることができます。 その場合、ステップが完了したときのトリガーをすぐにステップを完了に設定する必要があります。
セレクターツールを使用して、ターゲットとなる要素をキャプチャします。
ステップの設定を開きます。 トリガーで、マウスオーバーをステップが開始されるときに設定します。
外観で、ステップオーバーレイを非表示に設定します。シャドウをオフに設定します。
ホバーイベントが検出されると、ステップは自動的に完了し、ガイドは次の見えるステップに進みます。
保存してテストし、ステップがユーザーが要素にホバーするまで正しく待機し、その後期待通りに進むことを確認します。
ユーザーの操作なしで経過時間後にステップを自動的に完了する
ステップの自動化を使用してガイドを簡素化し、不要なクリックを減らします。 これをタイマーとアクションによって達成でき、ガイドが自立的に進み、エンドユーザーの手動操作を減らします。
Adoptエディターでガイドを開きます。
対象要素とやりとりするステップを選択します。
ステップの設定を開きます。 トリガー内のステップが完了したときに、数秒後にステップが自動的に終了するようタイマーを設定します（例、3秒）。
冗長性のために、ユーザーがガイドを手動で進めることができるように、アクションタイプをクリックに設定したままにしておきます。
設定を保存します。
ガイドを公開してテストし、ステップが自動的に完了し、クリックが正しい順序で実行されることを確認します。
言語依存のセレクタ
インターフェイスの異なる言語でガイドの信頼性を確保するために、ローカライズされたテキストに影響されないセレクタを選びます。 XPathセレクタは、UIが翻訳されたときに変更される可能性のある言語特有のテキスト値を保持しており、これによりステップが失敗することがあります。 CSSセレクタは一般的により安定しており、言語非依存です。 一般的なルールとして、XPathを使用するステップが多言語対応であることを確認し、全体の安定性を向上させます。
Adoptエディタでガイドを開きます。
言語関連の不安定性を引き起こしているステップを選択します。
ステッププロパティを開きます。 位置で、セレクタフィールドを確認します：
セレクタがXPathを使用しており、（例：ボタンラベルなど）テキストを参照している場合、それはその言語でしか機能しません。
複数の言語をサポートするために、次のオプションのいずれかを使用します：
オプション1： 各言語バージョンの要素を再選択し、各ロケールが自分のXPathを持つようにします。
言語はツールバーまたはステップ設定で切り替えることができます。
ローカライズされていない場合、特定の言語のXPathは空になります。
オプション2： テキストではなく構造またはクラスベースの属性をターゲットにしたCSSセレクタ（XPathセレクタの代わり）を使用します。
可能な限り、広範で安定したセレクタを使用します。 最善の方法は、ページの読み込みに応じて変更される動的なIDや要素を避けることです。
サポートされている各言語でガイドをテストし、すべての要素が正しく検出され、ステップが期待通りにトリガーされることを確認します。
関連トピック
Last updated
Was this helpful?