ローカライズ

最終更新日: 2025年01月22日 08:46

グローバル市場に進出し、多言語ユーザーベースをサポートしている企業は、コンテンツを多言語で公開する必要があります。ローカライズにより、アプリ内メッセージをさまざまな言語で容易に配信できるようになります。ガイドコンテンツとリソースセンターコンテンツを希望の言語で作成し、そのコンテンツをXLIFFファイル（翻訳データの標準形式）としてエクスポートしてPendoの外部で翻訳してから、Pendoに再度インポートできます。Pendoでは、インストールスクリプトを介して渡された言語メタデータ、あるいはブラウザメタデータを使用して、ユーザーに適切な言語を表示します。この機能は、ウェブガイドとモバイルガイドで利用可能です。

ネイティブのモバイルガイドは、ウェブガイドと同様にモバイルSDKを使って誰でも翻訳できます。SDKでは、ウェブエージェントと全く同じように、言語メタデータフィールドにあるデバイスの言語を送信します。また、アプリケーションの設定で、デバイスの言語として代替ユーザーメタデータフィールドを使用するようにローカライズを設定できます。

注：AIによる翻訳生成を許可する設定がサブスクリプションで有効になっている場合、AIを活用して、アプリでサポートされている任意の言語へのガイドのローカライズを簡素化できます。詳細については、AIを活用したガイドのローカライズを参照してください。

要件

Pendo管理者ユーザーは［サブスクリプション設定（Subscription Settings）］でローカライズ設定にアクセスし、管理できます。
レイアウトからガイドを作成する、または最初からガイドを作成する権限があるPendoユーザーは翻訳を編集できます。
Agentバージョン2.15.15以上。ローカライズではVisual Design Studioを利用します。これがこの機能に必要な最小バージョンです。

ローカライズ設定

ローカライズ設定はアプリによってさまざまであり、複数アプリのサブスクリプションの場合、個々のアプリに対して有効にすることができます。

［設定（Settings）］>［サブスクリプション設定］に移動して、アプリを選択します。
［ローカライズ設定（Localization Settings）］タブで［ローカライズを有効化（Enable Localization）］をオンにします。有効にすると、そのアプリの全ガイドに適用される［ローカライズ設定］が表示されます。

注記：クラシックデザイナーで作成したガイドはローカライズできません。［翻訳言語がない場合の動作］設定では、クラシックデザイナーのガイドはブロックされません。クラシックデザイナーガイドをユーザーに非表示にするように設定しても、ユーザーの言語が翻訳されていない場合、クラシックデザイナーガイドがユーザーに表示されます。

言語設定メタデータ（Language Preference Metadata）

Pendoは訪問者のローカルメタデータに基づいて訪問者に適切な言語を表示します。訪問者のブラウザから収集されたデフォルトの言語メタデータを使用するか、インストールスクリプトとデータマッピング設定を通じてカスタムの言語メタデータ値を定義することができます。メタデータフィールド名とその値を選択できます。

注：カスタム言語のメタデータフィールドでは、言語以外の名前を使用する必要があります。この名前は、ブラウザの言語メタデータ用に予約されており、置き換えることはできません。

ドロップダウンメニューから言語メタデータ値を選択します。

注：正確な分析を行えるように、独自の値を使用することをお勧めしますが、他に選択肢がない場合は、訪問者のブラウザの言語メタデータを使用できます。

サポートされているガイドの言語

Pendoが収集したメタデータに基づいて、ガイド翻訳に必要なすべての言語を追加できます。

言語を追加するには：

［+ 言語を追加（+ Add Language）］を選択します。
ドロップダウンメニューから言語を選択します。リストには、使用可能な言語、およびその言語用にブラウザで収集されたデフォルトのメタデータ値が表示されます。
カスタム言語のメタデータ値に合わせてメタデータを必要に応じて変更します。
［追加（Add）］を選択して新しい言語を保存します。すべての言語を追加するまでこのプロセスを繰り返します。

［サポートされている言語（Supported Languages）］には、追加された全言語のリストが表示されます。言語にカーソルを置くと、［編集（Edit）］ボタンと［削除（Delete）］ボタンが表示されます。

翻訳言語がない場合の動作

［翻訳言語がない場合の動作（Missing Translation Language Behavior）］は、そのガイドに優先言語の翻訳がない場合に、ガイドをデフォルトの言語で訪問者に表示するかどうかを制御します。これは、その言語がまだ翻訳されていないか、Pendoサブスクリプションで設定されていないことが原因と考えられます。

注：これは、ユーザーの言語設定が自分の設定と一致しない場合にユーザーにガイドが表示されなくなってしまうため、重要な設定です。
たとえば、英語が読めるユーザーがブラウザで優先言語を韓国語に設定している場合があります。このユーザーには、韓国語に翻訳されない限りガイドは表示されません。

