多言語メッセージ

ワークスペースにロケールを追加すると、1つのプッシュ、メール、バナー、アプリ内メッセージ、またはContent Blockで、異なる言語のユーザーをターゲットにできます。

前提条件

多言語メッセージの設定と使用方法の概要については、以下の動画をご覧ください。

• 多言語ロケール
• メッセージタイプ
• テンプレート

ロケールの使用

ステップ1: ロケールを設定する

メッセージに翻訳を追加する前に、まずサポートするロケールを作成する必要があります。ロケールは、メッセージングで利用可能な言語（およびオプションで地域）のバリアントを定義します。

ステップ2: 翻訳するコンテンツをマークする

翻訳したいテキストをLiquid翻訳タグ {% translation your_id_here %}と{% endtranslation %} で囲み、タグIDを割り当てます。翻訳タグIDはメッセージ内で一意である必要があります。テキストを明確に説明するセマンティックなID名の使用を検討してください（例: {% translation header %}）。

翻訳用にマークされたメッセージの例: {% translation greeting %}Hello!{% endtranslation %}

ヒント

翻訳したいテキストをハイライトし、キーボードショートカット Cmd + Alt + L（macOS）または Ctrl + Alt + L（Windows）を使用して翻訳タグで囲みます。

このショートカットは、メールおよびContent Blocksのドラッグ＆ドロップエディターを除く、多言語メッセージングをサポートするすべてのチャネルで使用できます。これらのエディターでは、左サイドバーのパーソナライゼーションを追加ボタンを使用して翻訳タグを追加してください。

URLのローカライズ

コンテンツを翻訳する際、URLにはリンク切れを防ぐための特別な処理が必要です。

標準（静的）URL

静的URLはエディターで手動入力します（例: https://example.com）。以下の推奨事項もご確認ください。

両方の推奨事項に従った標準URLの例:

1
<a href="https://{% translation id_1 %}example.shop.com{% endtranslation %}">Visit our store</a>

Liquidで生成されるURL

URLがLiquidで生成される場合（例: {% landing_page_url %}）、以下を推奨します。

両方の推奨事項に従ったLiquid生成URLの例:

1
<a href="{% translation id_1 %}{% landing_page_url xyz %}{% endtranslation %}">View details</a>

重要

メールリンクトラッキング（リンクエイリアスまたはリンクテンプレート）を使用している場合、URLを翻訳タグで囲む際に追加の設定が必要です。

HTML属性と構造

翻訳タグで囲むのは、人間が読むテキストのみにしてください。HTML属性（class、style、idなど）やその他の構造コードを囲むことは避けてください。HTML属性はレイアウト、スタイル、機能を制御します。翻訳タグで囲むと、ローカライズ版のメッセージでフォーマットやスタイルが崩れる可能性があります。

正しく囲まれたテキスト:

1
2
3
<p class="headline" style="color: red;">
  {% translation id_1 %}Welcome to our sale{% endtranslation %}
</p>

1
2
3
4
5
{% translation id_1 %}
<p class="headline" style="color: red;">
  Welcome to our sale
</p>
{% endtranslation %}

ステップ3: メッセージにロケールを追加する

メッセージに翻訳タグを追加した後、エディターで言語を管理を選択し（メールおよびContent Blocksのドラッグ＆ドロップエディターでは言語）、翻訳を追加するロケールを少なくとも1つ選択します。

翻訳を含むContent Blocks

メッセージに翻訳が保存済みのContent Blocksが含まれている場合、それらの翻訳を再アップロードする必要はありません。保存された翻訳は、Content Blockがメッセージに追加されると自動的に適用されます。

言語を管理モーダルでは、翻訳が保存されたContent Blocksが、サポートするロケールとともにリストに表示されます。これにより、新しい翻訳を追加する前に、メッセージのどの部分がすでにローカライズされているかを確認できます。

重要

各Content Blockに、メッセージに追加したすべてのロケールの翻訳が含まれていることを確認してください。Content Blockに追加したロケールの翻訳がない場合、そのロケールのユーザーには元の言語で表示されます。

ステップ4: 翻訳を追加する

ロケールを選択した後、以下のいずれかの方法でメッセージに翻訳を追加します。

• csvテンプレートをアップロード
• 翻訳apiを使用

テンプレートをダウンロードを選択して、選択した翻訳IDとロケールのマトリクスを含むCSVをダウンロードします。各ロケールの翻訳を入力してください。完成したファイルをアップロードすると、翻訳がメッセージに適用されます。

重要

英語以外の文字の表示問題を防ぐため、翻訳CSVにExcelを使用しないでください。

パートナー翻訳APIを使用して、CampaignsおよびCanvasesの翻訳を管理・更新します。これは、外部システムでローカライゼーションを行っている場合や、翻訳パートナーと直接接続したい場合に便利です。

Canvasesで翻訳エンドポイントを使用するには、以下のパラメーターを含めてください。

• workflow_id
• step_id
• message_variation_id

注

