Messagerie multilingue

Ce guide explique comment définir la langue d’un utilisateur dans OneSignal et envoyer des messages dans leur langue préférée pour les notifications push, les emails et les messages in-app.

Définir la langue de l’utilisateur

OneSignal définit automatiquement la propriété language à partir de la langue de l’appareil lorsqu’un utilisateur est créé pour la première fois via les SDK web ou mobile. Vous pouvez également définir ou mettre à jour manuellement la langue de l’utilisateur en utilisant le code de langue à 2 lettres ISO 639-1 avec :

La méthode setLanguage du SDK.
Le champ language dans les API Créer un utilisateur ou Mettre à jour un utilisateur.
La colonne language dans l’Importateur CSV.

Consultez Langues prises en charge pour une liste des codes de langue valides.

Envoyer des messages en différentes langues

Utilisez les onglets ci-dessous pour voir les options de localisation par canal de messagerie.

Notifications push
Email
Messages in-app
SMS

Envoi depuis le tableau de bord

Depuis Messages > Push > Nouveau message ou Modèles, cliquez sur Ajouter des langues. Choisissez parmi :

Option 1 : Cases à cocher

Sélectionnez les langues que vous prenez en charge. Toute langue non sélectionnée reviendra à Any/English.

Utilisation de cases à cocher pour sélectionner les langues.

Option 2 : Importer le contenu linguistique

Utilisez le modèle fourni pour formater le message dans chaque langue.

Modale pour copier et coller des données à partir d'une feuille de calcul.

Copiez et collez le contenu dans le champ “Ajouter des langues”.

Prévisualisez le contenu pour vérifier, insérez le contenu, et de nouveaux onglets apparaîtront dans l’éditeur avec le contenu désigné rempli.

Option 3 : Contenu dynamique

Utilisez le Contenu dynamique qui implique la création et le téléchargement d’un fichier CSV avec les langues que vous prenez en charge.

Dépannage

Anglais requis : Incluez une ligne pour en par défaut.
Utilisez les en-têtes corrects : language_code, title, subtitle, message
Valeurs séparées par des virgules : Assurez-vous du formatage CSV approprié.
Langue non prise en charge : Si elle n’est pas listée dans l’interface ou le modèle, elle n’est pas prise en charge. Utilisez la meilleure option suivante et contactez support@onesignal.com.

L’éditeur du tableau de bord utilise un champ HTML standard. Les caractères spéciaux comme % peuvent causer des problèmes d’affichage dans les langues RTL. Ajoutez des marques RLM après ces caractères pour corriger les problèmes de formatage.

Envoi via API

Les champs contents et headings prennent en charge plusieurs langues :

  {
    "contents": {
      "en": "English content",
      "fr": "French content"
    },
    "headings": {
      "en": "English heading",
      "fr": "French heading"
    }
  }

Envoi depuis le tableau de bord

Depuis Messages > Email > Nouveau message ou Modèles, choisissez parmi :

Option 1 : Segments

Créez un segment pour chaque langue.
Créez un modèle par langue.
Envoyez chacun à son segment correspondant.

Option 2 : Syntaxe Liquid

Utilisez la syntaxe Liquid et la substitution de propriétés ou de tags pour créer des instructions conditionnelles dans le message et afficher le contenu approprié en fonction de la langue de l’utilisateur.

Liquid

{% assign language = subscription.language %}
{% if language == 'fr' %}
  Bonjour {{ name }}!
{% elsif language == 'es' %}
  Hola {{ name }}!
{% else %}
  Hi {{ name }}!
{% endif %}

Option 3 : Contenu dynamique

Utilisez le Contenu dynamique qui implique la création et le téléchargement d’un fichier CSV avec les langues que vous prenez en charge.

Envoi via API

En utilisant l’API Créer un message, vous pouvez :

Cibler des segments ou des filtres linguistiques comme vous le feriez avec le tableau de bord.
Créer des modèles de messages avec la syntaxe Liquid en utilisant custom_data, la substitution de propriétés ou de tags. Consultez Personnalisation des messages pour plus de détails sur ces options.

Exemple de personnalisation en masse avec custom_data :

Template

{% assign eid = message.custom_data.users[subscription.external_id] %}
Hi {{ eid.first_name }}, you have {{ eid.points }} points. Your level is {{ eid.level }}.

API Request

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user123", "user456"]
  },
  "custom_data": {
    "users": {
      "user123": { "first_name": "John", "points": "150", "level": "Gold" },
      "user456": { "first_name": "Sarah", "points": "200", "level": "Platinum" }
    }
  }
}

Le client voit :

“Hi John, you have 150 points. Your level is Gold.”
“Hi Sarah, you have 200 points. Your level is Platinum.”

