スコアリングの仕組み¶
DEA SDK は、セッションが実在の人物によるものかどうかを端末上で判断します。すべてのプラットフォームガイドは、 セッション、アクション、証拠、モデル、分類という同じ少数の考え方に基づいています。このページではそれらを 一度にまとめて説明します。
取得¶
init の時点から、SDK はアプリがすでに受け取っている入力を監視します。ラップや登録は不要です。タッチ、
ポインターの動き、押下と解放、スクロール、そしてプラットフォームが報告する場合はキー押下と端末の動きを
取得します。各プラットフォームが何を取得し、何を決して読み取らないかは
プライバシーとネットワークにあります。
取得は、一時停止するか、セッションを終了するか、SDK を破棄するまで続きます。特定の画面を取得から外すには、 各プラットフォームの「機密性の高い画面」ページを参照してください。
アクション¶
SDK は生の入力をアクションにまとめます。タップ、ドラッグ、スクロール、連続したキー押下などです。 スコアリングは個々のイベントではなくアクションを読み取り、直近の 64 件を保持します。古いアクションは 順に外れていくため、スコアは 1 時間前ではなく今ユーザーがどう操作しているかを表します。スマートフォンや タブレットでは、アプリが 5 分を超えてバックグラウンドにとどまると、復帰時に証拠をゼロから集め直します。
証拠¶
スコアが意味を持つのは、十分な数のアクションがその裏にあるときだけです。本ガイドではこの状態を 十分と呼びます。
| 場所 | 十分とみなす条件 |
|---|---|
| スマートフォン、タブレット、およびそれらのブラウザー | セッションに、読み込まれたモデルが求める数以上のアクションがある。SDK 組み込みのモデルでは 8 件 |
| デスクトップおよびノート PC のブラウザー | セッションに、読み込まれたモデルが求める数以上のアクション(組み込みモデルでは 20 件)があり、それらが 2 種類以上の入力(ポインター、スクロール、キーボード)から、各 3 件以上集まっている |
DEA が後から公開するモデルは、別の数を求めることがあります。分類の actions フィールドは、スコアの裏に
現在いくつのアクションがあるかを示します。
それまでの間、分類は Flutter、Android、iOS、React Native では insufficient でスコアなし(value は
null)、Web では undetermined で sufficient が false になります。いずれの場合も、SDK はその
セッションの証明に署名しません。アプリやページを開いた直後には証拠は決して
十分ではありません。分類は読み込み時ではなく、フォームの送信など、ユーザーが操作を経てたどり着く
判断ポイントで読み取ってください。
モデルとそのしきい値¶
モデルはアクションをスコアに変換します。高いほど人らしいことを意味します。モデルは、スコアと比較する 2 つのしきい値も持っています。
Flutter、Android、iOS、React Native では、SDK は次の規則をこの順に適用して答えます。
| 結果 | 条件 |
|---|---|
insufficient |
SDK がまだ読み込み中か、セッションにまだ十分なアクションがない。value は null |
human |
スコアが human しきい値以上 |
bot |
スコアが bot しきい値未満 |
human |
モデルが human しきい値を設定していない場合、bot しきい値が唯一の基準になる |
undetermined |
スコアが 2 つのしきい値の間にある |
しきい値は読み込まれたモデルだけが決めます。アプリの設定でこれを変えることはできません。bot しきい値を
持たないモデルは分類できず、getClassification() は推測する代わりに ThresholdMissing を報告します。
各パッケージはモデルを組み込んでいます。SDK は DEA が公開する新しいモデルをダウンロードすることもできます。
ダウンロード元は DEA のリリースホストのみ、対象は手元のものより新しいバージョンのみ、そしてファイルの
整合性を確認した後に限られます。ダウンロードしたモデルは組み込みのモデルを置き換え、セッションの途中で
置き換わることもあります。分類は、由来するモデルを modelVersion で示します。どのプラットフォームが
モデルを更新するか、各組み込みモデルが判断に使える状態かは、
本番環境への移行にあります。
分類の読み取り¶
getClassification() は 1 つのスナップショットを返します。
| フィールド | 意味 |
|---|---|
result |
human、bot、undetermined、または insufficient(Web では最初の 3 つ) |
value |
スコア。結果が insufficient の間は null |
sufficient |
Web のみ。スコアの裏に十分な証拠があるかどうか |
actions |
スコアの基になっているアクションの数 |
botThreshold、humanThreshold |
読み込まれたモデルのしきい値 |
modelVersion |
スコアを生成したモデルのバージョン |
読み取りはローカルで完結し、ネットワーク要求は発生しません。スコアはユーザーの操作に応じて常に最新に
保たれています。各結果で何を許可するかはアプリが決めます。undetermined には bot として扱うのではなく
チャレンジなどの代替経路を用意し、insufficient は「まだ早い」とみなして、決して bot として扱わないで
ください。
セッション¶
セッションは init で始まり、リセットするか SDK を破棄するまで続きます。ログアウトやアカウント切り替えなど、
アプリを使う人が変わるときにリセットしてください。ある人の証拠が別の人のものとして数えられないように
するためです。リセットはアクションとスコアを消去し、ダウンロードしたモデルは保持します。各プラットフォームの
「セッション」ページを参照してください。
証明¶
分類は端末上にとどまります。判断をサーバーで検証する必要がある場合、SDK は端末が保持するキーでスコアの
証明に署名し、DEA に送ることができます。アテステーションはそのキーを登録し、広告は広告インプレッションに
証明を添付します。これらの要求が何を運ぶかはプライバシーとネットワークに、
それらを送る際の appId と appKey はアカウントとキーにあります。