サポート対象言語に表示されているデフォルトの言語を使用してガイドを表示する場合は、ボタンをオンに切り替えます。

使用可能な翻訳言語が訪問者の言語メタデータと一致しない場合にガイドを非表示にするには、ボタンをオフに切り替えます。

注：この設定は、リソースセンターのガイドにも適用されます。

ガイドの翻訳

ガイドを翻訳するには、XLIFFファイルをエクスポートし、ファイルに翻訳を追加し、ガイドのローカライズの詳細に再び翻訳済みファイルをインポートします。XLIFFは、画像やコードブロック内の構造化されていないテキスト以外の、ビルディングブロックに入力されたあらゆるテキストの翻訳をフォーマットします。画像に使われる代替テキストやURLはXLIFFで翻訳できます。

たとえば、テキストブロック内のテキストとボタンテキストはXLIFFに取り込まれますが、アップロードされた画像のテキストは取り込まれません。翻訳版の画像をホストしている場合、元のガイドに追加された画像ではなく翻訳された画像がガイドに読み込まれるように、XLIFFファイル内の画像URLを置き換えることができます。

ローカライズされたリンクURLは.xliffファイルに追加できます。各ボタンリンクには独自のtrans-unitがあり、ローカライズされたリンクURLは、そのユニットの<target>要素に追加できます。

必ず全テキストが最終版になっている、完成したガイドから始めてください。XLIFFファイルのエクスポート後にガイドのコンテンツをビジュアルデザインスタジオ（Visual Design Studio）で編集した場合、翻訳ファイルは更新されません。コンテンツに変更を加えた場合は、エクスポート、翻訳、インポートのプロセスを繰り返す必要があります。

NPSガイドのローカライズ

NPSはガイドであり、ローカライズが有効になっている場合はガイドの詳細ページに［ローカライズ（Localization）］タイルが表示されます。NPSアンケートを翻訳すると、回答者は母国語でアンケートを見ることができます。NPSメールは翻訳されません。

［ローカライズ］オプションが表示されていない場合、アップグレードが必要な古いNPS投票調査が存在する可能性があります。NPSガイドのアップグレードの詳細については、既存のNPS調査のアップグレードを参照してください。

注：ローカリゼーションAPIを使用して複数のガイドのローカライズを自動化し、最大15個のガイドを一括でエクスポートおよびインポートすることもできます。

［ローカライズ（Localization）］には、翻訳しているガイドの［設定（Settings）］タブからアクセスします。

［ガイドの詳細（Guide Details）］ページの［ローカライズ］タイルで、［編集（Edit）］を選択します。
［エクスポート（Export）］を選択してガイドのXLIFFファイルをダウンロードし、翻訳できるようにします。

このファイルには、希望の言語に翻訳できるガイドコンテンツが文字列として含まれています。マルチステップガイドの場合、各ステップの文字列が同じファイルに含まれています。

［ソース言語（Authored Language）］は、XLIFFファイルでソース言語を変更する場合に使用します。通常はアメリカ英語ですが、［ローカライズ設定（Localization Settings）］で設定したどの言語にも変更可能です。ガイドの作成に使われた言語がソース言語と一致しない場合は、ソース言語を編集してください。

ヒント：アプリとアプリのコンテンツを翻訳している企業には通常、テキストの翻訳を行う翻訳部門または翻訳サービスがあります。翻訳部門は、SmartlingやXliff Editorのような専用の翻訳ツールをプロセスの支援に使用します。Pendoは、特定の翻訳ツールやサービスを推奨したり、ガイドコンテンツの翻訳を提供したりすることはありません。

XLIFFコードの作業

XLIFFは、コンテンツの翻訳やローカライズの業界標準のファイル形式です。XLIFFは、特定のUI要素とテキストコンテンツ、元の言語と翻訳された言語、元のコンテンツと翻訳されたコンテンツを識別します。PendoからエクスポートされたXLIFFファイルには、ガイド全体の翻訳可能な全コンテンツのコードがあります。各オブジェクトはコードの<trans-unit>で編成されています。Pendoからエクスポートされたファイルは、翻訳できる状態になっており、ターゲット言語またはターゲットコンテンツはありません。複数の言語に翻訳する必要がある場合、各言語に専用のXLIFFファイルが必要です。1つのファイルでサポートされているターゲット言語は1つだけです。

trans-unitは、コード内の個々のテキストブロックです。1つのガイドステップに複数のtrans-unitが含まれている場合があります。各trans-unitは個別に翻訳する必要があります。複数のテキストブロックを1つのtrans-unitで翻訳することはサポートされていません。必要な場合は、ターゲット言語用のXLIFFファイルで翻訳済みの語句を編集して、翻訳済みガイドの翻訳版の読みやすさやフォーマットを改善することができます。

