Tech | 

11/05/2020

API Transactionnelle : Définissez les messages de vos Push et Mobile Landings par langue ! 🌎

Délivrez une expérience plus personnalisée pour vos utilisateurs

Guillaume Perrudin

Software Engineer @ Batch

L'API transactionnelle de Batch est conçue pour envoyer des push en 1 to 1. Nouveau message, demande d'ami, limite atteinte de plafond, commande livrée... Elle participe à une meilleure expérience de l'utilisation de l'app, la rendant plus personnalisée.

Nous l'avons récemment mise à jour pour permettre de définir des messages et contenus de mobile landing en fonction de la langue de l'utilisateur.

Les campagnes lancées depuis le dashboard ou l'API Campaigns ont toujours supporté la localisation / le multi-lingue. C'est par simple souci de cohérence donc que nous ajoutons cette fonctionnalité pour l'API Transactionnelle. En recourant aux mêmes clés que sur l'API Campaigns.

Votre backend n'a désormais plus à connaître la langue des utilisateurs. Vous n'avez plus qu'à définir les messages et contenus de landing par langue : Batch s'occupe du reste !

Comment ça marche ?

Messages des push localisés

Avant cette mise à jour, l'API n'acceptait qu'un champ message, qui permet de définir le contenu unique de la notification.

Désormais, l'API accepte également un champ messages. Ca consiste en un tableau dans lequel vous pouvez définir plusieurs messages :

  • Un message pour chaque langue

  • Un message sans langue qui sera considéré comme le message par défaut.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
"messages" : [
    {
        "language" : "fr",
        "title" : "Salut !",
        "body" : "Comment ça va ?"
    },

    {
        "language" : "es",
        "title" : "Hola",
        "body" : "¿Qué tal?"
    },
    {
        "title" : "Hello!",
        "body" : "How's it going?"
    }
]

Dans ce cas précis :

  • Le premier message sera utilisé si la langue de l'utilisateur est le français.
  • Le second si la langue de l'utilisateur est l'espagnol.
  • Le troisième message sera utilisé si aucun n'est défini pour la langue de l'utilisateur (message par défaut).

Contenus de landings localisés

En complément des push, la personnalisation du contenu des landings en fonction de la langue est désormais supportée.

La mise à jour de l'API voit apparaître un champ contents dans l'objet landing, permettant de définir des contenus de landing par langue de la même manière que pour les messages.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
"landing" : {
    "theme" : "THEME_CODE",
    "image" : "http://mydomain.com/pic.png",
    "contents" : [
        {
            "language" : "fr",
            "title" : "Salut {{ c.firstname }} !",
            "body" : "Comment ça va ?"
        },
        {
            "language" : "es",
            "title" : "Hola {{ c.firstname }}",
            "body" : "¿Qué tal?"
        },
        {
            "title" : "Hello {{ c.firstname }}!",
            "body" : "How's it going?"
        }
    ]
}

Pour plus d'informations, retrouvez les détails techiques sur la documentation de l'API de push transactionnel.

Keep pushing !