ユーザーの言語とロケールを設定する

消費者が受け取る言語を決定するシグナルを選択し、その値をユーザープロファイルに設定することで、ローカライズされたキャンペーンやキャンバスが適切なオーディエンスをターゲットにできるようにします。

この例について

架空の旅行ブランドであるUponVoyageは、12 の市場の消費者に向けてメッセージをパーソナライズしています。マーケティングチームは、消費者が出発便を予約した国に設定される market カスタム属性から言語を導き出しています。この属性は言語ではなく地域に対応しているため、多言語国から予約する消費者や、自国以外の国から予約する消費者が、誤った言語のメッセージを受け取る可能性があります。

この例では、消費者の言語を判断する 3 つのシグナルを比較し、それぞれをプロファイルに設定する方法を示します。

• SDKで収集された言語: デバイスまたはブラウザーのロケールから取得される language 標準属性項目
• 明示的な言語設定: 消費者がアプリやサイトで選択し、SDK または REST APIを通じて設定される値
• 市場または地域のカスタム属性: market などのビジネス属性。コンテンツが言語ではなく地域によって異なる場合に使用します

Brazeでは、language と country は別々の標準属性項目です。地域ごとのバリアントが重要な場合 (たとえば、ヨーロッパのスペイン語とラテンアメリカのスペイン語)、ロケールを結合した文字列を保存するのではなく、両方の属性をターゲットにしてください。

この例では、言語シグナルを選択してプロファイルに設定する方法を示します。翻訳済みのコピーの保存と送信については、翻訳アプローチを比較するを参照してください。

考慮事項

• 国はまず IP ジオロケーションから取得されます。Brazeは IP アドレスのジオロケーションによって country を識別します。ジオロケーションが利用できない場合、Brazeはデバイスのロケールによって country を識別します。country をデバイスから報告される値として扱わないでください。詳細については、SDK データ収集を参照してください。
• 言語の収集はオプションであり、オフにできます。language はデフォルトで収集されるオプションのデータであるため、最小限の統合やデバイスプロパティの許可リストによって除外される場合があります。これに依存する前に、統合で引き続き収集されていることを確認してください。詳細については、ストレージを参照してください。
• 最新のデバイスロケールが存在しない場合があります。すべての消費者に値があるとは限らないため、これを使用するメッセージにはフォールバック言語を用意してください。
• 値を明示的に設定すると、自動収集が停止します。SDK、REST API、または CSV インポートを通じて language または country を設定すると、Brazeはその消費者のそのフィールドの自動更新を停止します。消費者が後で設定を変更する方法を計画してください。
• 明示的な値はデータポイントを消費します。SDKとAPIによる属性の更新はデータポイントを記録しますが、自動収集では記録されません。詳細については、データポイントを参照してください。
• language は ISO 639-1 コードである必要があります。en や nl などの 2 文字のコードを使用してください。サポートされているコードについては、言語コードを参照してください。country には GB や BE などの ISO 3166-1 alpha-2 コードを使用します。
• 言語モデルを変更すると、既存のアセットに影響します。カスタム属性から標準属性項目に移行する場合は、古い属性を廃止する前に、その属性を参照しているキャンペーン、キャンバス、セグメント、Liquid を監査してください。

設定

ステップ 1: 言語を決定するシグナルを選択する

明示的な設定を収集できる場合は、それを主要なシグナルとして使用し、SDKで収集された language にフォールバックしてください。ベルギー、カナダ、スイスなどの多言語国では、market 属性は言語を推測するための代替としては不十分です。

ステップ 2: 統合ですでに収集されている内容を確認する

1. オーディエンス > ユーザー検索に移動し、消費者のプロファイルを開いて、言語と国のフィールドを確認します。
2. プロファイル全体で言語が空の場合は、SDK 統合がデバイスプロパティの収集からそれを除外していないことを確認します。
3. 最新のデバイスロケールが入力されているかどうかを確認します。これは診断に使用し、フォールバックなしでターゲティングに使用しないでください。

ステップ 3: 明示的な言語設定を行う

このステップは、ステップ 1 で明示的な言語設定を選択した場合にのみ使用してください。SDKで収集された language の場合は、ステップ 2 で収集を確認してからターゲティングに進んでください。market または地域のカスタム属性の場合は、SDK または REST APIを通じてその属性を設定し、必要に応じてステップ 4 から 6 に進んでください。

消費者が言語を選択したら、その選択をBrazeに送信して、自動収集よりも優先されるようにします。

選択がアプリやサイトで行われる場合は、SDKを通じて値を設定します。各プラットフォームのメソッド名については、ユーザー属性の設定を参照してください。

自社システムに保存されている設定については、/users/track エンドポイントを通じて標準属性項目を送信します。

1
2
3
4
5
6
7
8
9

{
  "attributes": [
    {
      "external_id": "{YOUR_EXTERNAL_ID}",
      "language": "nl",
      "country": "BE"
    }
  ]
}

YOUR_EXTERNAL_ID を、設定が変更された消費者の識別子に置き換えます。

ステップ 4: 消費者が地域を示したときに国を設定する

消費者が地域を示した場合 (たとえば、国別のサイトを閲覧したときや、登録時に市場を選択したとき) は、country を明示的に設定します。前のステップと同じ /users/track リクエストまたは SDK メソッドを使用してください。

IP ベースの国を引き続き更新したい場合は、country を明示的に設定しないでください。消費者ごとに 1 つの情報源を選択し、一貫して適用してください。

ステップ 5: 言語と国でメッセージをターゲットにする

1. ロケールを結合した属性ではなく、言語フィルターと国フィルターを使用してセグメントを作成します。
2. 同じ言語内で地域ごとに異なるメッセージの場合は、両方の属性でフィルターします。たとえば、language が es で、country が ES の場合などです。
3. ロケールごとにレンダリングされる 1 つのメッセージを送信するには、デフォルトの言語属性と国属性を使用してロケールを追加し、多言語メッセージを参照してください。
4. 地域別コンテンツのために market 属性を保持する場合は、その属性を言語に対応付けるのではなく、カスタム属性に基づいてロケールを追加してください。

ステップ 6: 市場ベースの言語モデルから移行する

1. ワークスペースで、market 属性を参照しているキャンペーン、キャンバス、セグメント、Content Blocks を検索します。
2. 消費者の設定がすでにわかっている場合は、CSV インポートまたはAPIを通じて既存のプロファイルの language をバックフィルします。
3. 言語でフィルターするようにアセットを更新し、market 属性はコンテンツが地域によって異なる場合にのみ保持します。
4. 古い属性を廃止する前に、ユーザーとしてメッセージをプレビューで各ロケールが期待どおりにレンダリングされることを確認します。

関連記事

• 標準属性項目
• SDK データ収集
• 言語コード
• ユーザー属性の設定
• ユーザー属性オブジェクト
• ローカライゼーション設定
• 多言語メッセージ
• 翻訳アプローチを比較する