書類のアップロードと読み取りの問題を解決する
書類のアップロードとOCRの問題のほとんどは、画像品質、裏面画像の欠如、許可されていないサブタイプ、原本ではなくコピーであることのいずれかが原因です。それぞれの解決方法を紹介します。
次の順序で確認してください。ワークフローでサブタイプが許可されているか、裏面画像が撮影されたか、画像が十分な品質か、そしてスクリーンショットやスキャンではなく原本の写真であるか。この4つでほぼすべてのケースをカバーできます。
書類のアップロードに失敗したり、主要なフィールドが正しく抽出されなかったりする場合、ほとんどはいくつかの既知の原因のいずれかです。ここでは、その解決方法を順に説明します。
#まず：その書類はそもそも許可されているか
画像品質のデバッグを始める前に、ワークフローがその国のそのサブタイプを正確に受け付けているかを確認してください。許可されていないサブタイプは読み取りの問題のように見えますが実際は違います。しかもその形式を持つすべてのユーザーで失敗します。1人だけの問題ではありません。書類が拒否される通常の理由はサブタイプを参照してください。
#ぼやけた、暗い、または露出過多の画像
Diditは書類を処理する前に画像品質をチェックし、ぼやけすぎている、暗すぎる、または明るすぎる場合はユーザーに撮り直しを求めます。ユーザーには次を案内してください。
- 直接的なグレアのない、良質で均一な照明を使う
- カメラをしっかり構え、撮影前にピントを合わせる
- 書類の四隅すべてをフレーム内に収める
- 書類をビニールスリーブから取り出す。反射が自動撮影を妨げます
ユーザーが撮り直せる回数には制限があります。許可された最後の試行では画像が受理されるため、永久にブロックされることはありませんが、低品質な撮影ではフィールドが読み取れないまま残ることがあります。セッションの警告にIMAGE_TOO_BLURRY、IMAGE_TOO_DARK、IMAGE_TOO_BRIGHTがあれば、これが原因であることを確認できます。
ぼやけた書類が通過し、承認までされている場合、基準があなたのリスク許容度に対して低すぎます。ワークフローの身分証確認ステップにある2つの設定で解決できます。
- 最低画像品質（品質スライダー）：書類の写真は撮影された瞬間に品質モデルで採点され、最低値を下回る撮影は即座に拒否されて再撮影が求められます。デフォルトは意図的に緩めです。上げれば、33点だったぼやけたカード裏面がチェックに届くことはなくなります。
- 撮影画像の確認画面（高度の下）：撮影したばかりの写真を本人に見せ、アップロード前に確認または再スキャンを求めます。カメラスキャンのみに適用されます。アップロードはすでにファイルのプレビューがあるためです。
品質スコア自体はセッションのレポートにあるので、気になったセッションを見て、そのすぐ上にしきい値を設定できます。
#項目が検出されない、または誤って読み取られた（氏名、生年月日、書類番号）
OCRが特定のフィールドを抽出できない場合、それだけでセッションが拒否されることは通常ありません。デフォルトでは、人が確認できるように審査中に振り分けられます。
これが特定の書類タイプや言語で頻発している場合は、ワークフローの優先文字形式設定を確認してください。抽出された氏名をラテン文字に正規化するか、書類本来の文字体系のまま保持するかを選択できます。この設定の不一致は、キリル文字、アラビア文字、ギリシャ文字、漢字の書類で氏名フィールドが文字化けしたり欠落したりする一般的な原因です。
抽出された値が間違っている場合（1文字違う姓、名前欄の住所）は、誤って読み取られた名前や項目を修正するを参照してください。サポートが代わりに編集することはできませんが、ユーザーによるデータ確認ステップ、update-data API、再提出のそれぞれで修正できます。
#スクリーンショット、印刷物、画面の写真は拒否される
Diditは物理的な書類のオリジナルかつリアルタイムの写真を必要とし、スクリーンショット、スキャン、印刷されたコピー、別の画面に表示された書類の写真は受け付けません。書類ライブネスチェックはまさにこうしたケースを検出するために設計されており、セッションにフラグを立てるか拒否します。ユーザーには物理的な書類を直接撮影するよう案内してください。
これは意図的な仕様です。写真の写真を受け付けてしまうと、そもそも書類を確認する価値のほとんどが失われます。
スクリーンキャプチャ検出器は、キーボード、柄のある机、カードの後ろのモニターなど、ごちゃごちゃした背景で撮影された本物の書類にたまに反応することがあります。画像を確認して書類が明らかに本物なら、自分でセッションを承認してください。このタグが審査に回されるのは、まさに人がその判断を下すためです。書類ライブネスの各シグナル（スクリーンキャプチャ、印刷コピー、顔写真の差し替え）には、ステップの偽造設定に独自の審査・拒否しきい値があるので、どれかがあなたのトラフィックに対して敏感すぎる場合は調整できます。
#裏面画像の欠如
IDカードや運転免許証は両面に情報があるため、Diditは抽出を完了するために表面と裏面の両方の画像を必要とします。これらの書類タイプで表面画像しか提出されなかった場合、セッションには必要なデータがそろいません。
ユーザーが裏面ステップで一貫して止まる場合、その国でその書類の裏面に実際に読み取り可能なデータが記載されているかを確認してください。何も記載されていない裏面画像を必須にすると、ユーザーはメリットのないままステップに失敗することになります。
#カメラがまったく開かない
これは書類の問題に見えますが、実際は環境の問題です。
- アプリ内ブラウザ。 チャットアプリなど、別のアプリの内蔵ブラウザ内で開かれたリンクは、カメラへのアクセスを得られないことがよくあります。同じリンクをスマートフォンの通常のブラウザで開くと解決します。
- 以前に拒否された権限。 一度サイトへのカメラアクセスを拒否すると、ブラウザはそれを記憶します。サイト設定で再度許可する必要があり、フローが再度尋ねることはできません。
- カメラがすでに使用中。 別のタブやアプリがカメラを保持しているとブロックされます。デバイスによっては、マイクへのアクセス許可がカメラも占有してしまうことがあります。
#フロー上のテキストが文字化けして見える
（書類上ではなく）インターフェース上で文字が乱れたり意味不明な単語が表示されたりするという報告があった場合、通常の原因はブラウザのページ翻訳拡張機能が画面を書き換えていることです。そのページの翻訳をオフにするよう案内してください。フロー自体が独自の言語を提供しています。検証言語の設定を参照してください。
#OCRは何言語に対応しているか
DiditのOCRは、書類と国のカバレッジの一部として130を超える言語の書類を読み取ります。これは、検証画面自体の言語とは別のもので、明示的に設定しない限りユーザーのブラウザが自動的に設定します。
#それでも解決しない場合
該当する検証のセッションIDを添えてサポートに連絡してください。これがチームが個別のケースを調査する最も速い方法です。説明されている画像や警告をそのまま確認できるためです。