Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Attribute der mobilen Amazon SNS SNS-App
Amazon Simple Notification Service (Amazon SNS) unterstützt die Protokollierung des Zustellungsstatus von Push-Benachrichtigungen. Nachdem Sie Anwendungsattribute konfiguriert haben, werden Protokolleinträge für Nachrichten, die von Amazon SNS an mobile Endpunkte gesendet wurden, an CloudWatch Logs gesendet. Die Protokollierung des Zustellungsstatus von Nachrichten verhilft Ihnen zu besseren betrieblichen Einblicken, wie beispielsweise den Folgenden:
+ Sie erfahren, ob eine Push-Benachrichtigungsmitteilung von Amazon SNS an den Push-Benachrichtigungsservice zugestellt wurde.
+ Identifizieren Sie die Antwort, die vom Push-Benachrichtigungsservice an den Amazon SNS gesendet wurde.
+ Ermitteln Sie die dwell-Zeit der Nachricht (das Zeitfenster zwischen dem Zeitstempel der Veröffentlichung bis direkt vor der Übergabe an einen Push-Benachrichtigungsservice).
Um Anwendungsattribute für den Nachrichtenzustellungsstatus zu konfigurieren, können Sie die AWS-Managementkonsole AWS Software Development Kits (SDKs) oder die Abfrage-API verwenden.
## Konfiguration von Nachrichtenzustellungsstatusattributen mit dem AWS-Managementkonsole
1. Melden Sie sich bei der [Amazon-SNS-Konsole](https://console.aws.amazon.com/sns/home) an.
1. Wählen Sie im Navigationsbereich die Option **Mobile (Mobil)** und dann **Push notifications (Push-Benachrichtigungen)** aus.
1. Wählen Sie im Abschnitt **Plattformanwendungen** die Anwendung aus, die die Endpoints enthält, für die Sie CloudWatch Protokolle erhalten möchten.
1. Wählen Sie **Application Actions (Anwendungsaktionen)** und anschließend **Delivery status (Zustellungsstatus)**.
1. Wählen Sie im Dialogfeld **Delivery Status (Zustellungsstatus)**die Option **Create IAM Roles (IAM-Rollen erstellen)**.
Sie werden anschließend zur IAM-Konsole umgeleitet.
1. Wählen Sie **Zulassen**, um Amazon SNS Schreibzugriff auf die Nutzung von CloudWatch Logs in Ihrem Namen zu gewähren.
1. Kehren Sie nun zum Dialogfeld „**Lieferstatus**“ zurück und geben Sie im Feld **Erfolgsquote bis zur Stichprobe (0-100)** eine Zahl für den Prozentsatz der erfolgreich gesendeten Nachrichten ein, für die Sie Logs erhalten CloudWatch möchten.
**Anmerkung**
Nachdem Sie die Anwendungsattribute für den Nachrichtenzustellungsstatus konfiguriert haben, werden für alle fehlgeschlagenen Nachrichtenzustellungen CloudWatch Protokolle generiert.
1. Wählen Sie anschließend **Save Configuration (Konfiguration speichern)**. Sie können jetzt die CloudWatch Protokolle mit dem Status der Nachrichtenzustellung anzeigen und analysieren. Weitere Informationen zur Verwendung CloudWatch finden Sie in der [CloudWatchDokumentation](https://aws.amazon.com/documentation/cloudwatch).
## Beispiele für das CloudWatch Protokoll zum Status der Nachrichtenzustellung in Amazon SNS
Nachdem Sie die Attribute für den Nachrichtenzustellungsstatus für einen Anwendungsendpunkt konfiguriert haben, werden CloudWatch Protokolle generiert. Beispielprotokolle im JSON-Format werden wie folgt angezeigt:
**ERFOLG**
```
{
"status": "SUCCESS",
"notification": {
"timestamp": "2015-01-26 23:07:39.54",
"messageId": "9655abe4-6ed6-5734-89f7-e6a6a42de02a"
},
"delivery": {
"statusCode": 200,
"dwellTimeMs": 65,
"token": "Examplei7fFachkJ1xjlqT64RaBkcGHochmf1VQAr9k-IBJtKjp7fedYPzEwT_Pq3Tu0lroqro1cwWJUvgkcPPYcaXCpPWmG3Bqn-wiqIEzp5zZ7y_jsM0PKPxKhddCzx6paEsyay9Zn3D4wNUJb8m6HXrBf9dqaEw",
"attempts": 1,
"providerResponse": "{\"multicast_id\":5138139752481671853,\"success\":1,\"failure\":0,\"canonical_ids\":0,\"results\":[{\"message_id\":\"0:1422313659698010%d6ba8edff9fd7ecd\"}]}",
"destination": "arn:aws:sns:us-east-2:111122223333:endpoint/FCM/FCMPushApp/c23e42de-3699-3639-84dd-65f84474629d"
}
}
```
**FEHLER**
```
{
"status": "FAILURE",
"notification": {
"timestamp": "2015-01-26 23:29:35.678",
"messageId": "c3ad79b0-8996-550a-8bfa-24f05989898f"
},
"delivery": {
"statusCode": 8,
"dwellTimeMs": 1451,
"token": "examp1e29z6j5c4df46f80189c4c83fjcgf7f6257e98542d2jt3395kj73",
"attempts": 1,
"providerResponse": "NotificationErrorResponse(command=8, status=InvalidToken, id=1, cause=null)",
"destination": "arn:aws:sns:us-east-2:111122223333:endpoint/APNS_SANDBOX/APNSPushApp/986cb8a1-4f6b-34b1-9a1b-d9e9cb553944"
}
}
```
Eine Liste der Antwortcodes für den Push-Benachrichtigungsservice finden Sie unter [Antwortcodes der Plattformen](#platform-returncodes).
## Konfiguration von Statusattributen für die Nachrichtenzustellung mit dem AWS SDKs
[AWS SDKs](https://aws.amazon.com/tools/)Sie bieten APIs in mehreren Sprachen die Verwendung von Nachrichtenzustellungsstatusattributen mit Amazon SNS an.
Das folgende Java-Beispiel zeigt, wie Sie mit der `SetPlatformApplicationAttributes`-API Anwendungsattribute für den Status von Nachrichtenübermittlungen von Push-Benachrichtigungsmitteilungen konfigurieren. Sie können die folgenden Attribute für den Status von Nachrichtenübermittlungen verwenden: `SuccessFeedbackRoleArn``FailureFeedbackRoleArn` und `SuccessFeedbackSampleRate`. Die `FailureFeedbackRoleArn` Attribute `SuccessFeedbackRoleArn` und werden verwendet, um Amazon SNS Schreibzugriff auf die Nutzung von CloudWatch Logs in Ihrem Namen zu gewähren. Das Attribut `SuccessFeedbackSampleRate` dient zum Festlegen des Prozentsatzes der Samplerate (0-100) der erfolgreich zugestellten Nachrichten. Nachdem Sie das `FailureFeedbackRoleArn` Attribut konfiguriert haben, werden bei allen fehlgeschlagenen Nachrichtenzustellungen CloudWatch Protokolle generiert.
```
SetPlatformApplicationAttributesRequest setPlatformApplicationAttributesRequest = new SetPlatformApplicationAttributesRequest();
Map attributes = new HashMap<>();
attributes.put("SuccessFeedbackRoleArn", "arn:aws:iam::111122223333:role/SNS_CWlogs");
attributes.put("FailureFeedbackRoleArn", "arn:aws:iam::111122223333:role/SNS_CWlogs");
attributes.put("SuccessFeedbackSampleRate", "5");
setPlatformApplicationAttributesRequest.withAttributes(attributes);
setPlatformApplicationAttributesRequest.setPlatformApplicationArn("arn:aws:sns:us-west-2:111122223333:app/FCM/FCMPushApp");
sns.setPlatformApplicationAttributes(setPlatformApplicationAttributesRequest);
```
Weitere Informationen zu SDK für Java finden Sie unter [Erste Schritte mit dem AWS SDK für Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html).
## Antwortcodes der Plattformen
Die folgende Liste enthält Links für die Antwortcodes des Push-Benachrichtigungsservice:
****
| Push-Benachrichtigungsservice | Antwortcodes |
| --- | --- |
| Amazon Device Messaging (ADM) | Weitere Informationen finden Sie unter [Antwortformat](https://developer.amazon.com/docs/adm/send-message.html#response-format) in der ADM Dokumentation. |
| Apple-Push-Benachrichtigungsdienst () APNs | Weitere Informationen finden Sie unter HTTP/2-Antwort von APNs in [Kommunizieren mit APNs](https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/CommunicatingwithAPNs.html#/apple_ref/doc/uid/TP40008194-CH11-SW1) im Programmierhandbuch für lokale und ferngesteuerte Benachrichtigungen. |
| Firebase Cloud Messaging (FCM) | Weitere Informationen finden Sie unter [Downstream Message Error Response Codes](https://firebase.google.com/docs/cloud-messaging/http-server-ref#error-codes) in der Firebase Cloud Messaging Dokumentation. |
| Microsoft Push Notification Service für Windows Phone (MPNS) | Weitere Informationen finden Sie unter [Push Notification Service Response Codes for Windows Phone 8](https://msdn.microsoft.com/en-us/library/windows/apps/ff941100%28v=vs.105%29.aspx#BKMK_PushNotificationServiceResponseCodes) in der Windows 8 Development Dokumentation. |
| Windows Push Notification Services (WNS) | Weitere Informationen finden Sie unter "Response codes" in [Push Notification Service Request and Response Headers (Windows Runtime Apps)](https://msdn.microsoft.com/en-us/library/windows/apps/hh465435.aspx) in der Windows 8 Development-Dokumentation. |