> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifly.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# 多言語メッセージ

> キャンペーンやユーザージャーニーで言語別のプッシュ通知を作成し、ポップアップテンプレートを設定します。

1つのキャンペーンやユーザージャーニーで、ユーザーの言語に合わせてプッシュ通知やポップアップを出し分けられます。ユーザーの言語に対応するメッセージやテンプレートがない場合は、**デフォルト** の内容を使います。

## 対応チャネル

* アプリプッシュ
* Webプッシュ
* アプリ内ポップアップ
* Webポップアップ

> [!NOTE]
>
> 多言語メッセージを使うには、プロジェクトでこの機能が有効になっている必要があります。

## 1. 多言語メッセージを有効にする

キャンペーンとユーザージャーニーでは、設定をオンにする場所が異なります。

### キャンペーン

1. キャンペーンの作成画面で、**アプリプッシュ**、**ウェブプッシュ**、**アプリ内メッセージ**、**ウェブ内メッセージ**のいずれかを選択します。
2. **高度な設定** を開きます。
3. **多言語メッセージを使用** をオンにします。

### ユーザージャーニー

1. メッセージノードを追加するか、既存のメッセージノードを開きます。
2. **アプリプッシュ**、**ウェブプッシュ**、**アプリ内メッセージ**、**ウェブ内メッセージ**のいずれかを選択します。
3. **多言語メッセージを使用** をオンにします。

設定をオンにすると、作成画面に **デフォルト** タブが表示されます。

## 2. プッシュ通知を作成する

アプリプッシュとWebプッシュでは、作成画面でデフォルトのメッセージと言語別のメッセージを入力します。

### 2-1. デフォルトのメッセージを作成する

**デフォルト** には、ユーザーの言語に一致するメッセージがない場合に送るタイトルと本文を入力します。

デフォルトのメッセージだけを読んでも、内容と次に取るべき操作が分かるようにしてください。

### 2-2. 言語を追加する

1. **言語を追加** を選択します。
2. **言語を検索** 欄に、`ja` などの言語コード、または「日本語」など選択肢に表示される言語名を入力します。
3. 追加する言語を選択します。
4. その言語で送信するメッセージを入力します。

メッセージの入力が完了するとチェックマークが表示されます。必須項目が空欄の場合や、Liquidの構文に誤りがある場合は、感嘆符が表示されます。

### 2-3. 翻訳の下書きを自動入力する

デフォルトのメッセージをもとに、追加した言語のタイトルと本文を自動入力できます。

1. デフォルトのタイトルと本文を入力します。
2. 必要な言語を追加します。
3. **N言語を自動入力** を選択します。ボタンの数字は、自動入力の対象となる言語の数です。
4. 生成された翻訳を確認し、必要に応じて修正します。

自動入力の対象は空欄だけです。入力済みのタイトルや本文は上書きされません。

> [!WARNING]
>
> 自動翻訳の結果は下書きです。ブランドで使う用語、変数の位置、リンク、Liquidの構文を確認してから保存してください。

### 2-4. 広告メッセージを作成する

> [!WARNING]
>
> 多言語メッセージでは、広告メッセージに必要な表示は自動では追加されません。
>
> 言語ごとに、必要な広告表記と配信停止の案内を追加してください。適用される法令を順守する責任は、送信者にあります。

## 3. ポップアップテンプレートを設定する

アプリ内ポップアップやWebポップアップを出し分けるには、先にテンプレートを用意します。

