対応チャネル
- アプリプッシュ
- Webプッシュ
- アプリ内ポップアップ
- Webポップアップ
多言語メッセージを使うには、プロジェクトでこの機能が有効になっている必要があります。
1. 多言語メッセージを有効にする
キャンペーンとユーザージャーニーでは、設定をオンにする場所が異なります。キャンペーン
- キャンペーンの作成画面で、アプリプッシュ、ウェブプッシュ、アプリ内メッセージ、ウェブ内メッセージのいずれかを選択します。
- 高度な設定 を開きます。
- 多言語メッセージを使用 をオンにします。
ユーザージャーニー
- メッセージノードを追加するか、既存のメッセージノードを開きます。
- アプリプッシュ、ウェブプッシュ、アプリ内メッセージ、ウェブ内メッセージのいずれかを選択します。
- 多言語メッセージを使用 をオンにします。
2. プッシュ通知を作成する
アプリプッシュとWebプッシュでは、作成画面でデフォルトのメッセージと言語別のメッセージを入力します。2-1. デフォルトのメッセージを作成する
デフォルト には、ユーザーの言語に一致するメッセージがない場合に送るタイトルと本文を入力します。 デフォルトのメッセージだけを読んでも、内容と次に取るべき操作が分かるようにしてください。2-2. 言語を追加する
- 言語を追加 を選択します。
- 言語を検索 欄に、
jaなどの言語コード、または「日本語」など選択肢に表示される言語名を入力します。 - 追加する言語を選択します。
- その言語で送信するメッセージを入力します。
2-3. 翻訳の下書きを自動入力する
デフォルトのメッセージをもとに、追加した言語のタイトルと本文を自動入力できます。- デフォルトのタイトルと本文を入力します。
- 必要な言語を追加します。
- N言語を自動入力 を選択します。ボタンの数字は、自動入力の対象となる言語の数です。
- 生成された翻訳を確認し、必要に応じて修正します。
2-4. 広告メッセージを作成する
3. ポップアップテンプレートを設定する
アプリ内ポップアップやWebポップアップを出し分けるには、先にテンプレートを用意します。- 使用する言語ごとにポップアップテンプレートを作成します。
- アプリ内ポップアップ:アプリ内ポップアップテンプレートの作成
- Webポップアップ:Webポップアップテンプレートの作成
- 作成画面の デフォルト で、該当する言語がない場合に使うテンプレートを選択します。
- 言語を追加 から使用する言語を選びます。
- 追加した言語を選択し、その言語用に作成したテンプレートを指定します。
4. ユーザーの言語を設定する
通常、Notiflyはユーザー属性の$locale、最後に確認した言語 $last_observed_locale の順に照合します。それぞれコード全体、言語部分の順に確認し、どちらの値でも一致しなければ、デフォルトのメッセージまたはポップアップテンプレートを使います。
サービスでユーザーが言語を選べる場合は、その選択を $locale に保存します。
4-1. $locale を保存する
ユーザーがログインしたときやサービス内で言語を変更したときに、Notifly SDKの setUserProperties を呼び出して $locale を保存します。
- Android
- iOS
- JavaScript
- React Native
- Flutter
setUserId でユーザーを識別してから setUserProperties を呼び出します。アプリやWebサイトでユーザーが言語を変更した場合も、$locale を保存し直します。
SDKごとの詳しい呼び出し方は、Android SDK、iOS SDK、JavaScript SDK、React Native SDK、Flutter SDKの各ガイドをご覧ください。
4-2. 言語コードの形式
$locale にはBCP 47形式の言語コードを保存します。メッセージの作成画面で追加した言語と同じコードを使います。
en-US、ko-KR、ja-JP のように地域コードを含めることもできます。たとえば、$locale が en-US なら、まず en-US のメッセージを探し、なければ en のメッセージを探します。
4-3. 送信する言語の例
以下は、$last_observed_locale に値がない場合の例です。
5. 送信前に確認する
プッシュ通知
- デフォルトのメッセージだけで内容が伝わるかを確認します。
- 追加したすべての言語にチェックマークが表示されているかを確認します。
- 言語ごとにLiquidの変数、画像、リンクを確認します。
- 自動入力を使った場合は、表現と変数の位置を確認します。
- 広告メッセージの場合は、言語ごとに広告表記と配信停止の案内を確認します。
ポップアップ
- デフォルト と追加したすべての言語に、正しいテンプレートを設定したかを確認します。
- テンプレートの文言、画像、ボタン、リンクが言語に合っているかを確認します。