Canvasの起動後に作成されたキャンバスステップで翻訳APIを使用する場合、APIに渡すmessage_variation_idは空またはブランクになります。

ステップ5: 翻訳をプレビューする

メッセージをプレビューするには、ユーザーとしてプレビュードロップダウンから多言語ユーザーオプションを選択します。これにより、異なるロケール定義を切り替えて、メッセージのすべての翻訳をプレビューできます。

翻訳の管理

Canvasステップまたはキャンペーンの複製と翻訳

Canvasステップ、Campaign、またはバリアントを複製すると、翻訳も含まれます。これはワークスペース間のコピーでも同様で、コピー先のワークスペースにロケールが定義されている場合に適用されます。CanvasまたはCampaignに変更を加える際は、翻訳を確認し、必要に応じて更新してください。

Content Blocksに翻訳を保存する

Content Blocksは、メッセージと同じ方法で多言語をサポートします。Content Blocksを作成または編集する際に、コンテンツに翻訳タグを付け、ロケールを追加し、CSVまたは翻訳APIを使用して翻訳をアップロードできます。

保存された翻訳はContent Blockに関連付けられたままです。ブロックがメッセージに追加されると、その翻訳が自動的に含まれます。

右から左に書くメッセージ

右から左に書く言語（アラビア語など）の翻訳ファイルを入力する際は、翻訳をspanで囲んで適切にフォーマットされるようにしてください。

1
{% translation your_id_here %}<span dir='rtl'>default text</span>{% endtranslation %}

メールリンクトラッキング

メールキャンペーンでは、Brazeは各URLにトラッキング情報（クエリパラメーター）を追加してリンクを追跡します。この動作はリンクエイリアスとリンクテンプレートの両方をサポートしています。

URLが翻訳タグで囲まれている場合、Brazeはトラッキング情報を追加する場所を判断できない場合があります。これが正しく機能するようにするには、URLの末尾にトラッキングを追加する場所を示す特殊文字を含める必要があります。

URLは2つの特殊文字を使用してこの動作を制御します。

• ?はまだトラッキングがないURLにトラッキングを追加します。
• &はURLにすでに?が含まれている場合に追加のトラッキングを追加します。URLには?を1つだけ含めることができます。

言語設定とアクセシビリティ

まずアクセシビリティのアクセシビリティ言語を参照して、WCAGのコンテキスト、チャネルとエディターの動作（ランディングページを含む）、およびメッセージレベルのアクセシビリティ設定をご確認ください。

多言語メッセージを使用する場合、ローカライズされた送信が適切な言語を宣言するように、アクセシビリティ言語を各ロケールに合わせてください。

アクセシビリティ言語の設定

アクセシビリティ言語は2つのレベルで設定できます。

メッセージレベル

メッセージレベルでは、メッセージ設定のアクセシビリティセクションでアクセシビリティ言語を設定します。言語の選択、Liquidの使用、チャネルごとの制限については、アクセシビリティ言語を参照してください。

ロケールレベル

多言語メッセージの場合、ローカライゼーション設定で各ロケールにアクセシビリティ言語を設定します。アクセシビリティセクションで {{accessibility_language}} を使用すると、ドキュメントまたはカードの言語がそれらのロケール値にマッピングされます。

新しいメッセージでそのトークンがデフォルトで表示されるかどうかは、チャネルとエディターによって異なります。たとえば、アプリ内メッセージやバナーは、ランディングページやドラッグ＆ドロップメールとは動作が異なります。詳細については、アクセシビリティ言語を参照してください。

よくある質問

翻訳タグの制限は何ですか？

翻訳タグを使用する場合、以下の制限が適用されます。

• 各メッセージには最大200個の翻訳タグを使用できます。
• 各デフォルトテキスト（翻訳タグ間のコンテンツ）は最大2,000文字です。
• ロケールごとの翻訳は最大409,600バイト（約409.6 KB）です。

ロケールの1つで翻訳済みコピーを変更できますか？

はい。まずCSVで編集を行い、ファイルを再度アップロードして翻訳済みコピーを変更します。

Brazeは翻訳を提供しますか？

いいえ。CSVのアップロードまたは翻訳APIを使用して、ご自身で翻訳を提供する必要があります。

翻訳タグをネストできますか？

いいえ。

HTMLメッセージ全体を翻訳タグで囲むことはできますか？

いいえ。ベストプラクティスとして、人間が読むテキストまたはローカライズが必要なコンテンツのみを囲むべきです。これにより、フォーマット、リンク、その他の非テキスト要素の破損を防ぐことができます。

また、正確な翻訳を作成し、パフォーマンスやサイズの制限を回避するために、意味的に関連する小さなテキスト単位で囲むことを検討してください。

ロケールの1つで翻訳済みコピーを変更できますか？

はい。CSVを使用している場合は、まずファイルで編集を行い、再度アップロードして翻訳済みコピーを変更します。翻訳APIを使用している場合は、更新エンドポイントを使用して変更を行います。

Brazeはどのような検証や追加チェックを行いますか？