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

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.

Évènements d'application mobile

Amazon SNS fournit une assistance pour déclencher des notifications lorsque certains événements liés à l'application se produisent. Vous pouvez ensuite effectuer une action par programmation sur cet événement. Votre application doit inclure la prise en charge d'un service de notification push tel que le service de notification push Apple (APNs), Firebase Cloud Messaging (FCM) et les services de notification push Windows (WNS). Vous définissez les notifications d'événements de l'application à l'aide de la SNS console Amazon ou du AWS SDKs. AWS CLI

É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 Utilisation des attributs d'SNSapplication Amazon pour le statut de livraison des messages.

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. Au fur et à mesure qu'Amazon SNS envoie les notifications, le sujet peut les acheminer vers des points de terminaison qui exécuteront des actions programmatiques.

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 recevant des notifications ne doit contenir que des abonnements pour des points de terminaison programmatiques, tels que des points de HTTPS terminaison, des SQS files d'attente Amazon HTTP 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 SNS console Amazon, du AWS Command Line Interface (AWS CLI) ou du AWS SDKs.

AWS Management Console

  1. Connectez-vous à la SNSconsole Amazon.

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

  3. Sur la page des notifications push mobiles, dans la section Applications de la plateforme, choisissez une application, puis sélectionnez Modifier.

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

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

  6. Entrez ARNs les quatre sujets à utiliser pour les événements suivants :

    • Point de terminaison créé

    • Point de terminaison supprimé

    • Point de terminaison mis à jour

    • Échec de diffusion

  7. Sélectionnez Enregistrer les modifications.

AWS CLI

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

L'exemple suivant définit le même SNS sujet Amazon pour les quatre événements de l'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 SDKs

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

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