自動スキャナー / ボットによる操作は、クリック数と認証情報送信数から除外されます。これは従来のエクスポートとは意図的に異なる点です。
従来のエクスポートとの相違点を参照してください。
Fn_FetchAll クエリを追加してください。このレポートは、そのクエリを名前で呼び出します。
必要なキーのスコープ
このレポートでは、レポート用プレビューファミリーではなく、オペレーショナルなユーザー別結果リストを使用します。
reporting:read のみが付与されたキーでは GET /v1/simulation_results を呼び出せません(API は 403 を返します)。適切な粒度の選択を参照してください。
ソースエンドポイント
結果リストで許可リストに登録されているフィルターは、
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> として要約されます。一致した最初のタイムスタンプが採用され、優先度の高いものから順に評価されます。
配信のみの場合は
no action です(メッセージは届いたものの、本人は何も操作しなかった状態)。クリックしたうえで後から報告した人は clicked となります。このリストでは、報告はリスクのある操作よりも優先されません。ボットと判定された行にも、存在するタイムスタンプに基づいて成果ラベルが付与されますが、クリック数や認証情報送信数には加算されません。
現在のクリック連続回数: 同じ配信済みの結果を新しい順にたどり、clicked_at が null でなく、かつ bot_activity_detected が true でない行が連続している数を数えます。最初に条件を満たさない行で停止します。
列のマッピング
従来の列名は、以前のプロバイダーのエクスポートに基づいています。/v1 のフィールドは公開 API の名前であり、件数と割合はクエリによって算出されます。
スタースキーマモデル用に保持される結合キー:
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を残します。過去のデータが大量にある組織では、フィルター付きのリストを使用する場合と比べて、キーごとのレート制限の予算をより多く消費する可能性があります。
次のステップ
Power BI と Excel のセットアップ
認証情報、ページネーション、および Power BI や Excel でのこれらのクエリの読み込み方法。
メールフィッシングログ
過去 12 か月のフィッシング操作をイベント単位で記録したものです。
ユーザー別コンプライアンス
ユーザー × 割り当ての粒度での、トレーニングの受講登録です。
API キー
このレポートを更新するキーに
simulation:read と entity:read を付与します。