source-language-"en-US" - ソースコンテンツの言語コード
target-language=" " - テキストが翻訳されている言語コード
<source></source> - ソース言語で書かれたガイドのソースコンテンツ
<target></target> - 翻訳テキストが<trans-unit>ごとに入力されるコンテナ

例

<xliff...>
   <file... source-language="en-US" target-language="fr-FR">
   ...
      <trans-unit id="ID String">
         <source>Hello</source>
         <target>Bonjour</target>
         <note>TextView</note>
      </trans-unit>
   ...
   </file>
</xliff>

Pendo XLIFFコードサンプル

<xliff version="1.2"xmlns="urn:oasis:names:tc:xliff:document:1.2">
<file original="ID STRING" datatype="pendoguide" source-language="en-US" target-language="TRANSLATED LANGUAGE CODE">
 <body>
 <group id="ID STRING">
 <note></note>
 <trans-unit id="ID STRING">
 <source>当社を友人や同僚に勧める可能性はどのくらいありますか？</source>
<target>翻訳言語のテキスト</target>
 <note>TextView</note>
 </trans-unit>
...
 </group>
 </body>
 </file>
</xliff>

注：XLIFFコードの一部には、翻訳テキストの特殊文字がコードの一部として解釈されないように保護するためのCDATAタグが含まれています。特殊文字がガイド内で正しく表示されるように、CDATAタグをXLIFFファイルに残しておく必要があります。また、翻訳したテキストをCDATAタグを使用し、<target>タグで囲む必要があります。

翻訳のインポート

ガイドの翻訳版を有効にするには、翻訳言語の翻訳済みXLIFFファイルを［ローカライズ（Localization）］タイルにインポートします。

［ローカライズ］タイルで［編集］を選択します。
［未翻訳（Untranslated）］の言語の横にある［インポート（Import）］をクリックして、翻訳済みXLIFFファイルをアップロードします。［未翻訳］の言語は、ファイルのターゲット言語と同じである必要があります。

インポートが完了すると、言語は［未翻訳］から［翻訳済み（Translated）］に移動します。引き続き［インポート］ボタンを使用して、後で翻訳済み言語を更新できます。
［完了（Done）］をクリックして、［ローカライズ（Localization）］タイルの編集ビューを閉じます。

警告: XLIFFファイルは、対応するガイドと一致する必要があります。XLIFFファイルのコンテンツがガイドと一致しないと、インポートに失敗します。アップロードでは、すべてのターゲットコンテナに翻訳済みコンテンツがあるか検証されます。一部のターゲットコンテナが空の場合、一部のコンテンツがない可能性があることを伝える通知が表示されますが、ファイルはインポートされます。
XLIFFファイルでエラーが発生した場合のトラブルシューティングについては、エラー：XLIFF翻訳ファイルの不具合を参照してください。

翻訳済みガイドのテストおよびプレビュー

翻訳された言語でガイドをプレビューするには、［ガイド設定（Guide Settings）］の［表示言語（Viewing language）］ドロップダウンを使用し、［プレビュー（Preview）］を選択します。

必要に応じて何度でもXLIFFファイルに変更を加えて再インポートすることができます。

翻訳版に問題がなければ、ガイドを公開します。ガイドが公開済みの場合、インポートが完了するとすぐに翻訳を利用できます。

言語に応じたガイド指標の表示

選択した言語に応じて、ガイドの指標を表示できます。ガイドに移動して［ガイド指標（Guide Metrics）］を選択してください。フィルターを使用して言語のドロップダウンオプションを選択し、別の言語を選択します。

リソースセンターのローカライズ

リソースセンターのローカライズプロセスはガイドの場合と同様です。

リソースセンターの［ローカライズ］タイルにアクセスするには、左のナビゲーションバーで［ガイド（Guides）］>［リソースセンター（Resource Center）］に移動します。

リソースセンターのローカライズには、リソースセンターの名前、モジュールのタイトルとサブタイトル、およびリソースセンターに含まれるガイド名の翻訳が含まれます。ガイドのコンテンツは、ガイド自体のコンテキストに沿って翻訳されます。

翻訳ファイルにガイド名がない場合は、［翻訳言語がない場合の動作］設定（上記参照）が有効になります。

リソースセンターのローカリゼーションを更新する

リソースセンターまたはリソースセンターのガイドに変更を加えた場合は、次のようにローカリゼーションを更新する必要があります。

