Notifications application à utilisateur·ice

This feature is no longer available for new submissions. This documentation is intended solely for developers with existing games.

Les notifications application à utilisateur·ice sont de brefs messages libres que vous pouvez envoyer aux utilisateurs et utilisatrices de votre application afin de les inciter à interagir à nouveau. Elles constituent l’un des moyens les plus efficaces pour leur faire part d’évènements importants, leur transmettre des invitations d’ami·es ou les inviter à effectuer certaines actions. Vous pouvez utiliser ces notifications pour envoyer des messages aux utilisateur·ices qui ont autorisé votre application à le faire.

Les notifications application à utilisateur·ice sont disponibles pour tous les jeux web de Facebook. Elles apparaissent uniquement sur la version web de Facebook pour ordinateur. Les applications peuvent envoyer des notifications aux utilisateur·ices qui ont donné leur autorisation. Aucune autorisation spéciale ou étendue n’est requise.

Lorsqu’une notification est envoyée, elle active l’icône de notifications de Facebook et apparaît dans le menu déroulant. Les notifications s’affichent avec l’icône de l’application sur la gauche, au milieu d’autres notifications triées par ordre chronologique.

Les notifications en elles-mêmes sont de courtes chaînes de texte personnalisé (jusqu’à 120 caractères). Vous pouvez mentionner les utilisateurs et utilisatrices par leur ID spécifique Facebook. Ceux-ci seront développés pour afficher le véritable nom des utilisateur·ices, mais il ne sera pas possible de cliquer sur ces noms. Consultez la section des modèles de message ci-dessous pour en savoir plus.

Un clic sur la notification redirige vers l’URL indiquée lors de sa création.

Implémentation

Envoi de notifications

Les applications peuvent générer des notifications en envoyant une requête HTTP POST à l’API Graph /user_id/notifications à l’aide d’un app access_token. Pour en savoir plus, consultez l’arête de notifications de l’API Graph.

POST /{recipient_userid}/notifications?access_token=... &template=...&href=...

Paramètres

Paramètre	Description
`href`	Chemin relatif ou paramètres GET de la cible (par exemple, `index.html?gift_id=123` ou `?gift_id=123`). Cette valeur permettra de créer une URL cible absolue en fonction des paramètres de votre application. La logique est la suivante : sur le Web, si le paramètre existe pour les jeux sur Facebook.com, l’URL cible sera composée de l’URL de l’application de jeu, plus `href`. Dans le cas contraire, la notification ne sera pas affichée. L’URL absolue contiendra des paramètres de suivi spéciaux (`fb_source`, `notif_id`, `notif_t`) dirigeant vers l’URL cible afin que les équipes de développement puissent établir un suivi de leur côté.
`template`	Texte personnalisé de la notification. Pour en savoir plus, consultez la section Modèles de message ci-dessous.
`ref`	Répartissez vos notifications en plusieurs groupes pour pouvoir les suivre indépendamment dans App Analytics.

Gestion des valeurs renvoyées

Si l’appel aboutit, l’API Graph renvoie la réponse suivante :

{
  "success": true
}

Remarque : lorsqu’il est peu probable que le ou la destinataire interagisse avec la notification, il se peut que cette dernière ne s’affiche pas même si l’appel de l’API Graph a abouti.

Sinon, la réponse de l’API Graph contient une erreur associée à un message d’exception.

Si le ou la destinataire n’a pas authentifié votre application, vous obtiendrez une réponse semblable à la suivante :

{
   "error": {
      "message": "(#200) Cannot send notifications to a user who has not installed the app",
      "type": "OAuthException",
      "code": 200
   }
}

Si l’utilisateur·ice que vous tentez d’identifier n’a pas authentifié votre application, vous obtiendrez la réponse suivante :

{
   "error": {
      "message": "(#200) Cannot tag users who have not installed the app",
      "type": "OAuthException",
      "code": 200
   }
}

