Brazeコネクタを使用すると、マーケターは手作業なしでBrazeのキャンペーン、キャンバス、テンプレートをローカライズできます。Phrase TMSをBrazeの多言語APIに接続することで、多言語コンテンツが翻訳のために両プラットフォーム間で自動的に交換されます。
この統合は、開発者ではなくマーケター向けに設計されています。コードの編集、ファイルの書き出し、テンプレートの複製が不要になります。
このコネクタには、Phrase TMSの言語コードとBrazeの言語コードを自動的に一致させる統合言語マッピング機能が含まれています。de-DEとde-deのような大文字と小文字の違いや、en-USとen_usのような区切り文字の違いは自動的に解消されるため、手動設定の手間が軽減されます。管理者は、コネクタ設定で非標準または固有のロケールコードに対するカスタムマッピングを定義でき、これらは自動マッピングよりも優先されます。
新しいジョブが到着したときに翻訳者に通知し、そのジョブが完了したときにマーケターに通知が届くよう、自動アラートを設定できます。
Brazeでは、各翻訳に一意のタグIDが必要です。
Brazeのコンテンツ構造
-
テンプレート:
キャンペーンやキャンバスの基盤となる、再利用可能なメッセージレイアウト(メール、アプリ内メッセージ、プッシュ通知など)。
-
キャンペーン:
1つまたは複数のチャネル(メール、プッシュ、アプリ内)を通じて、ターゲットを絞ったメッセージをオーディエンスに送信するために使用されます。キャンペーンは、1回限り、定期、またはトリガーベースで実行でき、パーソナライズされたマルチチャネルコミュニケーションをサポートします。
-
キャンバス:
トリガー、オーディエンスセグメント、配信タイミングの条件を使用して、複数のチャネルでメッセージを送信する、複数ステップのカスタマージャーニー。キャンバスは、行動ベースの自動エンゲージメントフローを調整するのに最適です。
-
コンテンツブロック:
テンプレート、キャンペーン、キャンバス全体に埋め込むことができる、再利用可能なコンテンツスニペット。
ローカリゼーションのユースケース
-
テンプレートレベルのローカリゼーション
テンプレートをキャンペーンやキャンバスにリンクする前にローカライズします。
制限事項:
-
メール、プッシュ、アプリ内メッセージのHTMLテンプレートのみをサポートします(ドラッグ&ドロップは非対応)。
-
ドラッグ&ドロップテンプレートは、キャンペーンおよびキャンバスを通じてサポートされます。
-
-
キャンペーンおよびキャンバスレベルのローカリゼーション
キャンペーンやキャンバスで作業する場合、ドラッグ&ドロップテンプレートを含む追加のメッセージタイプをローカライズできます。
キャンペーンとキャンバスは、配信レイヤーとして機能します。ドラッグ&ドロップテンプレートはテンプレートライブラリから直接ローカライズすることはできませんが、キャンペーンやキャンバス内で使用する場合はローカライズ可能です。つまり、すべてのメッセージタイプを適切なレイヤーで翻訳できるということです。
制限事項
|
制限事項 |
項目 |
回避策 |
|---|---|---|
|
ドラッグ&ドロップテンプレート |
テンプレートとして表示されない |
キャンペーンまたはキャンバス経由でローカライズすれば、Phrase TMSで表示されるようになります |
|
ロケールの不一致 |
ジョブ作成エラーの原因となる可能性があります |
ロケールコードはアンダースコアを使用して一貫性を保ってください |
|
権限の不足 |
同期をブロックする可能性があります |
テンプレート、キャンバス、キャンペーンへのアクセス権を付与した新しいAPIキーを作成してください。 |
コネクターにはいくつかの使用例があります。
-
プロジェクトマネージャは、ファイルをオンラインリポジトリからプロジェクトに直接追加できます。
-
提出者ポータルを設定して、提出者がオンラインリポジトリから直接リクエストにファイルを追加できるようにします。
-
プロジェクト自動作成(APC)を使用して、監視対象のドキュメントまたはフォルダのコンテンツの変更が検出されると、新しいプロジェクトが自動的に作成されるようにします。
-
新規または更新された翻訳可能なコンテンツのみがAPCをトリガーします。翻訳のエクスポートや翻訳対象外のコンテンツへの変更では、新しいプロジェクトは作成されません。
-
-
コネクタAPIを使用すると、通常はUIで手動で実行する手順を自動化できます。ウェブフックを使用すると、特定のイベント(ジョブのステータス変更など)をサードパーティのシステムに通知できます。
-
Brazeアカウントにログインします。
-
開発者コンソールのの下にあるに移動します。
-
を選択します。
制限が必要な場合:
-
新しいREST APIキーを作成します。
このキーはコネクタの設定に必要です。
REST APIキーは、それを生成したBrazeユーザーアカウントに紐付けられています。
以下の権限が選択されていることを確認してください。
-
テンプレート
-
キャンバス
-
キャンペーン
旧コネクタ用に生成したキーは使用できません。
-
-
Braze RESTエンドポイントURL。をコピーします。
-
ワークスペース設定 - 多言語ロケール設定の言語ロケールが、アンダースコアを使用した標準形式であることを確認してください。ハイフンやその他の形式を使用するとエラーが発生します。
-
翻訳が必要なすべてのテンプレート、キャンペーン、キャンバスのステップで、ソースロケールを含む必要なすべてのロケールが多言語設定に指定されていることを確認してください。
-
設定
ページで、セクションまでスクロールします。
-
[コネクタ]をクリックします。
ページが開きます。
-
新しいコネクタをクリックします。
ページが開きます。
-
タイプをに変更し、コネクタの名前を入力します。
-
ドロップダウンリストからBraze RESTエンドポイントURLを選択します。
-
にあるREST APIキーを入力します。
-
[接続テストTest connection] をクリックします。
-
成功すると、ボタンの横に小さなチェックマークが表示されます。
-
-
オプション設定を表示をクリックして、追加のオプションを設定します。
-
インポートするコンテンツのタグIDを入力します。タグはBrazeのタグに一致する必要があります。
-
言語マッピングを追加をクリックして、Brazeの言語をTMSの言語にマッピングします。
各Phrase言語は、一度に1つのBrazeロケールコードにのみマッピングできます。2つのBrazeコード(例:
daとvisitor_da)が両方とも同じPhrase言語にマッピングされている場合、コネクタは自動的にいずれかのコードを選択しますが、どちらのコードが選択されるかを制御する方法はありません。選択されなかったコードのジョブは作成に失敗し、コネクタはその言語に対してエラーをログに記録します。ジョブを作成するには、コネクタまたはAPCの言語マッピングで構成されたソースロケールとすべてのターゲットロケールが、個々のBrazeキャンバスまたはキャンペーンアイテム上に既に存在している必要があります。コネクタまたはAPCレベルでロケールを構成するだけでは不十分です。キャンバスにロケールがない場合、ソースまたはターゲットロケールがBrazeアイテムで構成されていないことを示すエラーが発生し、インポートは失敗します。インポートを再試行する前に、不足しているロケールをBrazeのキャンバスに直接追加してください。
-
を設定して、指定された日数以内に更新されたコンテンツのみをインポートします。0に設定すると、経過時間に関係なくすべてのコンテンツがインポートされます。
-
-
保存をクリックします。
コネクターがページの一覧に追加されます。
BrazeのHTMLエディタを使用する場合、コンテンツはテンプレートレベルで直接ローカライズできます。これは再利用可能なメールに最適です。
HTMLメールテンプレートをローカライズするには、以下の手順に従ってください:
-
- - から、テンプレートを開きます。
-
翻訳タグを追加します:
-
翻訳可能な領域をPhraseタグで囲みます:
{% translation phrase_body %} ...ここにメールコンテンツを入力... {% endtranslation %}ヒント
開始タグを1行目に、終了タグをHTMLエディタの最終行に配置します。文を個別に囲む必要はありません。Phraseコンバーターが2つのタグ間のすべてを自動的に解析し、Phrase TMSワークスペースでの翻訳用に準備します。HTMLの書式設定、リンク、スタイルは、ローカライズされたバージョンでも完全に維持されます。
-
件名とプリヘッダーを翻訳するには、それぞれを個別に囲みます:
{% translation phrase_subject %}Subject text{% endtranslation %} {% translation phrase_preheader %}Preheader text{% endtranslation %}
-
-
テンプレートを保存します。
-
テンプレートを再度開き、を選択して、ソースロケールとターゲットロケールを選択します。ロケールがPhraseの設定と同じであることを確認してください。
-
テンプレートを保存します。
-
Phrase TMSから、 - - を選択します。
HTMLテンプレートが翻訳ジョブとして表示されます。
-
翻訳とレビューを行います。
-
承認されたら、翻訳をBrazeにエクスポートします。
ローカライズされたバージョンは、割り当てられたロケール配下に自動的に表示されます。 - を使用して、表示とレイアウトを確認してください。
備考
キャンペーンまたはキャンバスからインポートされたジョブの場合、CATエディターでインコンテキストプレビューは利用できません。Phrase TMSはこれらのコンテンツタイプの一部として複数のメールを受信しますが、それらをレンダリング用に単一のHTMLに統合できないため、プレビュータブは表示されません。
インコンテキストプレビューを使用するには、代わりにメールテンプレートを直接ローカライズしてください。
キャンペーンまたはキャンバス内でローカライズする場合、ワークフローが若干異なります。スタンドアロンのHTMLテンプレートをローカライズするのではなく、ドラッグ&ドロップコンテンツを含む可能性のある、公開中または下書きのキャンペーンアセットに対して作業を行います。
-
ローカライズはテンプレートライブラリからではなく、キャンペーンまたはキャンバス内で直接行われます。
-
ドラッグ&ドロップテンプレートは、これらのコンテキストで使用されるとローカライズ可能になります。
-
すべてのメッセージタイプ(メール、プッシュ通知、アプリ内メッセージ)は、Phraseタグで囲まれていればローカライズ可能です。
キャンペーンまたはキャンバスを操作するには、以下の手順に従ってください:
-
から、必要なアセットを開きます。
-
翻訳タグを追加します。
-
HTMLエディタを使用する場合
-
翻訳可能な領域をPhraseタグで囲みます。
{% translation phrase_body %} ...ここにメールコンテンツを入力... {% endtranslation %}ヒント
開始タグを1行目に、終了タグをHTMLエディタの最終行に配置します。文を個別に囲む必要はありません。Phraseコンバーターが2つのタグ間のすべてを自動的に解析し、Phrase TMSワークスペースでの翻訳用に準備します。HTMLの書式設定、リンク、スタイルは、ローカライズされたバージョンでも完全に維持されます。
-
件名とプリヘッダーを翻訳するには、それらを個別に囲みます。
{% translation phrase_subject %}Subject text{% endtranslation %} {% translation phrase_preheader %}Preheader text{% endtranslation %}
-
ドラッグ&ドロップメールの場合は、メールの先頭と末尾にブロックを1つずつ追加します。先頭のブロックに開始タグ
{% translation phrase_body %}を、末尾のブロックに終了タグ{% endtranslation %}を配置します。これでメール全体が囲まれるため、各文を個別に囲む必要はありません。
-
-
-
翻訳用にマークする
タグの使用がコネクタレベルで設定されている場合は、キャンペーンまたはキャンバスに翻訳タグを付けます。
-
Phrase TMSにインポートする
Phrase TMSで、 - - の順に進みます。タグ付けされたキャンペーンが選択肢として表示されます。
インポートする前に、ソースロケールとすべてのターゲットロケールがBrazeのキャンペーンまたはキャンバスに追加されていること(多言語設定)、およびソースロケールにソースコンテンツが含まれていることを確認してください。ターゲットロケールがアイテムに存在しない場合、コネクタで設定されたロケール形式が正しい場合でも、APC履歴でエラーが発生し、インポートは失敗します。ソースロケールが存在しないか空の場合、そのメッセージはエラーなしでジョブから除外されます。
-
翻訳とレビュー
翻訳者はPhraseのワークスペース内で翻訳を行います。HTMLと書式設定は自動的に保持されます。
-
エクスポートとプレビュー
完了したら、ローカライズされたバージョンをBrazeにエクスポートします。 - を使用してロケールを切り替え、確認します。
注意
Braze (Legacy)コネクタは、2026年11月30日に非推奨となります。このコネクタの新しいインスタンスは、2026年8月17日まで作成できます。非推奨になる日までに新しいコネクタへ移行してください。
完全な移行ガイドについては、レガシーコネクタの非推奨化を参照してください。
Braze向けのPhrase TMS統合により、シームレスなローカリゼーションを通じて、顧客エンゲージメントを高め、新規市場への進出を促進できます。この統合により、Brazeユーザーはメールテンプレートやコンテンツブロックを翻訳できるようになります。
翻訳可能なコンテンツ要素:
-
メールテンプレート(HTMLエディタで作成)
-
コンテンツブロック
コネクターにはいくつかの使用例があります。
-
プロジェクトマネージャは、ファイルをオンラインリポジトリからプロジェクトに直接追加できます。
-
提出者ポータルを設定して、提出者がオンラインリポジトリから直接リクエストにファイルを追加できるようにします。
-
プロジェクト自動作成(APC)を使用して、監視対象のドキュメントまたはフォルダのコンテンツの変更が検出されると、新しいプロジェクトが自動的に作成されるようにします。
-
新規または更新された翻訳可能なコンテンツのみがAPCをトリガーします。翻訳のエクスポートや翻訳対象外のコンテンツへの変更では、新しいプロジェクトは作成されません。
-
-
コネクターAPIを使用すると、通常はUIを介して手動で実行するステップを自動化できます。ウェブフックを使用すると、特定のイベント(ジョブのステータス変更など)をサードパーティのシステムに通知できます。
-
Settings
ページで、セクションまでスクロールします。
-
[コネクタ]をクリックします。
ページが開きます。
-
New connectorをクリックします。
ページが開きます。
-
Typeをに変更し、コネクターの名前を入力します。
-
ドロップダウンリストからBraze REST Endpoint URLを選択します。
-
にあるREST APIキーを入力します。
-
[接続テストTest connection] をクリックします。
-
成功すると、ボタンの横に小さなチェックマークが表示されます。
-
-
Show optional settingsをクリックして、追加のオプションを設定します:
-
インポートするコンテンツのタグIDを入力します。タグはBrazeのタグに一致する必要があります。
-
Add language mappingをクリックして、Brazeの言語をTMSの言語にマッピングします。
各Phrase言語は、一度に1つのBrazeロケールコードにのみマッピングできます。2つのBrazeコード(例:
daとvisitor_da)が両方とも同じPhrase言語にマッピングされている場合、コネクターは自動的にいずれかのコードを選択しますが、どちらのコードが選択されるかを制御する方法はありません。選択されなかったコードのジョブは作成に失敗し、コネクターはその言語に対してエラーをログに記録します。ジョブを作成するには、コネクターまたはAPCの言語マッピングで構成されたソースロケールとすべてのターゲットロケールが、個々のBrazeキャンバスまたはキャンペーンアイテム上に既に存在している必要があります。コネクターまたはAPCレベルでロケールを構成するだけでは不十分です。キャンバスにロケールがない場合、ソースまたはターゲットロケールがBrazeアイテムで構成されていないことを示すエラーが発生し、インポートは失敗します。インポートを再試行する前に、不足しているロケールをBrazeのキャンバスに直接追加してください。
-
を設定して、指定された日数以内に更新されたコンテンツのみをインポートします。0に設定すると、経過時間に関係なくすべてのコンテンツがインポートされます。
-
-
保存をクリックします。
コネクターがページの一覧に追加されます。