多言語配信の設定 multilingual-delivery
Campaign web ユーザーインターフェイスでは、メール配信を多言語として設定し、プロファイルの優先言語に基づいてメッセージを送信できます。 環境設定を定義していない場合、メッセージはデフォルトの言語で送信されます。
多言語配信では、言語管理はバリアントに基づいています。 各バリアントは 1 つの言語を表します。 配信の作成時に、メッセージに必要な言語の数に一致する複数の言語のバリアントを追加できます。 また、これらのバリアントを追加した後は、いつでもデフォルト言語を変更できます。
現在、多言語機能は、メール、プッシュ通知、トランザクションメッセージおよび SMS で使用できます。
多言語配信を設定するには、次の主な手順に従います。
言語バリアントの追加 add-variant
言語バリアントを作成するには、次の手順に従います。
-
配信ダッシュボードで、鉛筆アイコンをクリックして配信コンテンツの編集画面にアクセスし、「言語を追加」をクリックします。
note important IMPORTANT 「言語を追加」ボタンは、ターゲットディメンションに 言語 スキーマが含まれている場合にのみ使用できます。 スキーマとターゲットディメンションについて詳しくは、詳細ドキュメントを参照してください。 
-
「言語を追加」ドロップダウンから、追加する言語を選択し、確定します。 プッシュ通知の場合は、CSV ファイルをアップロードして、すべての言語のバリアントを一度にインポートすることもできます。
最初に追加した言語は自動的にデフォルトに設定され、既存のコンテンツがデフォルトバージョンになります。 言語が追加されると、そのコンテンツは最初にデフォルト言語からコピーされます。
note NOTE このリストを通じて使用できる言語は、言語属性で定義された値（system、user、dbenum などの値）によって異なります。 定義済みリストの管理について詳しくは、このセクションを参照してください。 -
他の言語を追加するには、この手順を繰り返します。 言語パネルには、選択した言語のリスト、言語の数、デフォルト言語が表示されます。
例えば、英語、フランス語、スウェーデン語を選択した場合、これら 3 つの言語は以下のように表示されます。
言語バリアントの管理方法について詳しくは、この節を参照してください。
各バリアントのコンテンツの定義 define-content
言語を設定したら、言語ごとに配信のコンテンツを定義します。
-
配信コンテンツの編集画面で、左側の 言語 パネルから言語を選択します。
-
この言語のメッセージのコンテンツを定義します。 詳しくは、この節を参照してください。
-
各言語に対してこの操作を繰り返します。
配信をプレビューするには、「コンテンツをシミュレート」ボタンをクリックし、プロファイルを選択します。 プロファイルごとに適切なコンテンツが表示されていることを確認します。
言語バリアントの管理 manage-variant
左側のパネルには、すべての言語バリアント情報が表示されます。 すべての言語を削除するには、「展開」ボタンをクリックし、「すべてのバリアントを削除」をクリックします。
言語バリアントのリストで、次のアクションを実行できます。
- 編集：関連コンテンツを保持したまま、言語を変更します。
- デフォルトとして設定：言語をデフォルトとして設定します。 プロファイルに言語が定義されていない場合、メッセージはデフォルト言語で送信されます。
- 複製：この言語に対して定義されたコンテンツを複製し、別のバリアントを選択します。
- 削除：バリアントおよび関連するコンテンツを削除します。
CSV から言語バリアントをインポート（プッシュ通知） csv-upload
多言語コンテンツを含む CSV ファイルをアップロードして、すべての言語バリアントをすばやく作成できるようになりました。この機能は、コンテンツをオフラインで準備し、一括インポートできるようにすることで、多言語キャンペーンの作成を合理化します。
- 効率：複数の言語とそのコンテンツを 1 回の操作で追加します
- 一貫性：すべての言語バリアントをまたいで統一されたメッセージを確保します
- コラボレーション：コンテンツチームが使い慣れたスプレッドシートツールで翻訳を準備できるようにします
- 一括管理：大量の言語バリアントを簡単に管理および更新します
前提条件 csv-best-practices
CSV のインポートを確実に成功させるには、次のベストプラクティスに従ってください。
- 正確な列構造を使用：一部を空白のままに残しても、14 列すべてが CSV ファイルに含まれている必要があります。列が見つからないと、インポートエラーが発生します。別の順序を使用することもできますが、すべての列が存在する必要があります。
- 列名が正確に一致する：列名では大文字と小文字が区別されます。
Titleではなくtitle、Bbadgeではなくbadge、Localeではなくlocaleを使用してください。 - 小文字のロケールコードを使用：ロケールコードの形式は、
en_us、fr_fr、de_de（アンダースコア付きの小文字）です。en_USやen-usではありません。 - 必須列を入力：
locale列とlanguage列には、各行の値を含める必要があります。値が空の場合、インポートエラーが発生します。 - ロケールを一意に保つ：各ロケールコードは、CSV ファイルで 1 回だけ使用する必要があります。重複したロケールは拒否されます。
- UTF-8 として保存：国際文字を正しくサポートするために、常に UTF-8 エンコーディングを使用して CSV ファイルを保存します。
- 引用コンマを含むコンテンツ：タイトルまたはメッセージ本文にコンマが含まれる場合、次のようにフィールド全体を二重引用符で囲みます：
"Hello, welcome!"。 - 数値を正しく使用する：フラグ列（isContentAvailable、isMutableContent、silentPush）の場合は、true に
1を使用し、false に0を使用するか、デフォルトで空白のままにします。 - JSON 形式を検証：customFields 列を使用する場合は、JSON が正しくフォーマットされていることを確認してください：
{"key":"value"}（引用符と角括弧が正しいこと）。 - 最小限のデータでテストを開始：大きなファイルを作成する前に、単純な 2 ～ 3 言語の CSV から形式を検証します。
CSV ファイルをインポート csv-steps
CSV ファイルから言語バリアントを読み込むには、次の手順に従います。
-
配信コンテンツエディターから、「言語を追加」をクリックします。
-
CSV ファイルをアップロード領域にドラッグ & ドロップして選択するか、クリックしてコンピュータを参照します。
システムによってファイル形式とコンテンツが検証されます。検証が失敗した場合、エラーメッセージは、どの列またはデータが正しくないかを示します。CSV ファイルの問題を修正し、再度アップロードします。こちらを参照してください。
-
言語バリアントパネルでインポートされたコンテンツを確認して、すべての翻訳が正しく読み込まれることを確認します。
列構造 csv-columns
使用する正しい列構造は次のとおりです。
- title：通知タイトル（必須）
- messageBody：通知メッセージ本文（必須）
- sound：音声ファイル名（例：
default、custom_sound.mp3） – デフォルトでは空白のままにします - badge：アプリアイコンに表示するバッジ番号（iOS） – 番号のみを使用
- deeplinkURI：通知がタップされたときに開くディープリンク URL。使用しない場合は空白のままにします
- category：カスタムアクションの通知カテゴリ ID （iOS） – 使用しない場合は空白のままにします
- iosMediaAttachmentURL：iOS 通知のメディア添付ファイルのURL – 使用しない場合は空白のままにします
- androidMediaAttachmentURL：Android 通知のメディア添付ファイルの URL – 使用しない場合は空白のままにします
- isContentAvailable：コンテンツ利用可能フラグ（iOS）- true には
1を使用し、false には0を使用し、デフォルト（0）では空白のままにします - isMutableContent：可変コンテンツフラグ（iOS）- true には
1を使用し、false には0を使用し、デフォルト（0）では空白のままにします - customFields: JSON 形式のカスタムデータ（例：
{"key1":"value1","key2":"value2"}）– 使用しない場合は空白のままにします - ロケール：言語コード（必須）- 例：
en_us、fr_fr、de_de- 必須、行ごとに一意である必要があります - 言語：言語名（必須）- 例：
English-United States、French-France- 必須 - silentPush: サイレントプッシュフラグ – サイレントプッシュには
1を使用し、通常のプッシュには0を使用し、デフォルト（0）では空白のままにします
CSV ファイルの例 csv-examples
以下は、必須フィールドを使用した基本的な例です。
title,messageBody,sound,badge,deeplinkURI,category,iosMediaAttachmentURL,androidMediaAttachmentURL,isContentAvailable,isMutableContent,customFields,locale,language,silentPush
Welcome!,Thank you for joining us,,,,,,,,,, en_us,English-United States,0
Bienvenue !,Merci de nous avoir rejoint,,,,,,,,,,fr_fr,French-France,0
Willkommen!,Vielen Dank für Ihre Anmeldung,,,,,,,,,, de_de,German-Germany,0
¡Bienvenido!,Gracias por unirte a nosotros,,,,,,,,,, es_es,Spanish-Spain,0
以下は、オプションのフィールドを使用した例です。
title,messageBody,sound,badge,deeplinkURI,category,iosMediaAttachmentURL,androidMediaAttachmentURL,isContentAvailable,isMutableContent,customFields,locale,language,silentPush
Welcome!,Thank you for joining us,default,1,,,https://example.com/welcome-en.jpg,https://example.com/welcome-en.jpg,,,, en_us,English-United States,0
Bienvenue !,Merci de nous avoir rejoint,default,1,,,https://example.com/welcome-fr.jpg,https://example.com/welcome-fr.jpg,,,, fr_fr,French-France,0
Willkommen!,Vielen Dank für Ihre Anmeldung,default,1,,,https://example.com/welcome-de.jpg,https://example.com/welcome-de.jpg,,,, de_de,German-Germany,0
¡Bienvenido!,Gracias por unirte a nosotros,default,1,,,https://example.com/welcome-es.jpg,https://example.com/welcome-es.jpg,,,, es_es,Spanish-Spain,0
以下は、カスタムフィールドを使用した例です
title,messageBody,sound,badge,deeplinkURI,category,iosMediaAttachmentURL,androidMediaAttachmentURL,isContentAvailable,isMutableContent,customFields,locale,language,silentPush
New Collection,Discover our latest products,default,1,,,,,,,"{"campaign":"summer2025","segment":"premium"}",en_us,English-United States,0
Nouvelle Collection,Découvrez nos derniers produits,default,1,,,,,,,"{"campaign":"summer2025","segment":"premium"}",fr_fr,French-France,0
CSV ファイル内のパーソナライズ機能 csv-personalization
CSV コンテンツでパーソナライゼーションフィールドを使用するには、<span> タグを使用する必要があります。
title,messageBody,sound,badge,deeplinkURI,category,iosMediaAttachmentURL,androidMediaAttachmentURL,isContentAvailable,isMutableContent,customFields,locale,language,silentPush
"Hello <span class=""nl-dce-field nl-dce-done"" data-nl-expr=""recipient.firstName"">recipient.firstName</span>","Your order has shipped!",,,,,,,,,,en_us,English-United States,0
"Bonjour <span class=""nl-dce-field nl-dce-done"" data-nl-expr=""recipient.firstName"">recipient.firstName</span>","Votre commande a été expédiée !",,,,,,,,,,fr_fr,French-France,0
配信中、Campaign はこれらのプレースホルダーを実際の受信者データに置き換えます。
トラブルシューティング csv-troubleshooting
{"key":"value"}または、空白のままにしますBadge や BADGE ではなく badge を使用します）。ベストプラクティスについて詳しくは、このセクションを参照してください。列の構造について詳しくは、このセクションを参照してください。