コンテンツにスキップ

トラブルシューティング

init が TypeError: crypto.randomUUID is not a function を投げる

原因: ページがセキュアコンテキストでない(localhost 以外のホストから平文の HTTP で配信されている)、 またはブラウザーが最低バージョンより古い。ブラウザーは crypto.randomUUID() を セキュアなページでのみ提供し、SDK はセッションを開始するためにそれを必要とします。

解決策: ページを HTTPS で、または開発中は localhost から配信します。SDK がサポートしないブラウザー でもページを動作させ続けるには、init を try ブロック内で呼びます。

getClassification() が常に 'insufficient' を返す

原因: 次のいずれかです。

  1. セッションのアクションがモデルの求める数より少ない。組み込みモデルでは、デスクトップブラウザーで 20 個(ポインター、スクロール、キーボードのうち少なくとも 2 種類の入力から、それぞれ 3 個以上)、 スマートフォンやタブレットのブラウザーで 8 個が必要です。 証拠を参照してください。クリックしかしないユーザーは 1 種類の入力しか与えません。デスクトップでは、スクロールや入力もするまで結果は 'insufficient' のままです。
  2. 取得が一時停止され、再開されていない。
  3. 同意ゲートがオン(requireConsent: true)で、setConsent(true) が呼ばれていない。
  4. スコアリングエンジンの読み込みに失敗した。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 を返す

原因: 次のいずれかです。

  1. appKey のない本番の appId。SDK は要求を送りません。
  2. DEA がキーの登録を拒否した。たとえば appKey がこの appId と一緒に発行されたキーではない。
  3. 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 に解決する

原因: 次のいずれかです。

  1. 分類がまだ 'insufficient' である。そうでなくなるまで証明は署名されず、インプレッションは記録 されません。ユーザーが操作する前のページ読み込み時に表示された広告はこのケースです。
  2. appKey がない、またはブラウザーのキーがない。
  3. DEA に登録されていないブラウザーのキー。
  4. DEA に到達できなかった。

解決策: 原因 1 については、広告セッションを開く前に getClassification().result を確認し、 'insufficient' でなくなった時点で、広告がまだ画面にある間に開いてください。それ以外の場合は、広告 セッションを開く前に attest() を呼び、'passed' が返ることを確認してください。どの原因だったかを知る には、呼び出しの前後で ads.counts を比較します。 広告セッションが開かなかった理由を調べるを 参照してください。

ad.click() が false を返す

原因: 次のいずれかです。

  1. end() がすでに呼ばれている、またはこの広告セッションでクリックがすでに受理されている。
  2. session_opened() に要素を渡していて、クリックの前にその内側でプレスもリリースも起きていない。

解決策: 原因 2 については、session_opened() に渡す要素が広告の描画先であり、表示されていてサイズが ゼロでないことを確認してください。iframe 内のプレスは SDK に届きません。iframe に描画される クリエイティブでは、要素なしでセッションを開いてください。取得が一時停止中、またはユーザーの同意前に 行われたプレスも見えません。

コンソールに何も表示されない

原因: 本番パッケージにはログがありません。

解決策: 統合中はステージングパッケージをインストールしてください。 セットアップの確認を参照してください。INFO、WARN、ERROR のエントリを ログに出力します。