> For the complete documentation index, see [llms.txt](https://docs.nexthink.com/platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexthink.com/platform/ja/user-guide/campaigns/campaigns-nql-capabilities/scrutinizing-the-results-of-a-campaign-with-nql.md).

# NQLでキャンペーンの結果を詳細に分析する

{% hint style="warning" %}
組織内でキャンペーンを計画し、承認を得て、テストおよび開始するためのガイドラインについては、[キャンペーンプログラムの開始](/platform/ja/user-guide/campaigns/managing-campaigns/launching-campaign-programs.md)に関するドキュメントを参照してください。
{% endhint %}

キャンペーンを公開すると、対象の従業員がキャンペーンの質問への回答を開始します。 Nexthink Query Language（NQL）の調査を作成して、従業員がキャンペーンをどのように操作し、質問にどのように回答したかを確認します。

## Investigations でキャンペーンの結果を表示する <a href="#scrutinizingtheresultsofacampaignwithnql-viewingtheresultsofacampaignininvestigations" id="scrutinizingtheresultsofacampaignwithnql-viewingtheresultsofacampaignininvestigations"></a>

{% hint style="info" %}
リモートアクションによってトリガーされたキャンペーンの結果は、リモートアクション画面の実行中にローカルでのみ利用できます。そのため、リモートアクションキャンペーンでは、キャンペーンの詳細ページに回答データは表示されません。
{% endhint %}

* メインメニューから **キャンペーン** を選択します。
* ナビゲーションパネルに表示されているキャンペーンを選択すると、詳細を確認できます。ナビゲーションパネルには、公開済みおよび終了済みのキャンペーンが表示されます。
* ナビゲーションパネルから **キャンペーンの概要** を選択すると、公開済みおよび終了済みのすべてのキャンペーンとその統計情報を確認できます。

キャンペーンダッシュボードおよびキャンペーン結果のエクスポートには、ユーザー名は含まれません。これにより、このページにのみアクセスできる関係者など、調査の権限を持たないユーザーから回答者の身元が隠されます。

調査の権限を持つユーザーは Investigations でキャンペーン結果にアクセスでき、回答をユーザーおよびデバイスの特性と併せて分析することで、より詳細な分析を行えます。

詳細については、[特定のキャンペーン回答のモニタリング](/platform/ja/user-guide/campaigns/working-with-campaigns/monitoring-specific-campaign-responses.md)ドキュメンテーションを参照してください。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-07ae24c44746ad18a49557966b94d57a7be5c700%2FCamapign_details_8928372a9.png?alt=media" alt=""><figcaption></figcaption></figure>

キャンペーンの詳細ページで、ページ右上のアクションメニューをクリックし、**Investigate** を選択すると、以下を含むキャンペーン回答の結果を生成するための事前作成済みクエリが設定された Investigations ページが開きます：

* ユーザー情報。
* 回答状態および状態の詳細。
* 各質問への回答、および該当する場合は自由記述コメント。
* キャンペーンがパラメトリックである場合のパラメータ値。

Investigations ページでは、NQL クエリを絞り込んで、要件に応じて列を調整したり結果をフィルタリングしたりできます。

## NQL を使用してキャンペーン情報と結果をクエリする <a href="#scrutinizingtheresultsofacampaignwithnql-queryingcampaigninformationandresultswithnql" id="scrutinizingtheresultsofacampaignwithnql-queryingcampaigninformationandresultswithnql"></a>

NQL を使用すると、以下のテーブルをクエリして、キャンペーンとその回答に関する重要な情報にアクセスできます：

* `campaign.campaigns` には、公開済みまたは終了済み状態のすべてのキャンペーンに関する基本情報が含まれます。
* `campaign.responses` には、実際に行われた、または想定されるすべてのキャンペーン回答の詳細が含まれます。質問への回答やパラメータ値など、キャンペーン固有のデータを確認する必要はなく、複数のキャンペーンにまたがる統計情報を収集する必要がある場合に使用します。
* 各キャンペーンでは（キャンペーンの公開後）、その特定のキャンペーンの回答を調査するための動的テーブル `campaign.nql_id_of_the_campaign.responses` を利用できます。たとえば、`campaign.#my_campaign.responses` や `campaign.dex_score_campaign.responses` です。 `campaign.responses` テーブルで利用可能なフィールドに加えて、キャンペーンの動的データモデルテーブルには、各質問への回答のフィールド、およびキャンペーンがパラメトリックの場合は各パラメータの値のフィールドが含まれます。

フィールドの一覧については、[NQLデータモデル](/platform/ja/understanding-key-data-platform-concepts/nql-data-model.md)ページを参照してください。

同じキャンペーンの対象にユーザーが複数回指定された場合、各回は異なる回答に対応します。ユーザーによるキャンペーンへの最新の回答のみを取得する必要がある場合は、`last` NQL 演算子を使用できます。詳細については、[NQL 構文](/platform/ja/understanding-key-data-platform-concepts/nexthink-query-language-nql/nql-operators/nql-syntax-operators.md)および[クエリの例](/platform/ja/user-guide/campaigns/campaigns-nql-capabilities/campaigns-nql-examples.md)を参照してください。

## 動的データモデルを使用して回答とパラメータを調査する <a href="#scrutinizingtheresultsofacampaignwithnql-inspectinganswersandparametersusingthedynamicdatamodel" id="scrutinizingtheresultsofacampaignwithnql-inspectinganswersandparametersusingthedynamicdatamodel"></a>

動的データモデルは、従業員の回答に関する詳細を収集するために、質問ごとのフィールドを提供します。 NQL で使用される質問識別子は、キャンペーンで定義された質問 ID に対応します。 Campaigns (Classic) を使用する場合、質問識別子は質問の順序に基づきます。たとえば、`#1` や `#2` です。

利用可能なフィールドは質問の種類に対応します：

* 単一回答の質問では、`answers.question_id.label` を使用して、従業員が選択した回答ラベルを取得できます。
* 複数回答の質問では、`answers.question_id.labels` を使用して、従業員が選択した回答ラベルのリストを取得できます。
* 意見尺度の質問では、`answers.question_id.label` を使用して従業員が選択した回答ラベルを取得し、`answers.question_id.value` を使用して関連付けられた値を取得できます。値は、選択された回答の名前の後に、その回答に割り当てられた数値を括弧内に表示したものです。
* NPS の質問では、`answers.question_id.value`（0～10の数値）、`answers.question_id.category`（promoter、passive、detractor のいずれか）、`answers.question_id.label`（0 の detractor から 10 の promoter まで）の各方法で、選択された回答の詳細を取得できます。

さらに、すべての質問タイプで、`answers.question_id.comment` を使用して任意の自由記述コメントにアクセスでき、`answers.question_id.type` を使用して質問タイプを確認できます。

パラメトリックキャンペーンでは、`parameters.parameter_id` を使用して、キャンペーンのトリガー時に指定されたパラメータの値にアクセスできます。

## 回答状態 <a href="#scrutinizingtheresultsofacampaignwithnql-responsestate" id="scrutinizingtheresultsofacampaignwithnql-responsestate"></a>

回答の状態は、キャンペーンの配信ステータス、従業員によるキャンペーンの操作、およびキャンペーンの質問に対する従業員の回答について示します。 `responses` テーブルの `state` および `state_details` フィールドには、回答の現在の状態が反映されます。履歴化された状態情報は、`historical_state`、`historical_state_details`、`historical_time` フィールドを使用して取得できます。

以下に、回答の各状態の詳細を示します。

| 地域      | 状態の詳細          | 説明                                                                                                                                                                                                                                                                                  |
| ------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 予定済み    | 該当なし           | <p>キャンペーンがトリガーされた時点で従業員はデバイス上でオンラインであり、<a href="/platform/ja/user-guide/campaigns/managing-campaigns/creating-campaigns/limiting-the-reception-rate-of-campaigns.md">従業員保護ルール</a>を考慮したうえで、従業員のデバイスが表示可能になり次第、キャンペーンを表示できる状態です。</p><p>この状態にはバリエーションがないため、この場合、状態の詳細フィールドは該当しません。</p> |
| ターゲット   | オフライン          | キャンペーンがトリガーされた時点で、従業員はオフラインでした。                                                                                                                                                                                                                                                     |
| ターゲット   | 遅延             | キャンペーンの急増からユーザーを保護する間隔（[DNDP、NNPP](/platform/ja/user-guide/campaigns/managing-campaigns/creating-campaigns/limiting-the-reception-rate-of-campaigns.md)）中に到着したため、キャンペーンはまだ配信されていません。保護期間が終了すると、従業員にキャンペーンが配信されます。                                                                   |
| ターゲット   | 延期             | ユーザーが *後で通知する* オプションをクリックして、キャンペーンを延期しました。デフォルトのリマインダー頻度は1日に2回です。                                                                                                                                                                                                                   |
| ターゲット   | 通知済み           | 最初の質問のコンテンツサイズに応じて、キャンペーンが半分折りたたまれた状態または完全に開いた状態でユーザーに表示されました。                                                                                                                                                                                                                      |
| ターゲット   | 開封済み           | ユーザーにキャンペーンが表示され、半分折りたたまれた状態から開きました。つまり、ユーザーは最初の質問を完全に確認しました。質問が折りたたまれずに表示される場合、状態は *通知済み* から直接 *開封済み* に更新されます。                                                                                                                                                                     |
| 拒否      | 該当なし           | 従業員は回答を辞退しました。この状態にはバリエーションがないため、その場合、状態の詳細フィールドは該当しません。                                                                                                                                                                                                                            |
| 回答済み    | 一部回答済み         | 従業員は質問の一部のみに回答しました。                                                                                                                                                                                                                                                                 |
| 回答済み    | 全回答済み          | 従業員はすべての質問に回答しました。                                                                                                                                                                                                                                                                  |
| キャンセル済み | キャンセル済み        | 従業員またはデバイスが存在しなくなったなどの技術的な理由により、スケジューラールールによってイベントがキャンセルされました。                                                                                                                                                                                                                      |
| キャンセル済み | ユーザーが見つかりません   | システムは、指定された SID に関連付けられた従業員を見つけることができません。                                                                                                                                                                                                                                           |
| キャンセル済み | 期限切れ           | <p>従業員を対象とするリクエストが送信されましたが、標準の有効期限内に回答または辞退されませんでした。</p><p>リクエストはデフォルトで1年後に期限切れになります。有効期限は、API を使用してキャンペーンをトリガーする場合にのみ変更できます。</p>                                                                                                                                                   |
| キャンセル済み | すでに保留中         | 手動または API により再度対象に指定された際、従業員には同じキャンペーンに対する保留中の回答（未回答かつ未辞退）がすでに存在します。パラメトリックキャンペーンの場合は、パラメータ値も同じです。システムは、二重通知を回避するためにリクエストをキャンセルしました。                                                                                                                                                |
| キャンセル済み | Collector に非対応 | 互換性のない機能を含むキャンペーンが Nexthink Collector の対象に指定された場合、Nexthink Collector によりこの状態が設定されます。                                                                                                                                                                                                |
| 退役      | 該当なし           | <p>キャンペーンは終了しており、回答が最終状態（回答済み、辞退、またはキャンセル済み）ではありませんでした。</p><p>この状態にはバリエーションがないため、その場合、状態の詳細フィールドは該当しません。</p>                                                                                                                                                                        |
| 不明      | 該当なし           | キャンペーンの対象に従業員が指定されていなかったか、従業員のデバイスとの通信に問題がある、またはデバイスの電源がオフであるため、従業員は通知を受け取りませんでした。その状態にはバリエーションがないため、この場合、状態の詳細フィールドは該当しません。                                                                                                                                                        |

***

関連トピック

* [特定のキャンペーン回答のモニタリング](/platform/ja/user-guide/campaigns/working-with-campaigns/monitoring-specific-campaign-responses.md)
* [キャンペーンの NQL 例](/platform/ja/user-guide/campaigns/campaigns-nql-capabilities/campaigns-nql-examples.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nexthink.com/platform/ja/user-guide/campaigns/campaigns-nql-capabilities/scrutinizing-the-results-of-a-campaign-with-nql.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
