トラブルシューティング¶
init が TypeError: crypto.randomUUID is not a function を投げる¶
原因: ページがセキュアコンテキストでない(localhost 以外のホストから平文の HTTP で配信されている)、
またはブラウザーが最低バージョンより古い。ブラウザーは crypto.randomUUID() を
セキュアなページでのみ提供し、SDK はセッションを開始するためにそれを必要とします。
解決策: ページを HTTPS で、または開発中は localhost から配信します。SDK がサポートしないブラウザー
でもページを動作させ続けるには、init を try ブロック内で呼びます。
getClassification() が常に 'insufficient' を返す¶
原因: 次のいずれかです。
- セッションのアクションがモデルの求める数より少ない。組み込みモデルでは、デスクトップブラウザーで
20 個(ポインター、スクロール、キーボードのうち少なくとも 2 種類の入力から、それぞれ 3 個以上)、
スマートフォンやタブレットのブラウザーで 8 個が必要です。
証拠を参照してください。クリックしかしないユーザーは
1 種類の入力しか与えません。デスクトップでは、スクロールや入力もするまで結果は
'insufficient'のままです。 - 取得が一時停止され、再開されていない。
- 同意ゲートがオン(
requireConsent: true)で、setConsent(true)が呼ばれていない。 - スコアリングエンジンの読み込みに失敗した。
dea.errorが設定されています。
解決策: 順に確認します。
import { DeaSdk } from '@dea/sdk';
const dea = DeaSdk.current!;
console.log(dea.consent.decision); // 'granted' is needed when requireConsent is on
await dea.ready(); // waits for consent when requireConsent is on
console.log(dea.error); // not null: the engine failed to load — see below
console.log(dea.getClassification()); // result, value, actions and both thresholds
すべての pause() に対応する resume() があることを確認してください。
getClassification() が常に 'undetermined' を返す¶
原因: アクションは十分にあり、スコアが botThreshold と humanThreshold の間にあります。
humanThreshold を設定しないモデルにはこの帯域はなく、スコアは 'bot' か 'human' のどちらかになります。
解決策: これはこのユーザーに対するモデルの答えであり、不具合ではありません。チャレンジや手動レビュー などのフォールバックを取ってください。
getClassification() が ThresholdMissing を投げる¶
原因: 読み込まれたモデルにボットのしきい値がありません。そのバージョンはエラーの modelVersion に
あります。
解決策: 分類を読み取る場所でエラーを捕捉し、'undetermined' と同様にフォールバックを取ってください。
modelVersion を DEA に報告してください。モデルは DEA から来るもので、アプリの設定ではありません。
import { DeaSdk, ThresholdMissing, type ClassificationResult } from '@dea/sdk';
function readResult(): ClassificationResult {
try {
return DeaSdk.current?.getClassification().result ?? 'insufficient';
} catch (error) {
if (error instanceof ThresholdMissing) return 'undetermined';
throw error;
}
}
ready() の後に dea.error が設定されている¶
原因: SDK の WebAssembly スコアリングエンジンを読み込めませんでした。dea.error は CoreLoadError
で、その reason が理由を示します。
reason |
原因 |
|---|---|
'core_not_loaded' |
エンジンを取得またはコンパイルできなかった。通常は Content Security Policy がブロックしているか、coreUrl が取得できないファイルを指している |
'core_abi_mismatch' |
coreUrl が、このパッケージでは読めないリリースのエンジンを指している |
'core_wrong_profile' |
coreUrl が別のプロファイル(デスクトップまたはモバイル)のエンジンを指している |
解決策: ブロックされた要求や不一致を示す dea.error.message と、Content Security Policy 違反を報告
するブラウザーのコンソールを読んでください。
- CSP によるブロック:
connect-srcでdata:(または設定したcoreUrl)を、script-srcで'wasm-unsafe-eval'を許可します。Content Security Policy を 参照してください。 - 404 または不一致:
coreUrlを確認するか、削除してパッケージに 埋め込まれたエンジンを使います。
ステージングパッケージはこれを同じ reason を持つ sdk.core_failed としてもログに出力します。
init のオプションが無視される¶
原因: init はすでに呼ばれています。後の呼び出しは実行中のインスタンスを返し、そのオプションを
無視します。
解決策: init はできるだけ早く一度だけ呼びます。本当に別のオプションが必要な場合は、先に
DeaSdk.current?.dispose() を呼びます。
attest() が unsupported を返す¶
原因: ブラウザーが署名キーを作成できませんでした。IndexedDB を拒否している(プライベート ブラウジングでよくある)、または Web Crypto がありません。
解決策: このようなブラウザーでは、ページ側でキーを作成する手段はありません。スコアリングは引き続き 動作します。利用できないのはアテステーションと広告の証明のみです。
attest() が failed を返す¶
原因: 次のいずれかです。
appKeyのない本番のappId。SDK は要求を送りません。- DEA がキーの登録を拒否した。たとえば
appKeyがこのappIdと一緒に発行されたキーではない。 - DEA に到達できなかった。ネットワークがない、または Content Security Policy が
https://poh-api.dep-protocol.comをブロックしている。
解決策: DeaSdk.current?.appKey が DEA から appId と一緒に発行されたキーであることを確認し
(アカウントとキーを参照)、
Content Security Policy で DEA を許可してください。ステージング
パッケージは拒否を app_key_invalid や app_key_missing などの reason を持つ attest.failed として
ログに出力します。失敗した結果はキャッシュされないため、再試行するには attest() を再度呼びます。
ads.session_opened() が null に解決する¶
原因: 次のいずれかです。
- 分類がまだ
'insufficient'である。そうでなくなるまで証明は署名されず、インプレッションは記録 されません。ユーザーが操作する前のページ読み込み時に表示された広告はこのケースです。 appKeyがない、またはブラウザーのキーがない。- DEA に登録されていないブラウザーのキー。
- DEA に到達できなかった。
解決策: 原因 1 については、広告セッションを開く前に getClassification().result を確認し、
'insufficient' でなくなった時点で、広告がまだ画面にある間に開いてください。それ以外の場合は、広告
セッションを開く前に attest() を呼び、'passed' が返ることを確認してください。どの原因だったかを知る
には、呼び出しの前後で ads.counts を比較します。
広告セッションが開かなかった理由を調べるを
参照してください。
ad.click() が false を返す¶
原因: 次のいずれかです。
end()がすでに呼ばれている、またはこの広告セッションでクリックがすでに受理されている。session_opened()に要素を渡していて、クリックの前にその内側でプレスもリリースも起きていない。
解決策: 原因 2 については、session_opened() に渡す要素が広告の描画先であり、表示されていてサイズが
ゼロでないことを確認してください。iframe 内のプレスは SDK に届きません。iframe に描画される
クリエイティブでは、要素なしでセッションを開いてください。取得が一時停止中、またはユーザーの同意前に
行われたプレスも見えません。
コンソールに何も表示されない¶
原因: 本番パッケージにはログがありません。
解決策: 統合中はステージングパッケージをインストールしてください。
セットアップの確認を参照してください。INFO、WARN、ERROR のエントリを
ログに出力します。