1. 使用する言語ごとにポップアップテンプレートを作成します。
   * アプリ内ポップアップ：[アプリ内ポップアップテンプレートの作成](https://docs.notifly.tech/ja/user-guide/channel/in-app-message/guide.md#3-%E3%83%A1%E3%83%83%E3%82%BB%E3%83%BC%E3%82%B8%E3%82%92%E8%A8%AD%E5%AE%9A%E3%81%99%E3%82%8B)
   * Webポップアップ：[Webポップアップテンプレートの作成](https://docs.notifly.tech/ja/user-guide/channel/web-message/guide.md#1-%E3%83%9D%E3%83%83%E3%83%97%E3%82%A2%E3%83%83%E3%83%97%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%E3%82%92%E4%BD%9C%E6%88%90%E3%81%99%E3%82%8B)
2. 作成画面の **デフォルト** で、該当する言語がない場合に使うテンプレートを選択します。
3. **言語を追加** から使用する言語を選びます。
4. 追加した言語を選択し、その言語用に作成したテンプレートを指定します。

ユーザーの言語に対応するテンプレートがない場合は、**デフォルト** で選択したテンプレートが表示されます。ポップアップテンプレートは自動では翻訳されません。

## 4. ユーザーの言語を設定する

通常、Notiflyはユーザー属性の `$locale`、最後に確認した言語 `$last_observed_locale` の順に照合します。それぞれコード全体、言語部分の順に確認し、どちらの値でも一致しなければ、デフォルトのメッセージまたはポップアップテンプレートを使います。

サービスでユーザーが言語を選べる場合は、その選択を `$locale` に保存します。

### 4-1. `$locale` を保存する

ユーザーがログインしたときやサービス内で言語を変更したときに、Notifly SDKの `setUserProperties` を呼び出して `$locale` を保存します。

> [tab] Android
>
> ```kotlin theme={null}
> Notifly.setUserProperties(
>     context,
>     mapOf("\$locale" to "zh-TW")
> )
> ```

> [tab] iOS
>
> ```swift theme={null}
> Notifly.setUserProperties(
>     userProperties: ["$locale": "zh-TW"]
> )
> ```

> [tab] JavaScript
>
> ```javascript theme={null}
> notifly.setUserProperties({
>   "$locale": "zh-TW",
> });
> ```

> [tab] React Native
>
> ```javascript theme={null}
> notifly.setUserProperties({
>   "$locale": "zh-TW",
> });
> ```

> [tab] Flutter
>
> ```dart theme={null}
> await NotiflyPlugin.setUserProperties({
>   r'$locale': 'zh-TW',
> });
> ```

ログイン直後に設定する場合は、`setUserId` でユーザーを識別してから `setUserProperties` を呼び出します。アプリやWebサイトでユーザーが言語を変更した場合も、`$locale` を保存し直します。

SDKごとの詳しい呼び出し方は、[Android SDK](https://docs.notifly.tech/ja/developer-guide/android-sdk.md)、[iOS SDK](https://docs.notifly.tech/ja/developer-guide/ios-sdk.md)、[JavaScript SDK](https://docs.notifly.tech/ja/developer-guide/javascript-sdk.md)、[React Native SDK](https://docs.notifly.tech/ja/developer-guide/react-native-sdk.md)、[Flutter SDK](https://docs.notifly.tech/ja/developer-guide/flutter-sdk.md)の各ガイドをご覧ください。

### 4-2. 言語コードの形式

`$locale` にはBCP 47形式の言語コードを保存します。メッセージの作成画面で追加した言語と同じコードを使います。

| 言語 | 推奨コード |
| - | - |
| 韓国語 | `ko` |
| 英語 | `en` |
| 日本語 | `ja` |
| フランス語 | `fr` |
| 中国語（簡体字） | `zh-CN` |
| 中国語（繁体字） | `zh-TW` |

`en-US`、`ko-KR`、`ja-JP` のように地域コードを含めることもできます。たとえば、`$locale` が `en-US` なら、まず `en-US` のメッセージを探し、なければ `en` のメッセージを探します。

> [!WARNING]
>
> 中国語には、メッセージの作成画面で使用するコードを指定してください。
>
> * 中国語（簡体字）は `zh-CN` を指定します。
> * 中国語（繁体字）は `zh-TW` を指定します。
> * `zh-Hans`、`zh-Hant`、`zh-Hans-TW` は使用しないでください。
>
> `zh-Hans` と `zh-Hant` は有効なBCP 47の言語タグです。Notiflyの中国語メッセージには、上記の `zh-CN` または `zh-TW` を使ってください。

### 4-3. 送信する言語の例

以下は、`$last_observed_locale` に値がない場合の例です。

| `$locale` | 作成済みの言語別メッセージ | 送信されるメッセージ |
| - | - | - |
| `ko` | `ko` | 韓国語 |
| `ko-KR` | `ko` | 韓国語 |
| `en-US` | `en` | 英語 |
| `zh-CN` | `zh-CN` | 中国語（簡体字） |
| `zh-TW` | `zh-TW` | 中国語（繁体字） |
| `zh-Hant` | `zh-TW` | デフォルトのメッセージ |
| `ja` | 日本語のメッセージなし | デフォルトのメッセージ |
| `$locale` も `$last_observed_locale` もなし | 該当なし | デフォルトのメッセージ |

## 5. 送信前に確認する

### プッシュ通知

* デフォルトのメッセージだけで内容が伝わるかを確認します。
* 追加したすべての言語にチェックマークが表示されているかを確認します。
* 言語ごとにLiquidの変数、画像、リンクを確認します。
* 自動入力を使った場合は、表現と変数の位置を確認します。
* 広告メッセージの場合は、言語ごとに広告表記と配信停止の案内を確認します。

### ポップアップ

* **デフォルト** と追加したすべての言語に、正しいテンプレートを設定したかを確認します。
* テンプレートの文言、画像、ボタン、リンクが言語に合っているかを確認します。

プッシュ通知とポップアップのどちらでも、ユーザー属性の言語コードが追加した言語と一致しているかを確認してください。

### A/Bテストキャンペーン

A/Bテストでも多言語メッセージを使用できます。テストグループごとに、言語別のプッシュ通知を入力するか、ポップアップテンプレートを選択します。コントロールグループにはメッセージが送信されません。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.