Si le texte de votre modèle contient plus de 180 caractères, l’API renverra une erreur comme ci-dessous. Notez que tout texte de plus de 120 caractères sera tronqué.

{
   "error": {
      "message": "(#100) template parameter cannot be longer than 180 characters.",
      "type": "OAuthException",
      "code": 100
   }
}

Remarque : si les utilisateur·ices désactivent les notifications envoyées par votre application, la publication fonctionnera tout de même, mais la notification n’apparaîtra pas dans l’UI.

Modèles de message

Les messages des notifications sont composés de texte libre. L’API Graph accepte un maximum de 180 caractères dans le champ message et tronquera les messages après 120 caractères.

Messages en texte brut

Cette notification peut être générée à l’aide de l’appel de l’API Graph suivant :

POST /{recipient_userid}/notifications?
     access_token=...& 
     href=...& 
     template=You have people waiting to play with you, play now!

Modèles de messages personnalisés

Pour inclure des identifiants d’utilisateur·ice, utilisez @[USER_ID], qui sera remplacé par le nom complet de l’utilisateur·ice et mis en avant au moment du rendu.

La notification ci-dessus peut être générée en formatant le modèle avec les ID d’utilisateur·ice, comme illustré dans le code ci-dessous.

POST /{recipient_userid}/notifications?
     access_token=...& 
     href=...& 
     template=@[596824621] started a game with you, play now!

De même, la notification ci-dessous utilise la syntaxe @[USER_ID], mais le modèle comporte plusieurs acteurs (utilisateur·ices).

POST /{recipient_userid}/notifications?
     access_token=...& 
     href=...& 
     template=@[596824621] and @[10149999096285761] started a game with you!

L’API Graph vérifie que chaque identifiant USER_ID correspond à un utilisateur ou une utilisatrice Facebook valide ayant déjà authentifié votre application. Si l’une de ces valeurs n’est pas valide, l’appel d’API échouera.

Suivi des performances

Taux de clics minimal

Le taux de clics (CTR) est l’une des mesures les plus importantes de l’efficacité de vos notifications. Les notifications avec un CTR élevé intéressent les utilisateur·ices et les incitent à interagir. Celles qui ont un CTR faible sont considérées comme de qualité médiocre. Au fil du temps, les utilisateur·ices auront tendance à ignorer ou à désactiver les notifications à CTR faible, ce qui nuira aux performances et à d’autres aspects de votre application.

Pour que le canal de notifications continue d’intéresser les utilisateurs et utilisatrices de Facebook, les applications qui envoient plus de 50 000 notifications par semaine doivent enregistrer un taux de clics hebdomadaire d’au moins 17 %. Les données montrent que les utilisateur·ices interagissent plus longtemps lorsque les applications atteignent ce taux minimum. Les applications qui n’atteignent pas ce taux chaque semaine peuvent être temporairement désactivées.

La plupart des applications peuvent maintenir ce taux assez facilement si elles suivent les recommandations simples énoncées dans la section ci-dessous.

Optimisation manuelle

Localisation des modèles de message

Pour envoyer des notifications dans une autre langue que l’anglais, les équipes de développement doivent suivre manuellement les paramètres régionaux de l’utilisateur·ice concerné·e. Lorsque cette personne est connectée, ses paramètres régionaux sont accessibles par le biais de l’arête de l’API Graph /{user-id}?fields=locale. Pour les jeux sur Facebook.com, les paramètres régionaux peuvent être récupérés grâce à la requête HTTP POST. Une fois que les équipes de développement connaissent les paramètres régionaux, elles peuvent créer manuellement des modèles de message qui correspondent aux paramètres régionaux de l’utilisateur·ice.

Périodicité des envois

Les équipes de développement peuvent optimiser les notifications afin qu’elles soient envoyées pendant les heures d’éveil de l’utilisateur·ice. Lorsque l’utilisateur·ice s’est connecté·e, son fuseau horaire est accessible par le biais de l’arête de l’API Graph /{user-id}?fields=timezone. À l’aide des informations sur le fuseau horaire et des paramètres de référence, les équipes de développement peuvent optimiser le ciblage et envoyer les notifications au moment le plus opportun.

