キャンペーン NQL の例

キャンペーンを組織内で計画、承認取得、テストおよび開始する際のガイドラインは、キャンペーンプログラムの開始ドキュメントを参照してください。

このNQLクエリの例のリストは、キャンペーンに関連するユーザーを選択するのに役立ちます。 以下のクエリを確認し、あなたのユースケースに最も似ているクエリをコピーして、適宜調整してください。

スケジュールされたキャンペーンでユーザーをターゲットにするためのクエリ例\

特定の都市からすべてのユーザーを取得する。
users
| where ad.city == "Lausanne"
Retrieve users with installed Collector (xTray) that has been running on their device in the last 24 hours.
users
| include execution.events during past 24h
| where binary.name == "nxtray*"
| compute c1 = binary.name.count()
| where c1 > 0
過去1日にMS TeamsまたはZoomをインストールしたユーザーを取得する。
users
| with package.installations during past 1d
| where package.name in [ "MS Teams", "Zoom" ]
特定の部門のユーザーを取得する。
users
| where ad.department == "Finance"
Retrieve the last user of a device that has had 3 system crashes in the past 7 days.
devices past 7d
| with device_performance.system_crashes past 7d
| compute nb_crashes = count()
| where nb_crashes >= 3
| with session.events past 7d
| compute user_sid = user.sid.last()
| list user_sid
IT部門に所属しない、バッテリーの健康状態が悪いデバイスの最後のユーザーを取得する。
devices past 7d
| where remote_action.get_battery_status.execution.outputs.BatteryHealth < 0.3
| with session.events past 7d
| where user.ad.department != "*IT*"
| compute user_sid = user.sid.last()
| list user_sid
DEXキャンペーンをスケジュールする

異なる従業員サンプルをランダムに選択して感情データを継続的に収集するために、以下のクエリを設定してください。 #dex_campaign_nameをキャンペーンのNQL IDに置き換え、下記の50として設定されている新しいユーザー数の制限を調整して、キャンペーンが毎時間ターゲットにする新しいユーザーの数を指定してください。

注意が必要な点は以下の通りです:

  • Define the trigger Schedule and select Only after the (minimum) number of days you want to have in between responses for each employee

  • 以下のNQLクエリを使用する前に、キャンペーンを少なくとも一度保存してください。そうすることで、システムがキャンペーンの存在を認識し、NQLクエリの検証時に"テーブルが存在しません"というエラーを生成しないようにします。

users
| include campaign.#dex_campaign_name.responses
| compute number_of_requests = count()
| sort number_of_requests asc
| limit 50

キャンペーン結果を検査するためのクエリ例\

すべての応答

Remote Work Demoキャンペーンのすべての応答を表示し、ユーザー名時間状態、および状態詳細をそれぞれのユーザーごとに表示する。

campaign.responses
| where campaign.name == "Remote Work Demo"
| list user.name, response.time, state, state_details
概要表示

Remote Work Demoキャンペーン応答の概要表示には、キャンペーンのトリガーメソッド時間状態状態詳細とユーザーに対する回答数が含まれる。

campaign.responses
| where campaign.name == "Remote Work Demo"
|list response.trigger_method, user.name, response.time, campaign.response.first_planned, campaign.response.first_targeted, campaign.response.first_displayed, state, state_details, response.number_of_answered_questions
状態ごとに応答をカウントする

Remote Work Demoキャンペーンにおける、ユーザー状態、および状態詳細ごとのキャンペーン応答をカウントする。

campaign.responses
| where campaign.name == "Remote Work Demo"
| summarize cnt = count() by user.name, campaign.response.state, campaign.response.state_details
| list user.name, cnt, campaign.response.state, campaign.response.state_details   
特定のユーザーの応答をカウントする

特定のユーザーのキャンペーン状態および状態詳細`ごとのキャンペーン応答をカウントする。

campaign.responses
| where user.name == "johndoe@DOMAIN"
| summarize cnt = count() by campaign.name, user.name, campaign.response.state, campaign.response.state_details   
| list user.name, campaign.name, cnt, campaign.response.state, campaign.response.state_details 
履歴状態

Remote Work Demoキャンペーンにおけるキャンペーン応答の履歴状態を表示する。

campaign.responses
| where campaign.name == "Remote Work Demo"
| list response.historical_time, response.historical_state, response.historical_state_details
回答または拒否された応答の数をカウントする

#my_campaign NQL IDを持つキャンペーンの回答または拒否された応答の数をカウントする。

campaign.#my_campaign.responses
| where state in [answered, declined]
| summarize cnt_responses = request_id.count() by state
| list state, cnt_responses
質問の選択肢ごとに応答の数をカウントする

vpn_quality質問IDを持つ単一選択、意見スケール、またはNPS質問の質問選択肢ごとに応答数をカウントする。

campaign.#my_campaign.responses
| summarize cnt = request_id.count() by answers.vpn_quality.label, state, state_details
| sort cnt desc
特定のキャンペーンに回答したユーザーのリスト

#my_campaign NQL IDを持つキャンペーンに回答したユーザーのリスト。

campaign.#my_campaign.responses
| where state == answered
| list user.name, state, state_details, number_of_answered_questions
特定の選択肢で回答したユーザーのリスト

List users who answered with the choice labeled as always for the question with the how_often NQL ID for the campaign with the #my_campaign NQL ID.

campaign.#my_campaign.responses during past 30d
| where answers.how_often.label = "always"
| list user.name, time
感情キャンペーンに対する最後の回答を持つユーザーのリスト

#service_sentiment NQL IDを持つ感情キャンペーンに関連するsentiment質問IDに対する最後の回答を持つすべてのユーザーのリスト(該当する場合)。

users
| include campaign.#service_sentiment.responses
| where state == answered
| compute last_satisfaction = answers.sentiment.label.last(), last_answer_on_device = device.name.last()
| list user.name, last_satisfaction, last_answer_on_device
パラメトリックキャンペーンの特定の値を持つパラメータに対する最後の回答を持つユーザーのリスト

List users with their last answer and comment to the question with the sentiment question ID and the ticket_number parameter associated with the request for the parametric campaign with the #ticket_satisfaction NQL ID, where the parameter value with the issue_type ID is Incident.

users
| with campaign.#ticket_satisfaction.responses
| where state == answered and parameters.issue_type == "Incident"
| compute last_satisfaction = answers.sentiment.label.last(), last_comment = answers.sentiment.comment.last(), ticket_number = parameters.ticket_number.last()
| list ticket_number, last_satisfaction, last_comment, user.name

Last updated