用語集¶
プラットフォームガイドで使う用語を、英語のアルファベット順に示します。スコアリングの仕組み では、スコアリングに関する用語をまとめて説明しています。
アクション(Action)¶
SDK が生の入力の中から認識する 1 つのジェスチャー。タップ、ドラッグ、スクロール、連続したキー押下などです。 スコアは個々のタッチイベントやキーイベントではなくアクションから計算され、直近の 64 件だけが使われます。
アクティビティ(Activity)¶
ゲームの 1 ラウンド、クイズ、レッスン、動画など、ユーザーがアプリで行う区切りのある 1 つの行動で、アプリが 広告モジュールで記録するもの。広告ユニットの代わりにアクティビティ ID を渡します。DEA はアクティビティごとに 1 件の記録を保持し、開始時と終了時のヒューマンスコアを残します。各プラットフォームの「アクティビティ」 ページを参照してください(例: Web)。
広告セッション(Ad session)¶
DEA が持つ 1 つの広告の記録。セッションと混同しないでください。広告が画面に表示されたときに
アプリが送る証明によって開かれ、DEA はその ID を返します。その広告のクリックと終了は同じ ID の下に
記録されます。Web では SDK が管理します(ads.session_opened())。Flutter、Android、iOS、React Native
ではアプリが 3 つの証明を自分で送ります。アクティビティも同じ方法で記録します。各プラット
フォームの「広告」ページを参照してください。
アプリのユーザー ID(App user id)¶
アプリが 1 人のユーザーに付ける ID。DEA はこれを記録に保存し、アプリのユーザーごとに数えられるように
します。AI データタスクでは publisherUserId(必須)、広告では appScopedUid(任意)です。本人を特定
できる値は使えません。アプリのユーザー ID を参照してください。
アテステーション(Attestation)¶
attest() を通じて端末キーを DEA に登録すること。Android と iOS では、端末が生成できる
場合、登録に Google Play Integrity または Apple App Attest のトークンが添えられます。ブラウザーには
そのようなトークンはありません。登録はおよそ 1 時間で期限が切れ、再登録されます。Android、iOS、Flutter
では自動的に、Web では次の attest() 呼び出し時に行われます。その結果が検証結果です。
分類(Classification)¶
getClassification() が返すもの。result(human、bot、undetermined、または insufficient)と、
スコア、スコアリングされたアクションの数、しきい値、モデルの
バージョンを含みます。端末上で読み取られ、要求は発生しません。
端末キー(Device key)¶
SDK が最初に必要になったときに端末上で生成し、端末の外に決して出ない署名キー。Android Keystore、iOS の Keychain または Secure Enclave、あるいはブラウザーでは抽出不可のキーとして保持されます。 アテステーションはその公開側を DEA に登録し、証明はこのキーで署名されます。
モデル(Model)¶
スコアリングエンジンがアクションをスコアに変換するために使うファイル。しきい値
と、スコアに必要なアクション数も持っています。各パッケージは 1 つを組み込んでおり、SDK は DEA が公開する
新しいものに置き換えることができます。使用中のモデルは modelVersion で示されます。
証明(Proof)¶
SDK が端末キーで署名して DEA に送る、またはアプリに渡す短いメッセージ。現在のスコア、 スコアリングされたアクション数、モデルバージョン、セッション ID、対象のイベント、ティアを 含みます。DEA は登録されたキーで署名を検証し、そのキーからアプリを取得します。証明は 90 秒間有効です。
スコアリングされたアクション(Scored actions)¶
分類の actions フィールド。スコアがいくつのアクションから計算されたかを示します。ユーザーの
操作に応じて最大 64 まで増えます。
スコアリングエンジン(Scoring engine)¶
取得した入力をアクションに、アクションをスコアに変換する SDK の部分。端末上で動作します。エラーメッセージ やログではコア(core)と呼ばれます。読み込めない場合、SDK はスコアなしで動作を続けます。各プラットフォームの 「トラブルシューティング」ページを参照してください。
セッション(Session)¶
スコアが表す期間。init で始まり、リセットするか SDK を破棄したときに終わります。スマートフォンと
タブレットでは、アプリが 5 分を超えてバックグラウンドにいた後に復帰したときにも終わります。
広告セッションと混同しないでください。
十分(Sufficient)¶
スコアが意味を持つのに十分なアクションがその裏にあるかどうか。SDK に組み込まれたモデルは、
スマートフォンとタブレットでは 8 件、デスクトップブラウザーでは 2 種類以上の入力(ポインター、スクロール、
キーボード)から各 3 件以上の計 20 件を求めます。DEA が後から公開するモデルは別の数を求めることがあります。
スコアが十分になるまで、分類は Flutter、Android、iOS、React Native ではスコアなしの insufficient
(Web では undetermined)となり、証明は署名されません。
しきい値(Threshold)¶
モデルが基準として設定するスコア。bot しきい値未満は bot、human しきい値以上は human、
その間は undetermined です。human しきい値を持たないモデルでは基準が 1 つになり、bot しきい値以上が
human です。スコアリングの仕組みを参照してください。
ティア(Tier)¶
証明が、署名したキーについて主張する信頼レベル。B は登録に Google Play Integrity または
Apple App Attest のトークンが添えられたスマートフォンまたはタブレットのキー、C はトークンのない
スマートフォンまたはタブレットのキー、W はブラウザーキーです。
検証結果(Verdict)¶
アテステーションの結果。passed、failed、または unsupported です。分類ではありません。
本ガイドでは human / bot / undetermined / insufficient の答えを分類と呼びます。