Ciblage automatique (bêta)

Le ciblage automatique vous permet d’envoyer des notifications application à utilisateur·ice, tout en tirant parti du ciblage amélioré de Facebook. L’activation du ciblage automatique vous évite de devoir maintenir vous-même un taux de clics élevé de 17 %, puisque Facebook envoie automatiquement des notifications aux utilisateurs et aux utilisatrices les plus susceptibles d’interagir avec votre application.

Lorsque cette fonctionnalité est activée, vous pouvez cibler des segments d’audience plus vastes avec vos notifications et Facebook envoie automatiquement des notifications aux utilisateur·ices les plus susceptibles d’interagir avec votre application. Par exemple, nous avons constaté que les notifications qui datent de plus de quelques jours présentent généralement de faibles performances. Aussi, nous les diffusons peu. La plupart des développeur·ses qui ont activé le ciblage automatique et optimisé l’envoi des notifications ont constaté plus d’interactions avec les notifications application à utilisateur·ice.

Pour tirer parti du ciblage automatique, vous pouvez l’activer dans l’onglet Paramètres des Paramètres de l’Espace App.

Notez que pour les applications qui n’ont jamais utilisé les notifications application à utilisateur·ice et qui les ont récemment implémentées, le ciblage automatique sera activé automatiquement.

Recommandations

La qualité étant primordiale, les destinataires sur Facebook peuvent désactiver les notifications qui leur déplaisent ou les signaler comme spam. Nous utilisons ces signaux pour mettre en avant les notifications qui plaisent aux utilisateur·ices et limiter la diffusion des notifications qui leur déplaisent. Cela permet de garantir des notifications utiles pour tous et toutes.

Les utilisateurs et utilisatrices ne font pas la différence entre les notifications et le reste du contenu sur Facebook, chaque message a donc un effet important. Un seul message indésirable peut inciter un·e utilisateur·ice à ignorer les notifications ou à les désactiver complètement.

Nous avons mis en place ces recommandations pour vous aider à créer des notifications claires et convaincantes.

Aucune personne inactive. Votre application ne doit pas envoyer de notifications aux utilisateurs et utilisatrices qui ne l’ont pas utilisée au cours des 28 derniers jours. Les données montrent que l’interaction au sein de ce groupe est fortement inférieure. Ses membres sont également les plus susceptibles de signaler vos notifications comme spam. Les applications qui font l’objet d’un grand nombre de signalements de spam peuvent être désactivées.
Commencez modestement. Même si vous possédez une grosse application, commencez par tester vos notifications sur un petit nombre d’utilisateur·ices pour rester sous le seuil de 50 000 par semaine. De cette manière, vous pouvez faire des essais avec vos notifications jusqu’à ce que vous découvriez ce qui fonctionne le mieux auprès des utilisateur·ices.
N’envoyez pas plus d’une à deux notifications par utilisateur·ice et par jour. Au-delà de deux notifications par jour, de nombreuses personnes cessent de réagir ou signalent l’application comme spam.
Ne fatiguez pas votre audience. Il est généralement déconseillé d’envoyer un trop grand nombre de notifications à la même personne en peu de temps. Grâce à App Analytics, les développeur·ses peuvent trouver le moment idéal pour inciter à nouveau les joueurs et joueuses à interagir en comparant les résultats à l’aide des paramètres de référence des différentes périodicités : deux heures, six heures, un jour, trois jours, une semaine ou même jusqu’à deux semaines.
Ciblage automatique. Si vous envoyez plus de 50 000 notifications au cours d’une semaine et avez du mal à maintenir un CTR de 17 %, nous vous conseillons d’activer le ciblage automatique pour permettre à Facebook d’envoyer automatiquement des notifications aux utilisateur·ices les plus susceptibles d’interagir avec votre application.