Tableau de bord - Segments

Pour envoyer un message in-app spécifique à une langue pour chaque langue que vous devez prendre en charge :

Créez un segment pour chaque langue.
Créez un message in-app par langue.
Envoyez chacun à son segment correspondant.

Substitution de tags

Utilisez la syntaxe Liquid et la substitution de tags pour créer des instructions conditionnelles dans le message et afficher le contenu approprié en fonction des tags.

Seule la substitution de tags est prise en charge pour les messages in-app.

Envoi depuis le tableau de bord

Depuis Messages > SMS > Nouveau message ou Modèles, choisissez parmi :

Option 1 : Segments

Créez un segment pour chaque langue.
Créez un modèle par langue.
Envoyez chacun à son segment correspondant.

Option 2 : Contenu dynamique

Utilisez le Contenu dynamique qui implique la création et le téléchargement d’un fichier CSV avec les langues que vous prenez en charge.

Envoi via API

Les champs contents et headings prennent en charge plusieurs langues :

  {
    "contents": {
      "en": "English content",
      "fr": "French content"
    },
    "headings": {
      "en": "English heading",
      "fr": "French heading"
    }
  }

Langues prises en charge

Le code de langue correspond à la propriété utilisateur language au format ISO 639-1 à 2 lettres. Nous prenons en charge les codes de langue suivants.

Si le code de langue n’est pas inclus dans la fenêtre contextuelle et le modèle CSV, alors cette langue n’est pas prise en charge. Nous recommandons d’utiliser la meilleure langue suivante et de nous envoyer une demande de produit à support@onesignal.com

Langue	Code de langue
Anglais	en
Arabe	ar
Azéri	az
Bosniaque	bs
Catalan	ca
Chinois (simplifié)	zh-Hans
Chinois (traditionnel)	zh-Hant
Croate	hr
Tchèque	cs
Danois	da
Néerlandais	nl
Estonien	et
Finnois	fi
Français	fr
Géorgien	ka
Bulgare	bg
Allemand	de
Grec	el
Hindi	hi
Hébreu	he
Hongrois	hu
Indonésien	id
Italien	it
Japonais	ja
Coréen	ko
Letton	lv
Lituanien	lt
Malais	ms
Norvégien	nb
Persan	fa
Polonais	pl
Portugais	pt
Pendjabi	pa
Roumain	ro
Russe	ru
Serbe	sr
Slovaque	sk
Espagnol	es
Suédois	sv
Thaï	th
Turc	tr
Ukrainien	uk
Vietnamien	vi

Premiers pas et paramètres

Canaux de messagerie

Journeys

Audience et événements personnalisés

Analyses et intégrations

Confidentialité et sécurité

Messagerie multilingue

Définir la langue de l’utilisateur

Envoyer des messages en différentes langues

Envoi depuis le tableau de bord

Option 1 : Cases à cocher

Option 2 : Importer le contenu linguistique

Option 3 : Contenu dynamique

Dépannage

Envoi via API

Envoi depuis le tableau de bord

Option 1 : Segments

Option 2 : Syntaxe Liquid

Option 3 : Contenu dynamique

Envoi via API

Tableau de bord - Segments

Substitution de tags

Envoi depuis le tableau de bord

Option 1 : Segments

Option 2 : Contenu dynamique

Envoi via API

Langues prises en charge

​Définir la langue de l’utilisateur

​Envoyer des messages en différentes langues

​Envoi depuis le tableau de bord

​Option 1 : Cases à cocher

​Option 2 : Importer le contenu linguistique

​Option 3 : Contenu dynamique

​Dépannage

​Envoi via API

​Envoi depuis le tableau de bord

​Option 1 : Segments

​Option 2 : Syntaxe Liquid

​Option 3 : Contenu dynamique

​Envoi via API

​Tableau de bord - Segments

​Substitution de tags

​Envoi depuis le tableau de bord

​Option 1 : Segments

​Option 2 : Contenu dynamique

​Envoi via API

​Langues prises en charge

Définir la langue de l’utilisateur

Envoyer des messages en différentes langues

Envoi depuis le tableau de bord

Option 1 : Cases à cocher

Option 2 : Importer le contenu linguistique

Option 3 : Contenu dynamique

Dépannage

Envoi via API

Envoi depuis le tableau de bord

Option 1 : Segments

Option 2 : Syntaxe Liquid

Option 3 : Contenu dynamique

Envoi via API

Tableau de bord - Segments

Substitution de tags

Envoi depuis le tableau de bord

Option 1 : Segments

Option 2 : Contenu dynamique

Envoi via API

Langues prises en charge