ヒューマンスコアリング¶
アプリが判断を下す瞬間に、現在のセッションが実在の人物によるものかどうかを読み取ります。SDK はユーザーの操作に 応じて端末上でスコアを常に最新に保つため、読み取りは高速で、ネットワークを呼び出すことはありません。
このユースケースの内容¶
| ページ | 内容 |
|---|---|
| ヒューマンスコアリング(このページ) | 判断ポイントで分類を読み取り、ビューに名前を付ける |
| ユーザー同意 | 何かを記録する前にユーザーに許可を求める |
| 機密性の高い画面 | パスワードや決済のフィールドが画面にある間、取得を一時停止する |
| カスタムイベント | アプリ内の出来事をセッションのタイムライン上に記録する |
| セッション | ログアウトやアカウント切り替え時に新しいセッションを開始する |
使いどころ¶
- アカウント作成、フォーム送信、プロモーションの利用の前
- ボットに悪用されがちなステップの前: 投稿、投票、カートへの追加、報酬の受け取り
- 自分のフローのどちらの分岐を進むかを決めるとき。ユーザーを通すか、チャレンジを追加するか
前提条件¶
- SDK がインストールされ、初期化されている。クイックスタートを参照してください。
- ユーザーが同意している。同意がなければ何も記録されず、分類は
insufficientのままです。 ユーザー同意を参照してください。 - ユーザーがアプリを操作している。セッションがモデルの要求する
数のアクション(組み込みモデルでは 8)に達するまでは
十分ではなく、結果は
insufficientです。起動直後は アクションがひとつもありません。証拠を参照してください。
使い方¶
分類を読み取る¶
import * as Dea from '@dea/react-native';
const {result} = await Dea.getClassification();
switch (result) {
case 'human':
// Allow the action.
break;
case 'bot':
// Block it, or take your strictest fallback.
break;
case 'undetermined':
// A score between the thresholds. Your app decides.
break;
case 'insufficient':
// Not enough evidence yet: too early to tell, not a bot. Your app decides.
break;
}
getClassification() はスコアと、読み込まれたモデルの 2 つのしきい値を 1 回のスナップショットで読み取り、
ユーザーが直前に行ったタッチも含めます。
result |
条件 |
|---|---|
'insufficient' |
証拠がまだ足りない、またはスコアリングが利用できない。value は null |
'human' |
スコアがモデルの human しきい値以上 |
'bot' |
スコアがモデルの bot しきい値未満 |
'undetermined' |
スコアが bot しきい値以上かつ human しきい値未満 |
しきい値は読み込まれたモデルのみに由来します。アプリ側で設定するしきい値はありません。modelVersion は
しきい値の由来となるモデルを示し、0 は SDK に組み込まれたモデルです。human しきい値を設定していないモデルは
基準がひとつだけで、bot しきい値以上のスコアは 'human' です。
スコアリングの仕組みを参照してください。
「証拠がまだ足りない」と不確かなスコアを区別する¶
import * as Dea from '@dea/react-native';
const c = await Dea.getClassification();
if (c.result === 'insufficient') {
// Fewer actions than the model asks for (8 with the built-in model). Let them keep going,
// or ask again later.
console.log(`scored on ${c.actions} actions so far`);
} else if (c.result === 'undetermined') {
// Enough evidence, and the score is at or above c.botThreshold but below c.humanThreshold.
}
しきい値のないモデルを扱う¶
読み込まれたモデルが bot しきい値を持たない場合、getClassification() はコード threshold_missing で reject
され、error.userInfo.modelVersion がそのモデルを示します。これは分類ではなく、DEA サポートに報告すべき
モデルの問題です。
try {
const {result} = await Dea.getClassification();
} catch (error: any) {
if (error.code === Dea.THRESHOLD_MISSING) {
// Take your fallback path, and report error.userInfo?.modelVersion.
}
}
SDK がスコアリングできるか確認する¶
init はスコアリングが開始したかどうかを返します。
const started = await Dea.init({appId: 'YOUR_APP_ID'});
if (!started.ready) {
console.warn('DEA cannot score:', started.coreFault);
}
ready が false の場合、SDK は取得を続けますがスコアリングはできず、getClassification() は
insufficient のままです。
ビューに名前を付ける¶
SDK は、各タッチがどの種類のコントロール(ボタン、リンク、テキストフィールド、スクロールするリスト)に着地したか
と、その短い名前を記録します。ネイティブアプリではこれが自動的に得られますが、React Native のビューはコードで
生成され、Pressable はプラットフォームにとって押せることが分からない単なるビューです。そのままでは、React
Native アプリのすべてのプレスは背景へのタッチとして読み取られ、分類の基盤となる証拠が弱くなります。
重要なコントロールには deaTarget(name, bucket) で名前を付け、返される props をビューにスプレッドします。
import {Pressable, Text} from 'react-native';
import {deaTarget} from '@dea/react-native';
export function BuyButton({onPress}: {onPress: () => void}) {
return (
<Pressable {...deaTarget('checkout-buy', 'button')} onPress={onPress}>
<Text>Buy now</Text>
</Pressable>
);
}
bucket |
用途 | 設定される accessibilityRole |
|---|---|---|
'button' |
ボタンや、プレスで動作するもの | button |
'link' |
ナビゲーション: リストの行、カード、リンク | link |
'input' |
カスタム入力 | search |
'canvas' |
画像、描画面、ゲームボード | image |
'scroller' |
カスタムのスクロールコンテナ | scrollbar |
| 省略 | ビューに名前だけ付ける | — |
deaTargetはnativeIDとtestIDを名前に、accessibilityRoleを bucket に対応する値に設定します。 ビューがすでに独自のtestIDやaccessibilityRoleを持つ場合は、後にスプレッドされたものが優先されます。- 名前は端末上でハッシュ化されます。コントロールの名前を使い、内容は決して使わないでください。 記事の
見出しやユーザーのメールアドレスではなく、
'story-row'のような名前にします。 - 名前とロールはタッチされたビューから上方向に読み取られるため、名前付きボタン内の
Textはそのボタンとして 数えられます。 TextInputフィールドは props なしで認識され、実際に内容がスクロールするスクロールコンテナ(ScrollView、FlatList)も同様です。buttonやlinkなどのaccessibilityRoleをすでに持つビューは、deaTargetがなくてもそのロールで 分類されます。
注: 本番環境の
appIdでは、プレスがどのように解決されたかを確認する手段を SDK は提供していません。countTargetsとgetTargetTally()は本番アカウントでは 何も集計せず、集計結果は常に空のオブジェクトになります。
例¶
サインアップボタンをゲートする¶
import {useState} from 'react';
import {ActivityIndicator, Pressable, Text} from 'react-native';
import * as Dea from '@dea/react-native';
export function SignUpButton({onSignUp, onChallenge}: {onSignUp: () => void; onChallenge: () => void}) {
const [checking, setChecking] = useState(false);
const onPress = async () => {
setChecking(true);
try {
const {result} = await Dea.getClassification();
if (result === 'human') {
onSignUp();
} else {
onChallenge(); // 'bot', 'undetermined' or 'insufficient': e.g. show a captcha
}
} catch {
onChallenge(); // the SDK was not initialized, or the model has no thresholds
} finally {
setChecking(false);
}
};
return (
<Pressable {...Dea.deaTarget('sign-up', 'button')} onPress={onPress} disabled={checking}>
{checking ? <ActivityIndicator /> : <Text>Create account</Text>}
</Pressable>
);
}
API¶
| メンバー | 戻り値 | 説明 |
|---|---|---|
getClassification() |
Promise<Classification> |
human、bot、undetermined、insufficient のいずれかと、その背後にあるスコア、証拠、モデルのしきい値 |
deaTarget(name, bucket?) |
DeaTargetProps |
ビューに名前を付け、その種類を設定する props |
getTargetTally() |
Promise<Record<number, number>> |
countTargets 有効時の TargetBucket コードごとのプレス数。本番環境の appId では常に空 |
関連¶
- ユーザー同意 — 同意前は何もスコアリングされません
- スコアリングの仕組み
- オプション:
countTargets - API リファレンス