> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 最も感受性の高いユーザー

> /v1 のシミュレーション結果とエンティティから、以前のプロバイダーによる過去 12 か月の最も感受性の高いユーザーの集計を再現します。

このレポートは、ユーザー単位の過去 12 か月の感受性の集計です。直近 1 年間に少なくとも 1 件のシミュレーションを受信した人ごとに 1 行で構成され、クリック数、認証情報送信数、報告数とそれぞれの割合、現在のクリック連続回数、および直近 5 件の成果を連結したリストが含まれます。

対象期間は 365 日間ではなく、**12 暦月**(12 か月前の同じ日の UTC 午前 0 時から)です。

<Note>
  自動スキャナー / ボットによる操作は、クリック数と認証情報送信数から除外されます。これは従来のエクスポートとは意図的に異なる点です。
  [従来のエクスポートとの相違点](#%E5%BE%93%E6%9D%A5%E3%81%AE%E3%82%A8%E3%82%AF%E3%82%B9%E3%83%9D%E3%83%BC%E3%83%88%E3%81%A8%E3%81%AE%E7%9B%B8%E9%81%95%E7%82%B9)を参照してください。
</Note>

セットアップ、認証情報、ページネーション、レート制限時の再試行は、[Power BI / Excel 接続ガイド](/ja/developers/v1/powerbi)と同じです。まず共通の `Fn_FetchAll` クエリを追加してください。このレポートは、そのクエリを名前で呼び出します。

## 必要なキーのスコープ

| スコープ | 用途 |
| - | - |
| `simulation:read` | `GET /v1/simulation_results` |
| `entity:read` | `GET /v1/entities`(メールアドレスと表示名の結合) |

このレポートでは、レポート用プレビューファミリーではなく、**オペレーショナル**なユーザー別結果リストを使用します。`reporting:read` のみが付与されたキーでは `GET /v1/simulation_results` を呼び出せません(API は `403` を返します)。[適切な粒度の選択](/ja/developers/v1/powerbi#%E9%81%A9%E5%88%87%E3%81%AA%E7%B2%92%E5%BA%A6%E3%81%AE%E9%81%B8%E6%8A%9E)を参照してください。

## ソースエンドポイント

| エンドポイント | 役割 |
| - | - |
| `GET /v1/simulation_results` | 受信者ごとの成果です。これがファクトの粒度です。 |
| `GET /v1/entities` | `entity` をメールアドレス / 表示名に解決します。結果の行自体には、受信者のメールアドレスも表示名もありません(`entity` のみ)。 |

結果リストで許可リストに登録されているフィルターは、`limit`、`page_token`、`simulation`、`entity` です。このリストには `delivered_after` / `start_date` がないため、過去 12 か月の絞り込みは、全件の走査後に Power Query で適用されます。

各結果で使用するフィールド: `id`、`simulation`、`entity`、`status`、`targeted_at`、`delivered_at`、`bounced_at`、`opened_at`、`clicked_at`、`attachment_opened_at`、`credential_submitted_at`、`reported_at`、`reported_before_interaction`、`bot_activity_detected`、`email_subject`、`sender_email`、`difficulty_level`、`created_at`、`updated_at`。

### 粒度

過去 12 暦月に `delivered_at` を持つ結果が少なくとも 1 件あるエンティティごとに 1 行です。対象になっていても一度も配信されなかった人は表示されません。同一人物に対する複数のシミュレーションは、ここで 1 行に集約されます。

リクエストの予算: 組織内のすべてのシミュレーション結果のページネーション付き走査 1 回と、エンティティの走査 1 回です。必ず `limit = "500"` を設定してください。

## 成果の優先順位(`last_5_assessments`)

配信された直近 5 件の結果(`delivered_at` の降順)は、それぞれ `YYYY-MM-DD: <outcome>` として要約されます。一致した最初のタイムスタンプが採用され、優先度の高いものから順に評価されます。

| 優先度 | タイムスタンプ | 成果ラベル |
| - | - | - |
| 1 | `credential_submitted_at` | `credential submitted` |
| 2 | `clicked_at` | `clicked` |
| 3 | `attachment_opened_at` | `attachment opened` |
| 4 | `reported_at` | `reported` |
| 5 | `opened_at` | `opened` |
| 6 | `delivered_at` | `no action` |
| 7 | `bounced_at` | `bounced` |

配信のみの場合は `no action` です(メッセージは届いたものの、本人は何も操作しなかった状態)。クリックしたうえで後から報告した人は `clicked` となります。このリストでは、報告はリスクのある操作よりも優先されません。ボットと判定された行にも、存在するタイムスタンプに基づいて成果ラベルが付与されますが、クリック数や認証情報送信数には加算されません。

**現在のクリック連続回数:** 同じ配信済みの結果を新しい順にたどり、`clicked_at` が null でなく、**かつ** `bot_activity_detected` が `true` でない行が連続している数を数えます。最初に条件を満たさない行で停止します。

## 列のマッピング

従来の列名は、以前のプロバイダーのエクスポートに基づいています。`/v1` のフィールドは公開 API の名前であり、件数と割合はクエリによって算出されます。

| 従来の列 | `/v1` のフィールドまたは算出方法 | レポートの列 |
| - | - | - |
| Email | `Entity.email`(`Result.entity` で結合) | `email` |
| Full name | `Entity.display_name` | `full_name` |
| Total simulations received | `delivered_at` が null でない結果の件数(ボットと判定された行を含む) | `total_received` |
| Clicks # | `clicked_at` が null でなく、**かつ** `bot_activity_detected` ≠ `true` の件数 | `clicks` |
| Clicks % | `clicks / total_received` | `click_pct` |
| Credential submissions # | `credential_submitted_at` が null でなく、**かつ** `bot_activity_detected` ≠ `true` の件数 | `credential_submissions` |
| Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` |
| Reported # | `reported_at` が null でない結果の件数(ボットを含む。クリック/認証情報送信ではありません) | `reported` |
| Reported % | `reported / total_received` | `reported_pct` |
| Current click streak | 配信された結果を新しい順にたどり、連続してクリックした件数(ボットで途切れます) | `current_click_streak` |
| Last 5 assessments | 配信された直近 5 件の成果を `"; "` で区切ったもの([優先順位](#成果の優先順位-last_5_assessments)を参照) | `last_5_assessments` |
| Directory extras (department, …) | `/v1` には含まれません | 省略(null にはしません) |

スタースキーマモデル用に保持される結合キー: `entity_id`。

## 従来のエクスポートとの相違点

* **ボットの操作は、クリック数と認証情報送信数から除外されます。** 以前のプロバイダーのエクスポートでは、自動スキャナー / ボットによる操作がクリックおよび認証情報送信として数えられていました。このクエリでは数えません。`bot_activity_detected = true` の結果も配信済みのシミュレーションであることに変わりはなく、`total_received` や報告の集計には含まれますが、クリックではなく、送信でもないものとして扱われます。つまり、`clicks` / `credential_submissions` からは除外され、現在のクリック連続回数は途切れます。従来のエクスポートに合わせるためにボットを数えるような「修正」は行わないでください。
* **`last_5_assessments` では、報告はクリックより優先されません。** クリックしたうえで後から報告した人には `clicked` というラベルが付きます。
* **ディレクトリの追加情報は、null ではなく省略されます。** 部署などのフィールドは `/v1` に含まれません。
* **サーバー側の時間フィルターはありません。** `GET /v1/simulation_results` には `delivered_after` がありません。このクエリはすべての結果を走査したうえで、過去 12 暦月内の `delivered_at` を残します。過去のデータが大量にある組織では、フィルター付きのリストを使用する場合と比べて、キーごとのレート制限の予算をより多く消費する可能性があります。

## 次のステップ

<CardGroup cols={2}>
  <Card title="Power BI と Excel のセットアップ" href="/ja/developers/v1/powerbi">
    認証情報、ページネーション、および Power BI や Excel でのこれらのクエリの読み込み方法。
  </Card>

  <Card title="メールフィッシングログ" href="/ja/developers/v1/reports/email-phishing-log">
    過去 12 か月のフィッシング操作をイベント単位で記録したものです。
  </Card>

  <Card title="ユーザー別コンプライアンス" href="/ja/developers/v1/reports/per-person-compliance">
    ユーザー × 割り当ての粒度での、トレーニングの受講登録です。
  </Card>

  <Card title="API キー" href="/ja/developers/developer-hub/api-keys">
    このレポートを更新するキーに `simulation:read` と `entity:read` を付与します。
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.