View a markdown version of this page

Notifications d'événements d'application Amazon SNS pour les applications mobiles - Amazon Simple Notification Service
Événements d'application disponiblesEnvoi de notifications push mobile

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Notifications d'événements d'application Amazon SNS pour les applications mobiles

Amazon SNS prend en charge le déclenchement de notifications lorsque certains évènements d'application se produisent. Vous pouvez ensuite effectuer une action par programmation sur cet événement. Votre application doit prendre en charge un service de notification push tel qu'Apple Push Notification Service (APNs), Firebase Cloud Messaging (FCM) et Windows Push Notification Services (WNS). Vous définissez les notifications d'événements d'application à l'aide de la console Amazon SNS ou AWS CLI des AWS kits de développement logiciel.

Événements d'application disponibles

Les notifications d'événements d'application suivent la création, la suppression et la mise à jour de points de terminaison de plateforme individuels, ainsi que les échecs de diffusion. Voici les noms d'attributs pour les événements d'application.

Nom d’attribut Déclencheur de notification
EventEndpointCreated Un nouveau point de terminaison de plateforme est ajouté à votre application.
EventEndpointDeleted Tous les points de terminaison de plateforme associés à votre application sont supprimés.
EventEndpointUpdated Tous les attributs des points de terminaison de plateforme associés à votre application sont modifiés.
EventDeliveryFailure Une diffusion vers n’importe quel point de terminaison de plateforme associé à votre application fait l’objet d'une utilisation hors limites permanente.
Note

Pour suivre les échecs de diffusion du côté application de plateforme, abonnez-vous aux événements d'état de diffusion du message pour l'application. Pour plus d'informations, consultez la page Utilisation des attributs d'application Amazon SNS pour le statut de distribution du message.

Vous pouvez associer n'importe quel attribut avec une application, qui peut alors recevoir ces notifications d'événements.

Envoi de notifications push mobile

Pour envoyer des notifications d'événements d'application, spécifiez une rubrique qui recevra les notifications pour chaque type d'événement. Lorsqu'Amazon SNS envoie les notifications, la rubrique peut les acheminer à des points de terminaison qui effectueront l'action par programmation.

Important

High-volume les applications créeront de nombreuses notifications d'événements applicatifs (par exemple, des dizaines de milliers), qui submergeront les terminaux destinés à un usage humain, tels que les adresses e-mail, les numéros de téléphone et les applications mobiles. Respectez les consignes suivantes lorsque vous envoyez des notifications d’événements d'application à une rubrique :

  • Chaque rubrique qui reçoit des notifications ne doit contenir que des abonnements pour des points de terminaison programmatiques, tels que des points de terminaison HTTP ou HTTPS, des files d'attente Amazon SQS ou des fonctions. AWS Lambda

  • Pour réduire le volume de traitement qui est déclenché par les notifications, limitez les abonnements de chaque rubrique à un petit nombre (par exemple, cinq ou moins).

Vous pouvez envoyer des notifications d'événements d'application à l'aide de la console Amazon SNS, du AWS Command Line Interface (AWS CLI) ou des AWS kits de développement logiciel.

Console de gestion AWS

  1. Connectez-vous à la console Amazon SNS.

  2. Dans le panneau de navigation, choisissez Mobile, Notifications Push.

  3. Sur la page Notifications push mobiles, dans la section Applications de la plateforme, choisissez une application, puis choisissez Modifier.

  4. Développez la section Notifications d'événement.

  5. Choisissez Actions, Configurer les évènements.

  6. Saisissez les ARN pour les rubriques à utiliser pour les événements suivants :

    • Point de terminaison créé

    • Point de terminaison supprimé

    • Point de terminaison mis à jour

    • Échec de diffusion

  7. Cliquez sur Enregistrer les modifications.

AWS CLI

Exécutez la commande set-platform-application-attributes.

L'exemple suivant définit la même rubrique Amazon SNS pour les quatre évènements d'application :

aws sns set-platform-application-attributes
--platform-application-arn arn:aws:sns:us-east-1:12345EXAMPLE:app/FCM/MyFCMPlatformApplication
--attributes EventEndpointCreated="arn:aws:sns:us-east-1:12345EXAMPLE:MyFCMPlatformApplicationEvents",
EventEndpointDeleted="arn:aws:sns:us-east-1:12345EXAMPLE:MyFCMPlatformApplicationEvents",
EventEndpointUpdated="arn:aws:sns:us-east-1:12345EXAMPLE:MyFCMPlatformApplicationEvents",
EventDeliveryFailure="arn:aws:sns:us-east-1:12345EXAMPLE:MyFCMPlatformApplicationEvents"

AWS Kits SDK

Définissez les notifications d'événements d'application en soumettant une SetPlatformApplicationAttributes demande via l'API Amazon SNS à l'aide d'un AWS SDK.

Pour obtenir la liste complète des guides du développeur du AWS SDK et des exemples de code, y compris de l'aide pour démarrer et des informations sur les versions précédentes, consultezUtilisation d'Amazon SNS avec un AWS Kit SDK.