Mobile App-Ereignisse

Amazon SNS löst bei Auftreten bestimmter Anwendungsereignisse Benachrichtigungen aus. Im Anschluss daran können Sie eine programmgesteuerte Aktion für das Ereignis definieren. Ihre Anwendung muss einen Support für einen Push-Benachrichtigungsservice, wie Apple Push Notification Service (APNs), Firebase Cloud Messaging (FCM) und Windows Push Notification Services (WNS) einschließen. Ereignisbenachrichtigungen einer Anwendung können mit der Amazon-SNS-Konsole, AWS CLI oder AWS SDKs konfiguriert werden.

Verfügbare Anwendungsereignisse

Ereignisbenachrichtigungen einer Anwendung können nachverfolgen, wann Endpunkte für individuelle Plattformen erstellt, gelöscht oder aktualisiert wurden. Sie können außerdem Versandfehler nachverfolgen. Im Folgenden sind die Attributnamen für die Anwendungsereignisse aufgeführt.

Attributname	Benachrichtigungsauslöser
EventEndpointCreated	Ein neuer Plattformendpunkt wird Ihrer Anwendung hinzugefügt.
EventEndpointDeleted	Alle Plattformendpunkte, die Ihrer Anwendung zugewiesen sind, werden gelöscht.
EventEndpointUpdated	Alle Attribute der Plattformendpunkte, die Ihrer Anwendung zugewiesen sind, werden geändert.
EventDeliveryFailure	Bei einer Übermittlung an einen der Plattformendpunkte, die Ihrer Anwendung zugewiesen wurden, ist ein dauerhafter Fehler aufgetreten. Anmerkung Um von der Plattform-Anwendung ausgehende Fehler bei der Übermittlung zu verfolgen, abonnieren Sie für die Anwendung Statusereignisse für die Nachrichtenübermittlung. Weitere Informationen finden Sie unter Verwendung von Amazon SNS-Anwendungsattributen für den Status von Nachrichtenübermittlungen.

Sie können jedes Attribut einer Anwendung zuordnen, die dann diese Ereignisbenachrichtigungen empfangen kann.

Senden mobiler Push-Benachrichtigungen

Um Ereignisbenachrichtigungen für Anwendungen zu versenden, geben Sie ein Thema an, das die Benachrichtigungen für den jeweiligen Ereignistyp erhalten soll. Sobald Amazon SNS die Benachrichtigungen sendet, kann das Themas diese an Endpunkte weiterleiten, die eine programmgesteuerte Aktion durchführen werden.

Wichtig

Anwendungen mit großem Volumen rufen häufige Ereignisbenachrichtigungen für Anwendungen hervor (z. B. Zehntausende), durch die Endpunkte, die für die Verwendung durch Menschen vorgesehen sind, überflutet werden (z. B. E-Mail-Adressen, Telefonnummern und mobile Anwendungen). Beachten Sie folgende Richtlinien, wenn Sie Ereignisbenachrichtigungen für Anwendungen an ein Thema senden:

• Jedes Thema, das Benachrichtigungen erhält, darf nur Abonnements für programmgesteuerte Endpunkte enthalten, wie z. B. HTTP- oder HTTPS-Endpunkte, Amazon SQS-Warteschlangen oder AWS Lambda-Funktionen.

• Um den Bearbeitungsaufwand, der durch Benachrichtigungen ausgelöst wird, zu minimieren, reduzieren Sie die Anzahl der Abonnements eines jeden Themas (z. B. auf fünf oder weniger).

Sie können Ereignisbenachrichtigungen einer Anwendung mit der Amazon-SNS-Konsole, AWS Command Line Interface (AWS CLI) oder AWS SDKs senden.

AWS Management Console

1. Melden Sie sich bei der Amazon-SNS-Konsole an.

2. Wählen Sie im Navigationsbereich die Option Mobile (Mobil) und dann Push notifications (Push-Benachrichtigungen) aus.

3. Wählen Sie auf der Seite Mobile push notifications (Mobile Push-Benachrichtigungen) im Bereich Platform applications (Plattformanwendungen) eine Anwendung und anschließend Edit (Bearbeiten) aus.

4. Erweitern Sie den Abschnitt Event notifications (Ereignisbenachrichtigungen).

5. Wählen Sie Actions (Aktionen) und Configure events (Ereignisse konfigurieren) aus.

6. Geben Sie die ARNs für Themen ein, die für die folgenden Ereignisse verwendet werden sollen:

   • Ersteller Endpunkt

   • Gelöschter Endpunkt

   • Aktualisierter Endpunkt

   • Übermittlungsfehler

7. Wählen Sie Save Changes.

AWS CLI

Wählen Sie den Befehl set-platform-application-attributes.

Im folgenden Beispiel wird das gleiche Amazon SNS-Thema für alle vier Anwendungsereignisse definiert:

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

Legen Sie Anwendungsereignisbenachrichtigungen fest, indem Sie eine SetPlatformApplicationAttributes-Anforderung mit der Amazon SNS API mit AWS-SDK einsenden.

Eine vollständige Liste der AWS-SDK-Entwicklerhandbücher und Codebeispiele, einschließlich der ersten Schritte und Informationen zu früheren Versionen, finden Sie unter Verwenden von Amazon SNS mit einemAWSSDK.