Définir la langue et les paramètres régionaux des utilisateurs

Choisissez le signal qui détermine la langue dans laquelle un consommateur reçoit vos messages, puis définissez cette valeur dans le profil utilisateur afin que vos Campaigns et Canvas localisés ciblent la bonne audience.

À propos de cet exemple

UponVoyage, une marque de voyage fictive, personnalise ses messages pour des consommateurs répartis sur douze marchés. L’équipe marketing déduit la langue à partir d’un attribut personnalisé market, qui correspond au pays depuis lequel le consommateur réserve son voyage aller. Cet attribut désigne une région et non une langue : les consommateurs qui réservent depuis un pays multilingue, ou depuis un autre pays que le leur, peuvent donc recevoir des messages dans la mauvaise langue.

Cet exemple compare trois signaux permettant de déterminer la langue d’un consommateur et montre comment définir chacun d’eux dans le profil :

• Langue collectée par le SDK : L’attribut standard language, capturé à partir des paramètres régionaux de l’appareil ou du navigateur
• Préférence linguistique explicite : Une valeur choisie par le consommateur dans votre application ou sur votre site, définie via le SDK ou la REST API
• Attribut personnalisé de marché ou de région : Un attribut métier tel que market, utilisé lorsque votre contenu varie selon la région plutôt que selon la langue

language et country sont deux attributs standard distincts dans Braze. Lorsque les variantes régionales comptent (par exemple, l’espagnol d’Espagne par rapport à l’espagnol d’Amérique latine), ciblez les deux attributs plutôt que de stocker une chaîne de caractères combinant langue et région.

Cet exemple montre comment choisir un signal linguistique et le définir dans le profil. Pour stocker et envoyer des contenus traduits, consultez Comparer les approches de traduction.

Points à prendre en compte

• Le pays provient d’abord de la géolocalisation IP. Braze identifie country grâce à la géolocalisation de l’adresse IP. Si la géolocalisation n’est pas disponible, Braze identifie country à partir des paramètres régionaux de l’appareil. Ne considérez donc pas country comme une valeur déclarée par l’appareil. Pour en savoir plus, consultez Collecte de données du SDK.
• La collecte de la langue est facultative et peut être désactivée. language fait partie des données facultatives collectées par défaut : une intégration minimale ou une liste d’autorisation des propriétés de l’appareil peut donc l’exclure. Vérifiez que votre intégration la collecte toujours avant de vous y fier. Pour en savoir plus, consultez Stockage.
• Les paramètres régionaux les plus récents de l’appareil peuvent être absents. Tous les consommateurs n’ont pas de valeur : prévoyez une langue de repli pour les messages qui s’appuient sur ce champ.
• Définir une valeur explicitement interrompt la collecte automatique. Dès que vous définissez language ou country via le SDK, la REST API ou un import CSV, Braze cesse de mettre à jour automatiquement ce champ pour ce consommateur. Anticipez la façon dont un consommateur pourra modifier sa préférence par la suite.
• Les valeurs explicites consomment des points de données. Les mises à jour d’attributs via le SDK et l’API enregistrent des points de données, contrairement à la collecte automatique. Pour en savoir plus, consultez Points de données.
• language doit être un code ISO 639-1. Utilisez des codes à deux lettres comme en ou nl. Pour connaître les codes pris en charge, consultez Codes de langue. country utilise des codes ISO 3166-1 alpha-2 comme GB ou BE.
• Modifier votre modèle linguistique a un impact sur les ressources existantes. Lorsque vous passez d’un attribut personnalisé aux attributs standard, auditez les Campaigns, Canvas, Segments et le code Liquid qui font référence à l’ancien attribut avant de le retirer.

Configuration

Étape 1 : Choisir le signal qui détermine la langue

Lorsque vous pouvez collecter une préférence explicite, utilisez-la comme signal principal, avec language collecté par le SDK comme solution de repli. Un attribut market est un mauvais substitut pour déduire la langue dans des pays multilingues comme la Belgique, le Canada ou la Suisse.

Étape 2 : Vérifier ce que votre intégration collecte déjà

1. Accédez à Audience > Recherche d’utilisateurs, ouvrez un profil de consommateur et vérifiez les champs Langue et Pays.
2. Si le champ Langue est vide dans l’ensemble des profils, vérifiez que votre intégration SDK ne l’exclut pas de la collecte des propriétés de l’appareil.
3. Notez si le champ Paramètres régionaux les plus récents de l’appareil est renseigné. Utilisez-le pour le diagnostic, mais ne l’utilisez pas pour le ciblage sans solution de repli.

Étape 3 : Définir une préférence linguistique explicite

Suivez cette étape uniquement si vous avez choisi une préférence linguistique explicite à l’étape 1. Pour language collecté par le SDK, vérifiez la collecte à l’étape 2, puis passez directement au ciblage. Pour un attribut personnalisé market ou de région, définissez cet attribut via le SDK ou la REST API, puis poursuivez avec les étapes 4 à 6 selon vos besoins.

Lorsqu’un consommateur choisit une langue, envoyez ce choix à Braze afin qu’il prime sur la collecte automatique.

Définissez la valeur via le SDK lorsque le choix est effectué dans votre application ou sur votre site. Pour connaître les noms des méthodes sur chaque plateforme, consultez Définir des attributs utilisateur.

Pour les préférences stockées dans vos propres systèmes, envoyez les attributs standard via l’endpoint /users/track :

1
2
3
4
5
6
7
8
9

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

Remplacez YOUR_EXTERNAL_ID par l’identifiant du consommateur dont la préférence a changé.

Étape 4 : Définir le pays lorsqu’un consommateur indique une région

Définissez country explicitement lorsqu’un consommateur vous indique sa région, par exemple lorsqu’il navigue sur un site propre à un pays ou sélectionne un marché lors de son inscription. Utilisez la même requête /users/track ou la même méthode SDK qu’à l’étape précédente.

Si vous souhaitez que le pays basé sur l’adresse IP continue à se mettre à jour, ne définissez pas country explicitement. Choisissez une seule source par consommateur et appliquez-la de manière cohérente.

Étape 5 : Cibler les messages selon la langue et le pays

1. Créez des Segments avec les filtres Langue et Pays plutôt qu’avec un attribut combinant langue et région.
2. Pour les messages qui varient selon la région au sein d’une même langue, filtrez sur les deux attributs, par exemple language est es et country est ES.
3. Pour envoyer un message unique qui s’affiche selon les paramètres régionaux, ajoutez des paramètres régionaux à l’aide des attributs de langue et de pays par défaut, puis consultez Messages multilingues.
4. Si vous conservez un attribut market pour le contenu régional, ajoutez des paramètres régionaux basés sur des attributs personnalisés au lieu de faire correspondre cet attribut à une langue.

Étape 6 : Abandonner un modèle linguistique basé sur le marché

1. Recherchez dans votre espace de travail les Campaigns, Canvas, Segments et Content Blocks qui font référence à l’attribut market.
2. Renseignez rétroactivement language pour les profils existants via un import CSV ou l’API lorsque vous connaissez déjà la préférence d’un consommateur.
3. Mettez à jour vos ressources pour filtrer sur Langue, en ne conservant l’attribut market que là où le contenu varie selon la région.
4. Vérifiez que chaque version localisée s’affiche comme prévu avec Prévisualiser le message en tant qu’utilisateur avant de retirer l’ancien attribut.

Articles connexes

• Attributs standard
• Collecte de données du SDK
• Codes de langue
• Définir des attributs utilisateur
• Objet des attributs utilisateur
• Paramètres de localisation
• Messages multilingues
• Comparer les approches de traduction