DEA SDK¶
DEA SDK は、セッションが実在の人物によるものかどうかをアプリに伝えます。ユーザーがアプリをどのように操作するか (タッチ、ポインターの動き、スクロール、端末の動き)を観測し、セッションを端末上でスコアリングします。 アプリは、判断を下す瞬間(サインアップ、チェックアウト、報酬の受け取り、広告の表示)に結果を読み取ります。
プラットフォームを選ぶ¶
| プラットフォーム | パッケージ | 0.26.0 のインストール | ガイド |
|---|---|---|---|
| Web | @dea/sdk |
DEA のリリース URL から | DEA SDK for Web |
| Flutter | dea_sdk |
DEA のリリース URL から | DEA SDK for Flutter |
| Android | ai.dea:dea-sdk |
DEA の Maven リポジトリから | DEA SDK for Android |
| iOS | DeaSDK |
DEA のリリース URL から | DEA SDK for iOS |
| React Native | @dea/react-native |
DEA のリリース URL から | DEA SDK for React Native |
各ガイドの「Install」セクションに、公開されているものが正確に書かれています。プラットフォームごとのその他の違いは 本番環境への移行にあります。
始める前に¶
アプリごとに appId と appKey が必要です。DEA が発行します。
アカウントとキーを参照してください。
仕組み¶
- アプリの起動時に SDK を一度だけ初期化します。
- SDK がバックグラウンドで操作を取得します。ラップや登録は不要です。
- ユーザーが操作するにつれて、SDK が端末上でセッションをスコアリングします。
- アプリは必要なときに
getClassification()で分類を読み取ります。結果はhuman、bot、undetermined、または証拠がまだ足りない間はinsufficientです。読み取りはローカルで完結し、 ネットワーク要求は発生しません。
各ステップの詳細はスコアリングの仕組みで説明しています。
ユースケース¶
すべてのプラットフォームガイドは同じメニューなので、プラットフォームを切り替えても同じページにたどり着けます。
| セクション | 内容 | ページ |
|---|---|---|
| ヒューマンスコアリング | 判断ポイントで、セッションが実在の人物によるものかを読み取る。端末の署名キーを DEA に登録する | 概要、ユーザー同意、機密性の高い画面、カスタムイベント、セッション、アテステーション |
| 広告 | 広告のインプレッションとクリックに、実在の人物であることの署名付き証明を添付する。ゲームのラウンド、クイズ、レッスン、動画ごとにヒューマンスコアを記録する | 広告を組み込む、アクティビティ |
| AI データタスク | ユーザーに短い AI データタスクを表示し、その回答を署名付き証明とともに送る | タスクを組み込む |
| テストとステージングのパッケージ | ステージングとテストのパッケージで、DEA のためにデータを収集し、SDK のログと取得した入力を受け取る | データ収集、テレメトリ |
| リファレンス | すべての公開メンバーと、問題が起きたときの対処 | API リファレンス、トラブルシューティング |
概念¶
以下のページはすべてのプラットフォームに共通です。
| ページ | 内容 |
|---|---|
| スコアリングの仕組み | アクション、証拠、モデル、そのしきい値、分類 |
| アカウントとキー | appId と appKey とは何か、どう取得するか |
| アプリのユーザー ID | アプリの各ユーザーに送る ID と、その渡し方 |
| プライバシーとネットワーク | SDK が取得・保存・送信するものと、その保存先・送信先 |
| 本番環境への移行 | 各プラットフォームで利用できるものと、リリース前のチェックリスト |
| 用語集 | ガイドで使う用語: アクション、証明、ティア、アテステーション、広告セッション |