Évènements d'application mobile - Amazon Simple Notification Service

Évènements d'application mobile

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). Définissez les notifications d'évènements d'application à l'aide de la console Amazon SNS, de la AWS CLI ou des kits SDK AWS.

É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

Des applications à volume élevé créeront un grand nombre de notifications d’événements d'application (par exemple, des dizaines de milliers), qui envahiront les points de terminaison destinés à une utilisation humaine, 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 doit contenir uniquement des abonnements pour des points de terminaison par programmation, 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, de la AWS Command Line Interface (AWS CLI) ou des kits SDK AWS.

AWS Management Console

  1. Connectez-vous à la console Amazon SNS.

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

  3. Sur la page des notifications push mobile, dans la section Applications de plateforme, sélectionnez 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. Choisissez 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"

AWSKits SDK

Définissez les notifications d'évènements d'application en soumettant une requête SetPlatformApplicationAttributes avec l'API Amazon SNS à l'aide d'un kit SDK AWS.

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