次の操作の後にリソースセンターのローカリゼーションのみを更新します。
- 新しいモジュールの追加
- モジュールのタイトルまたはサブタイトルの変更
- ガイドリストモジュールに対する新しい検索キーワードの追加
- ガイドリストまたはオンボーディングモジュールに対するすでに翻訳されたガイドの追加
次の操作の後に個々のガイドのローカリゼーションのみを更新します。
- ガイドステップの内容の変更
- 既存のガイドに対するガイドステップの追加
- リソースセンターに対するお知らせの追加
新しいガイドを作成してガイドリストまたはオンボーディングモジュールに追加するときは、リソースセンターと個々のガイドのローカリゼーションの両方を更新します。

リソースセンターのXLIFFファイルで利用可能な翻訳

全モジュールのタイトル
全モジュールの字幕
ガイドリストモジュールのガイド名、キーワード、検索バー、検索結果のテキスト
オンボーディングモジュールのガイド名とステップカウンター

名前以外のお知らせとガイドのコンテンツは、特定のガイドのローカライズ設定を使って翻訳されます。

注：サンドボックスモジュールのコンテンツはローカライズで翻訳できません。ローカライズツールはカスタムコードからテキストを引き出せません。サンドボックスモジュールで翻訳済みコンテンツを提供するには、コードを確認し、既存のサンドボックスモジュールのコンテンツを翻訳し、翻訳済みコンテンツを含む新しいサンドボックスモジュールを作成し、セグメント化機能と言語メタデータを使って適切なサンドボックスモジュールを表示します。

言語サポートとファイルの種類

サポートされている言語ファイルの種類は、XLIFF 1.2形式のみです。Pendoでは、以下の言語がサポートされています。

アフリカーンス語（af）
アムハラ語（am）
オーストリアドイツ語（de-AT）
ベンガル語（bn）
ブルガリア語（bg）
カタルーニャ語（ca）
中国語 - 香港（zh-HK）
中国語 - PRC（zh-CN）
中国語 - 台湾（zh-TW）
中国語（zh）
クロアチア語（hr）
チェコ語（cs）
デンマーク語（da）
オランダ語 - ベルギー（nl-BE）
オランダ語（nl）
英語 - オーストラリア（en-AU）
英語 - カナダ（en-CA）
英語 - アイルランド（en-IE）
英語 - ニュージーランド（en-NZ）
英語 - 英国（en-GB）
英語（en）
英語 - 米国（en-US）
エストニア語（et）
フィリピン語（fil）
フィンランド語（fi）
フランス語 - ベルギー（fr-BE）
フランス語 - カナダ（fr-CA）
フランス語 - フランス（fr-FR）
フランス語（fr）
ドイツ語 - オーストリア（de-AT）
ドイツ語 - スイス（de-CH）
ドイツ語（de）
ドイツ語（de）
ギリシャ語（el）
グジャラート語（gu）
ハイチクレオール語（ht）
ヒンディー語（hi）
ハンガリー語（hu）
アイスランド語（is）
インドネシア語（id）
イタリア語（it）
日本語（ja）
カンナダ語（kn）
韓国語（ko）
ラトビア語（lv）
リトアニア語（lt）
マダガスカル語（mg）
マレー語（ms）
マラヤーラム語（ml）
マラーティー語（mr）
モンゴル語（mn）
ノルウェー語（no）
オディア語（or）
ポーランド語（pl）
ポルトガル語 - ブラジル（pt-BR）
ポルトガル語 - ポルトガル（pt-PT）
ポルトガル語（pt）
ルーマニア語（ro）
ロシア語（ru）
セルビア語（sr）
スロバキア語（sk）
スロベニア語（sl）
南アフリカ英語（en-ZA）
スペイン語 - チリ（es-CL）
スペイン語 - 南アメリカ（ES-419）
スペイン語 - メキシコ（es-MX）
スペイン語 - スペイン（es-ES）
スペイン語（es）
スワヒリ語（sw）
スウェーデン語（sv）
スイスイタリア語（it-CH）
タミル語（ta）
テルグ語（te）
タイ語（th）
トルコ語（tr）
ウクライナ語（uk）
ウルドゥー語（ur）
ベトナム語（vi）
ズールー語（zu）

注：ヘブライ語やアラビア語などの右から左へ記述する言語は、翻訳ではまだサポートされていません。ウェブとモバイルの両方で、右から左に読む言語のガイドを作成できます。詳細については、右から左に読む言語用のガイド設計を参照してください。

デフォルト言語を英語（米国）（en-US）から他のサポート対象言語に変更する

Pendoサポートを利用して、デフォルトの言語をサポート対象の別の言語に変更できます。ただしこの変更を行うと、既存のすべてのガイドのデフォルト言語も変更され、適用済みの翻訳は削除されてしまいます。また、既存の翻訳ファイルを再インポートできるように、準備していただく必要もあります。

Pendoサポートに連絡し、次の情報を提供してください。

Pendoサブスクリプション
Pendoアプリケーション
デフォルト言語として設定したいサポート対象言語