検証言語の設定
フローはブラウザの言語を自動検出し、対応していない場合は英語にフォールバックします。代わりに言語を強制する方法と、メールの言語を別に設定する方法を解説します。
検証UIはブラウザのロケールを自動検出し、対応していなければ英語にフォールバックします。言語を強制するには、セッション作成時にlanguageを渡してください。メールの言語は別のフィールド（contact_details.email_lang）であり、片方を設定してももう片方は設定されません。
#デフォルトの挙動
本人のブラウザのロケールがDiditの対応言語であれば、検証UIはそれを使います。対応していなければ英語にフォールバックします。これを機能させるために何かする必要はありません。
- Textsは言語ごとに文言を上書きします。
- 他の言語でフローをテストする前に保存してください。
#言語を強制する
自動検出が的外れになることは無視できないほどあります。共有デバイス、海外で購入した電話、アプリのロケールを報告するWebView、あるいは本人が実際には読めない言語で設定されたブラウザなどです。ブラウザより自分の方が正しいとわかっている場合は、明示的に設定してください。
| フィールド | 場所 | 制御する内容 |
|---|---|---|
language | セッション作成のリクエストボディ | 検証UIの言語 |
contact_details.email_lang | セッション作成のリクエストボディ | メール通知の言語 - 招待、リマインダー、ステータス更新 |
email_language | セッションステータスの更新 | 送信するステータス変更メールの言語 |
すべての値は大文字小文字を区別します。対応言語一覧にある正確なコードを使ってください。メール言語を渡さない場合、メールは自動的にUI言語ではなく英語にフォールバックします。
UI言語の設定は、メール言語を設定することにはなりません。languageだけを渡した場合、フローはスペイン語で正しく表示されつつ、メールは英語のまま送られることがあります。ユーザーから「フローは問題なかったがメールがそうではなかった」という報告があれば、これが原因です。
#WebViewとモバイル
WebView内では、ページに報告されるロケールはホストアプリのものであり、自社プロダクト内での本人の設定とは限りません。自社アプリに独自の言語設定がある場合は、検出に頼らずセッション作成時にそれをlanguageとして渡してください。アプリはそれを知っていますが、WebViewは知りません。
#右から左に書く言語
対応言語にはアラビア語を含む、右から左に書く言語がいくつかあります。方向はフロー側で処理されるため、別途設定する必要はありません。Style Editorでテキストを上書きしている場合は、その上書きがLTRのロケールだけでなくRTLのロケールでも正しく読めるか確認してください。手書きの文字列こそ、そこで壊れやすいものです。
#カスタムテキストと言語の関係
Style Editorのテキスト上書きは、ロケールごとに翻訳をフォークすることなく特定の文字列を置き換えます。それがこの機能の目的ですが、同時に、ある言語で書いた上書きは、対処しない限りすべての言語に表示されてしまうことも意味します。複数の言語をサポートしている場合は、出荷済みの翻訳を維持し、本当に必要なものだけを上書きすることをおすすめします。
#フロー内の文字化けや意味不明な単語
ユーザーから、文字が入れ替わった単語や、文の途中で2つの言語が混ざっているといった乱れたテキストの報告があった場合、通常の原因はフロー自体の翻訳ではありません。ブラウザのページ翻訳機能や拡張機能が、フローの表示の上からページを書き換えていることが原因です。
そのページの翻訳をオフにするよう伝えてください。フローはすでに自身の言語を提供しているため、ブラウザでさらに翻訳しても何も得られず、確実に壊れます。
#OCRの言語は別物
DiditのOCRは130以上の言語で書類を読み取れます。これはインターフェースが表示される言語とは完全に独立しています。本人は英語でフローを完了しながら、ギリシャ語で印刷された書類を持つことができ、どちらも問題なく動作します。対応している書類と国をご覧ください。
#レポートは英語
ダウンロード可能なセッションPDFは、フローの言語にかかわらず英語で描画されます。これはエンドユーザーに渡すものというより、社内向けのコンプライアンス成果物です。検証レポートのダウンロードをご覧ください。
#言語と離脱
ある市場で異常に高い離脱率が見られる場合、まず言語を除外要因として確認する価値があります。人は読めないフローに対して不満を言うのではなく、単に離れていきます。より微妙な原因を探る前に、それらのセッションが実際にどのロケールで動いていたかを確認してください。セッションが終わらないときをご覧ください。