このページでは

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

ローカリゼーション

ローカリゼーションを使用すると、言語ごとに新しいガイドやサーベイを作成することなく、さまざまな言語でガイドやサーベイを提供できます。サポートされる言語はプロジェクトごとに設定されます。

ガイドやサーベイのローカライズ版を作成するには、以下のことが必要です。

  • SDK を更新してユーザーのロケールを記録します。
  • プロジェクト設定を更新して、サポートする言語を指定してください。
  • サポートされている各言語の動作方法を指定します。
  • ガイドやアンケートの翻訳版を作成しましょう。

ガイドとサーベイ SDK を更新してロケールを記録する

ガイドとサーベイ SDK の初期化中に各ユーザーのロケールを記録するように SDK を更新してください。ユーザーのロケールが正確であれば、SDK はガイドやアンケートの正しい翻訳を提供します。

SDK で以下の変更を行います。

const currentLocale = getLocale(); // "en" or "en-US"
// Add the plugin before calling amplitude.init()
amplitude.add(window.engagement.plugin({ locale: currentLocale }));
amplitude.init("API_KEY");

ロケールコード

Amplitude は、特定の言語についてロケールコードの言語を考慮します。詳細については、以下のサポートされているロケールの一覧を参照してください。

プロジェクト設定を更新して複数の言語をサポートする

_プロジェクト設定 > ガイドとサーベイ_に移動して、ローカリゼーションを設定します。

このタブでは、次のことが可能です。

  • ローカリゼーションを有効または無効にする
  • デフォルトの言語を表示
  • ガイドやサーベイで使用できる言語を定義する
  • 翻訳ファイルが使用できない場合や古い場合のフォールバック動作を設定する

ガイド&サーベイは、ISO 639 言語コードと以下のロケールをサポートしています。

  • 英語: en-US, en-GB, en-AU, en-CA, en-IN
  • スペイン語: es-ES, es-MX, es-AR, es-CO
  • フランス語: fr-FR, fr-CA
  • ポルトガル語: pt-BR, pt-PT
  • 中国語: zh-CN (Simplified), zh-TW (Traditional), zh-HK (Hong Kong, Traditional)
  • ドイツ語: de-DE, de-AT, de-CH
  • アラビア語: ar-SA, ar-EG, ar-MA

英語はすべてのプロジェクトのデフォルト言語です。 このデフォルトを変更できるのは Amplitude サポートスタッフのみです。デフォルトの言語を更新するには、Amplitude サポートまでお問い合わせください。

サポートされている言語を追加するには
  1. 「対応言語」セクションで、言語を追加をクリックします。
  2. メニューで必要な言語を検索するか、スクロールして選択します。 必要な数だけ選択できます。
  3. 適用をクリックします。

フォールバック動作の設定

フォールバック動作は、ローカライズされたコンテンツが利用できない場合に表示される内容を制御します。 次の2種類のフォールバックを設定できます。

  • 翻訳が利用できない場合: ガイドやアンケートの翻訳がアップロードされていない場合は、コンテンツをデフォルトの言語で表示するか、まったく表示しないかを選択してください。
  • 翻訳が古くなっている場合: デフォルトのコンテンツが変更されたにもかかわらず翻訳されたコンテンツに変更が反映されていない場合、デフォルトの言語を表示するか、古い翻訳バージョンを表示するか、コンテンツを非表示にするかを選択できます。

ガイドやアンケートにローカライズされたコンテンツを追加する

既存のガイドやサーベイにローカライズ版を追加することもできます。また、新しいガイドやサーベイを作成する際にローカライズされたコンテンツを含めることもできます。

ガイドやアンケートにローカライズされたコンテンツを追加するには
  1. 既存のガイドまたは調査を開くか、ガイドを作成または調査を作成をクリックします。
  2. 既存のガイドまたは調査については、設定 をクリックします。
  3. 新しいガイドや調査を作成するには、デフォルトのコンテンツを作成して保存し、**[設定] **をクリックします。
  4. [ローカリゼーション] セクションまでスクロールします。

翻訳可能な文字列

ガイドとサーベイの次の部分をローカライズできます。

コンテンツを翻訳する

ローカライズされたコンテンツをガイドやアンケートに追加する方法はいくつかあります。

  • ウェブインターフェイスを使用して翻訳を追加または編集できます。 Amplitudeはこの方法を推奨しています。
  • AIローカリゼーションを使用してコンテンツを自動的に翻訳します。 Amplitudeは、迅速かつ自動的な翻訳のためにこの方法を推奨しています。
  • .xliffファイルを使用して翻訳を追加または編集します。Amplitudeはカスタム翻訳ワークフローと統合する場合、この方法を推奨しています。
  • 翻訳を追加または編集するには、ローカリゼーションAPIを使用してください。Amplitudeは自動翻訳ワークフローにこの方法を推奨しています。 この API は設定に時間がかかりますが、大規模なチームや多くの言語をサポートするチームに適しています。

Web インターフェイスは各テキスト文字列に直接マップされるため、ローカライズされたコンテンツを追加するのに最適な方法です。

  1. ガイドまたはアンケートの [ビルド] タブをクリックします。
  2. 画面の右上にある言語トグルをクリックします。 デフォルトは英語です。
  3. 必要な言語を選択してください。
  4. 翻訳済みのコンテンツを使用して個々の文字列を更新します。 Amplitudeは各文字列を言語トグルに表示されている言語に関連付けます。

翻訳をプレビューする

ローカライズされたガイドやアンケートをプレビューすると、プレビューバーに、ガイドやアンケートの表示を妨げる可能性のある翻訳関連の問題が表示されます。

これは役に立ちましたか?