**Hinweis zum Ende des Supports:** Am 30. Oktober 2026 AWS wird der Support für Amazon Pinpoint eingestellt. Nach dem 30. Oktober 2026 können Sie nicht mehr auf die Amazon-Pinpoint-Konsole oder die Amazon-Pinpoint-Ressourcen (Endpunkte, Segmente, Kampagnen, Journeys und Analytik) zugreifen. Weitere Informationen finden Sie unter [Ende des Amazon-Pinpoint-Supports](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Hinweis:** APIs In Bezug auf SMS sind Sprach-, mobile Push-, OTP- und Telefonnummernvalidierung von dieser Änderung nicht betroffen und werden von AWS End User Messaging unterstützt.
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.
# Amazon Pinpoint Pinpoint-Analysedaten abfragen
Zusätzlich zur Nutzung der Analyseseiten in der Amazon Pinpoint-Konsole können Sie Amazon Pinpoint Analytics verwenden, APIs um Analysedaten für eine Teilmenge von Standardmetriken abzufragen, die Einblicke in Trends in Bezug auf Benutzerinteraktion, Kampagnenreichweite und mehr bieten. Bei diesen Kennzahlen, die auch als *Leistungskennzahlen (KPIs)* bezeichnet werden, handelt es sich um messbare Werte, anhand derer Sie die Leistung Ihrer Projekte, Kampagnen und Journeys überwachen und bewerten können.
Wenn Sie die APIs zum Abfragen von Analysedaten verwenden, können Sie die Daten mit dem Berichtstool Ihrer Wahl analysieren, ohne sich bei der Amazon Pinpoint-Konsole anmelden oder rohe Ereignisdaten aus Quellen wie Amazon Kinesis Kinesis-Streams analysieren zu müssen. Sie können beispielsweise ein benutzerdefiniertes Dashboard erstellen, das wöchentliche Kampagnenergebnisse anzeigt oder detaillierte Analysen zu den Zustellraten für Ihre Kampagnen bereitstellt.
Sie können die Daten mithilfe der Amazon Pinpoint REST-API, der AWS Command Line Interface (AWS CLI) oder eines AWS SDK abfragen. Um die Daten abzufragen, senden Sie eine Anforderung an die Amazon-Pinpoint-API und verwenden unterstützte Parameter, um die gewünschten Daten und Filter anzugeben, die Sie anwenden möchten. Nachdem Sie Ihre Abfrage gesendet haben, gibt Amazon Pinpoint die Abfrageergebnisse in einer JSON-Antwort zurück. Sie können die Ergebnisse dann an einen anderen Service oder eine Anwendung übergeben – für intensivere Analysen, zum Speichern oder zum Erstellen von Berichten.
Amazon Pinpoint sammelt und kumuliert automatisch Daten für alle unterstützten Metriken, für alle Ihre Projekte, Kampagnen und Reisen. Zudem werden die Daten kontinuierlich aktualisiert. Der resultierende Datenlatenz-Zeitrahmen ist auf ungefähr zwei Stunden beschränkt. Beachten Sie jedoch, dass es bei bestimmten Metriken zu Datenverzögerungen kommen kann. Dies liegt daran, dass die Daten für einige Metriken auf Informationen basieren, die wir von den E-Mail-Anbietern der Empfänger erhalten. Einige Anbieter senden uns diese Informationen sofort, während andere sie seltener senden.
Amazon Pinpoint speichert die Daten 90 Tage lang. Um die Daten für mehr als 90 Tage zu speichern oder in Echtzeit auf Rohdaten zuzugreifen, können Sie ein Amazon Pinpoint Pinpoint-Projekt so konfigurieren, dass Ereignisdaten an Amazon Kinesis Data Streams oder Amazon Data Firehose gestreamt werden. Weitere Informationen zum Konfigurieren von Ereignisströmen finden Sie unter [Streamen Sie App-Ereignisdaten mithilfe von Amazon Pinpoint über Kinesis und Firehose](event-streams.md).
## Komponenten und Parameter für Metriken in Amazon Pinpoint abfragen
Um die Daten für eine Metrik abzufragen, senden Sie eine `get`-Anfrage an die entsprechende Metrik-Ressource der Amazon Pinpoint-API. In Ihrer Anforderung definieren Sie Ihre Abfrage, indem Sie unterstützte Parameter für die folgenden Abfragekomponenten verwenden:
+ **Projekt**: Geben Sie ein Projekt an, indem Sie die Projekt-ID als Wert für den `application-id`-Parameter angeben. Dieser Parameter ist für alle Metriken erforderlich.
+ **Kampagne**: Geben Sie eine Kampagne an, indem Sie die Kampagnen-ID als Wert für den `campaign-id`-Parameter angeben. Dieser Parameter ist nur für Kampagnenmetriken erforderlich.
+ **Journey**: Geben Sie eine Journey an, indem Sie die Journey-ID als Wert für den `journey-id`-Parameter angeben. Dieser Parameter wird nur für Journey-Engagement-Metriken und Journey-Ausführungsmetriken sowie für Journey-Aktivitätsausführungsmetrik benötigt.
+ **Journey-Aktivität**: Geben Sie eine Journey-Aktivität an, indem Sie die ID der Journey-Aktivität als Wert für den `journey-activity-id`-Parameter angeben. Dieser Parameter wird nur für Journey-Aktivitätsausführungsmetriken benötigt.
+ **Datumsbereich**: Um die Daten optional nach Datumsbereich zu filtern, geben Sie mithilfe der unterstützten Start- und Endzeitparameter das erste und letzte Datum und die Uhrzeit des Datumsbereichs an. Die Werte sollten im erweiterten ISO 8601-Format vorliegen und die koordinierte Weltzeit (UTC) verwenden, z. B. `2019-07-19T20:00:00Z` für 20.00 Uhr UTC am 19. Juli 2019.
Datumsbereiche werden inklusiv angegeben und dürfen maximal 31 Kalendertage umfassen. Darüber hinaus müssen das erste Datum und die erste Uhrzeit früher als 90 Tage ab dem aktuellen Tag liegen. Wenn Sie keinen Datumsbereich angeben, werden die Daten für die letzten 31 Kalendertage von Amazon Pinpoint zurückgegeben. Datumsbereichsparameter werden von allen Metriken unterstützt, mit Ausnahme von Journey-Aausführungsmetriken und Journey-Aktivitätsausführungsmetriken.
+ **Metrik**: Geben Sie die Metrik an, indem Sie den Namen der Metrik als Wert für den `kpi-name`-Parameter angeben. Dieser Wert beschreibt die zugeordnete Metrik und besteht aus zwei oder mehr Begriffen, die aus alphanumerischen Kleinbuchstaben bestehen, die durch einen Bindestrich getrennt sind. Beispiele sind `email-open-rate` und `successful-delivery-rate`. Dieser Parameter wird für alle Metriken mit Ausnahme von Journey-Aausführungsmetriken und Journey-Aktivitätsausführungsmetriken benötigt. Eine vollständige Liste der unterstützten Metriken und dem jeweils zu verwendenden `kpi-name`-Wert finden Sie unter [Standardmetriken für Projekte, Kampagnen und Journeys](analytics-standard-metrics.md).
Nachdem Sie Ihre Abfrage gesendet haben, gibt Amazon Pinpoint die Abfrageergebnisse in einer JSON-Antwort zurück. In der Antwort variiert die Struktur der Ergebnisse in Abhängigkeit von der Metrik, die Sie abgefragt haben.
Einige Metriken liefern nur einen Wert, z. B. die Anzahl der Nachrichten, die im Rahmen einer Kampagne zugestellt wurden. Andere Metriken liefern mehrere Werte und gruppieren diese in der Regel nach einem relevanten Feld, z. B. der Anzahl der Nachrichten, die bei jedem Lauf einer Kampagne zugestellt wurden, gruppiert nach Kampagnenlauf. Wenn eine Metrik mehrere Werte bereitstellt und gruppiert, enthält die JSON-Antwort ein Feld, das angibt, welches Feld zur Gruppierung der Daten verwendet wurde. Weitere Informationen zur Struktur von Abfrageergebnissen finden Sie unter [Verwenden Sie JSON-Abfrageergebnisse](analytics-query-results.md).
# IAM-Richtlinien zum Abfragen von Amazon-Pinpoint-Analysedaten
Mithilfe der Amazon Pinpoint Pinpoint-API können Sie Analysedaten für eine Teilmenge von Standardmetriken abfragen, die auch als *Key Performance Indicators (KPIs)* bezeichnet werden und für Amazon Pinpoint Pinpoint-Projekte, -Kampagnen und Journeys gelten. Diese Metriken können Ihnen helfen, die Leistung von Projekten, Kampagnen und Journey zu überwachen und zu bewerten.
Um den Zugriff auf diese Daten zu verwalten, können Sie AWS Identity and Access Management (IAM-) Richtlinien erstellen, die Berechtigungen für IAM-Rollen oder Benutzer definieren, die berechtigt sind, auf die Daten zuzugreifen. Um eine detaillierte Kontrolle des Zugriffs auf diese Daten zu unterstützen, bietet Amazon Pinpoint mehrere verschiedene Aktionen, die Sie in IAM-Richtlinien angeben können. Es gibt eine eindeutige Aktion zum Anzeigen von Analysedaten auf der Amazon-Pinpoint-Konsole (`mobiletargeting:GetReports`) und es gibt andere Aktionen für den programmatischen Zugriff auf Analysedaten mithilfe der Amazon-Pinpoint-API.
Um IAM-Richtlinien zu erstellen, die den Zugriff auf Analysedaten verwalten, können Sie die AWS-Managementkonsole AWS CLI, oder die IAM-API verwenden. Beachten Sie, dass die Registerkarte **Visueller Editor** auf der AWS-Managementkonsole derzeit keine Aktionen zum Anzeigen oder Abfragen von Amazon-Pinpoint-Analysedaten enthält. Sie können jedoch die erforderlichen Aktionen manuell zu IAM-Richtlinien hinzufügen, indem Sie die Registerkarte **JSON** auf der Konsole verwenden.
Die folgende Richtlinie ermöglicht beispielsweise den programmatischen Zugriff auf alle Analysedaten für all Ihre Projekte, Kampagnen und Journeys in allen Regionen: AWS
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryAllAnalytics",
"Effect": "Allow",
"Action": [
"mobiletargeting:GetApplicationDateRangeKpi",
"mobiletargeting:GetCampaignDateRangeKpi",
"mobiletargeting:GetJourneyDateRangeKpi",
"mobiletargeting:GetJourneyExecutionMetrics",
"mobiletargeting:GetJourneyExecutionActivityMetrics"
],
"Resource": [
"arn:aws:mobiletargeting:*:111122223333:apps/*/kpis/*",
"arn:aws:mobiletargeting:*:111122223333:apps/*/campaigns/*/kpis/*",
"arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/kpis/*",
"arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/execution-metrics",
"arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/activities/*/execution-metrics"
]
}
]
}
```
------
Wo *accountId* ist Ihre AWS Konto-ID.
Als bewährte Methode sollten Sie jedoch Richtlinien erstellen, die dem Prinzip der *geringsten Rechte* folgen. Mit anderen Worten, Sie sollten Richtlinien erstellen, die nur die Berechtigungen enthalten, die zum Ausführen einer bestimmten Aufgabe erforderlich sind. Um diese Vorgehensweise zu unterstützen und eine detailliertere Steuerung zu implementieren, können Sie den programmatischen Zugriff auf die Analysedaten nur für ein bestimmtes Projekt in einer bestimmten AWS Region einschränken, zum Beispiel:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryProjectAnalytics",
"Effect": "Allow",
"Action": [
"mobiletargeting:GetApplicationDateRangeKpi",
"mobiletargeting:GetCampaignDateRangeKpi",
"mobiletargeting:GetJourneyDateRangeKpi",
"mobiletargeting:GetJourneyExecutionMetrics",
"mobiletargeting:GetJourneyExecutionActivityMetrics"
],
"Resource": [
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/campaigns/*/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/execution-metrics",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/activities/*/execution-metrics"
]
}
]
}
```
------
Wobei Folgendes gilt:
+ *region*ist der Name der AWS Region, in der das Projekt gehostet wird.
+ *accountId*ist Ihre AWS Konto-ID.
+ *projectId*ist die Kennung für das Projekt, für das Sie Zugriff gewähren möchten.
Ebenso ermöglicht die folgende Beispielrichtlinie den programmatischen Zugriff auf die Analysedaten nur für eine bestimmte Kampagne:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryCampaignAnalytics",
"Effect": "Allow",
"Action": "mobiletargeting:GetCampaignDateRangeKpi",
"Resource": "arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/campaigns/campaignId/kpis/*"
}
]
}
```
------
Wobei Folgendes gilt:
+ *region*ist der Name der AWS Region, in der das Projekt gehostet wird.
+ *accountId*ist deine AWS-Konto ID.
+ *projectId*ist die Kennung für das Projekt, das mit der Kampagne verknüpft ist.
+ *campaignId*ist die Kennung für die Kampagne, für die Sie Zugriff gewähren möchten.
Und die folgende Beispielrichtlinie ermöglicht den programmgesteuerten Zugriff auf alle Analysedaten, sowohl Engagement- als auch Ausführungsdaten, für eine bestimmte Journey und die Aktivitäten, die diese Journey umfassen:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryJourneyAnalytics",
"Effect": "Allow",
"Action": [
"mobiletargeting:GetJourneyDateRangeKpi",
"mobiletargeting:GetJourneyExecutionMetrics",
"mobiletargeting:GetJourneyExecutionActivityMetrics"
],
"Resource": [
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/execution-metrics",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/activities/*/execution-metrics"
]
}
]
}
```
------
Wobei Folgendes gilt:
+ *region*ist der Name der AWS Region, die das Projekt hostet.
+ *accountId*ist Ihre AWS Konto-ID.
+ *projectId*ist die Kennung für das Projekt, das mit der Reise verknüpft ist.
+ *journeyId*ist die Kennung für die Reise, zu der Sie Zugriff gewähren möchten.
Eine vollständige Liste der Amazon-Pinpoint-API-Aktionen, die Sie in IAM-Richtlinien verwenden können, finden Sie unter [Amazon-Pinpoint-Aktionen für IAM-Richtlinien](permissions-actions.md). Ausführliche Informationen zum Erstellen und Verwalten von IAM-Richtlinien finden Sie im [IAM-Benutzerhandbuch](https://docs.aws.amazon.com/IAM/latest/UserGuide/).
# Standardkennzahlen, die für Projekte, Kampagnen und Journeys von Amazon Pinpoint gelten
Sie können Amazon Pinpoint Analytics verwenden, APIs um Analysedaten für eine Teilmenge von Standardmetriken abzufragen, die für Amazon Pinpoint Pinpoint-Projekte, -Kampagnen und Journeys gelten. Bei diesen Metriken, die auch als *wichtige Leistungsindikatoren (KPIs)* bezeichnet werden, handelt es sich um messbare Werte, mit deren Hilfe Sie die Leistung von Projekten, Kampagnen und Journeys überwachen und bewerten können.
Amazon Pinpoint bietet programmgesteuerten Zugriff auf Analysedaten für verschiedene Arten von Standardmetriken:
+ **Anwendungsmetriken**: Diese Metriken bieten Einblicke in die Trends für alle Kampagnen und Transaktionsnachrichten, die einem Projekt zugeordnet sind, auch als *Anwendung* bezeichnet. Sie können eine Anwendungsmetrik beispielsweise verwenden, um eine Aufschlüsselung der Anzahl der Nachrichten abzurufen, die von Empfängern für jede Kampagne geöffnet wurden, die einem Projekt zugeordnet ist.
+ **Kampagnenmetriken**: Diese Metriken geben Aufschluss über die Leistung einzelner Kampagnen. Sie können eine Kampagnenmetrik beispielsweise verwenden, um die Anzahl der Endpunkte zu bestimmen, an die eine Kampagnennachricht gesendet wurde, oder die Anzahl dieser Nachrichten, die an Endpunkte übermittelt wurden.
+ **Journey-Engagement-Metriken**: Diese Metriken geben einen Einblick in die Leistung der einzelnen Journeys. Beispielsweise können Sie eine Journey-Engagement-Metrikverwenden, um eine Aufschlüsselung der Anzahl der Nachrichten zu erhalten, die von den Teilnehmern an jeder Aktivität einer Journey geöffnet wurden.
+ **Journey-Ausführungsmetriken**: Diese Metriken geben Aufschluss über die Entwicklung der Teilnahme an einzelnen Journeys. Beispielsweise können Sie mit Hilfe einer Journey-Ausführungsmetrik bestimmen, wie viele Teilnehmer eine Journey begonnen haben.
+ **Journey-Aktivitätsausführungsmetriken**: Diese Metriken geben Aufschluss über die Entwicklung der Beteiligungstrends für einzelne Aktivitäten einer Journey. Beispielsweise können Sie mit einer Journey-Aktivitätsusführungsmetrik bestimmen, wie viele Teilnehmer eine Aktivität gestartet haben und wie viele Teilnehmer jeden Pfad in einer Aktivität abgeschlossen haben.
In den Themen in diesem Abschnitt sind die einzelnen Metriken aufgeführt und beschrieben, die Sie für jeden Metriktyp abfragen können.
**Topics**
+ [Amazon Pinpoint Pinpoint-Anwendungsmetriken für Kampagnen](application-metrics-campaigns.md)
+ [Amazon Pinpoint Pinpoint-Anwendungsmetriken für Transaktions-E-Mail-Nachrichten](application-metrics-txn-email.md)
+ [Amazon Pinpoint Pinpoint-Anwendungsmetriken für Transaktions-SMS-Nachrichten](application-metrics-txn-sms.md)
+ [Kampagnenmetriken von Amazon Pinpoint](campaign-metrics.md)
+ [Kennzahlen zum Kundenengagement mit Amazon Pinpoint](journey-metrics-engagement-email.md)
+ [Kennzahlen zur Ausführung von Amazon Pinpoint Journeys](journey-metrics-execution.md)
+ [Kennzahlen zur Ausführung von Amazon Pinpoint Journey-Aktivitäten](journey-metrics-activity-execution.md)
+ [Kennzahlen zur Reise und zur Kampagnenausführung von Amazon Pinpoint](journey-run-metrics-activity-execution.md)
# Amazon Pinpoint Pinpoint-Anwendungsmetriken für Kampagnen
In der folgenden Tabelle werden Standardanwendungsmetriken aufgeführt und beschrieben, die Sie abfragen können, um die Leistung aller Kampagnen zu bewerten, die einem Amazon-Pinpoint-Projekt zugeordnet sind. Um Daten für diese Metriken abzufragen, verwenden Sie die Ressource [Anwendungsmetriken](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) der Amazon-Pinpoint-API. Die Spalte **kpi-name** in der Tabelle gibt den Wert an, der für den `kpi-name`-Parameter in einer Abfrage verwendet werden soll.
| Metrik | Kpi-name | Description |
| --- | --- | --- |
| Delivery rate (Zustellungsrate) | `successful-delivery-rate` | Prozentsatz der Nachrichten, die Empfängern zugestellt wurden, für alle Kampagnen, die einem Projekt zugeordnet sind. Diese Metrik wird als Anzahl der Nachrichten berechnet, die von allen Kampagnen für ein Projekt gesendet und Empfängern zugestellt wurden, dividiert durch die Anzahl der Nachrichten, die von all diesen Kampagnen gesendet wurden. |
| Zustellungsrate, gruppiert nach Datum | `successful-delivery-rate-grouped-by-date` | Prozentsatz der Nachrichten, die an jedem Tag im angegebenen Zeitraum einem Empfänger zugestellt wurden, für alle Kampagnen, die einem Projekt zugeordnet sind. Diese Metrik wird als Anzahl der Nachrichten gesendet, die von allen Kampagnen für ein Projekt gesendet und Empfängern zugestellt wurden, dividiert durch die Anzahl der Nachrichten, die von all diesen Kampagnen an jedem Tag im angegebenen Zeitraum gesendet wurden. Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Email open rate (E-Mail-Öffnungsrate) | `email-open-rate` | Prozentsatz der E-Mail-Nachrichten, die von Empfängern geöffnet wurden, für alle Kampagnen, die einem Projekt zugeordnet sind. Diese Metrik wird als Anzahl der E-Mail-Nachrichten berechnet, die von allen Kampagnen für ein Projekt gesendet und von Empfängern geöffnet wurden, dividiert durch die Anzahl der E-Mail-Nachrichten, die von all diesen Kampagnen gesendet und Empfängern zugestellt wurden. |
| E-Mail-Öffnungsrate, gruppiert nach Kampagne | `email-open-rate-grouped-by-campaign` | Prozentsatz der E-Mail-Nachrichten, die vom Empfänger geöffnet wurden, für jede Kampagne, die einem Projekt zugeordnet ist. Diese Metrik wird als Anzahl der E-Mail-Nachrichten berechnet, die von einer Kampagne gesendet und von Empfängern geöffnet wurden, dividiert durch die Anzahl der E-Mail-Nachrichten, die von der Kampagne gesendet und Empfängern zugestellt wurden. Die Abfrageergebnisse für diese Metrik werden nach der Kampagnen-ID (`CampaignId`) gruppiert, einer Zeichenfolge, die eine Kampagne eindeutig identifiziert. |
| Endpunktzustellungen | `unique-deliveries` | Anzahl der eindeutigen Endpunkte, an die Nachrichten gesendet wurden, für alle Kampagnen, die einem Projekt zugeordnet sind. |
| Endpunktzustellungen, gruppiert nach Kampagne | `unique-deliveries-grouped-by-campaign` | Anzahl der eindeutigen Endpunkte, an die Nachrichten gesendet wurden, für jede Kampagne, die einem Projekt zugeordnet ist. Die Abfrageergebnisse für diese Metrik werden nach der Kampagnen-ID (`CampaignId`) gruppiert, einer Zeichenfolge, die eine Kampagne eindeutig identifiziert. |
| Endpunktzustellungen, gruppiert nach Datum | `unique-deliveries-grouped-by-date` | Anzahl der eindeutigen Endpunkte, an die an jedem Tag im angegebenen Zeitraum Nachrichten gesendet wurden, für alle Kampagnen, die einem Projekt zugeordnet sind. Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Zugestellte Nachrichten, gruppiert nach Kampagne | `successful-deliveries-grouped-by-campaign` | Anzahl der Nachrichten, die Empfängern zugestellt wurden, für jede Kampagne, die einem Projekt zugeordnet ist. Diese Metrik wird als Anzahl der Nachrichten berechnet, die von einer Kampagne gesendet wurden, abzüglich der Anzahl der Nachrichten, die von der Kampagne gesendet wurden und den Empfängern aufgrund permanenter Unzustellbarkeit nicht zugestellt werden konnten. Die Abfrageergebnisse für diese Metrik werden nach der Kampagnen-ID (`CampaignId`) gruppiert, einer Zeichenfolge, die eine Kampagne eindeutig identifiziert. |
| Push open rate (Öffnungsrate nach Push) | `push-open-rate` | Prozentsatz der Push-Benachrichtigungen, die von Empfängern geöffnet wurden, für alle Kampagnen, die einem Projekt zugeordnet sind. Diese Metrik wird als Anzahl der von allen Kampagnen für ein Projekt gesendeten und von Empfängern geöffneten Push-Benachrichtigungen berechnet, dividiert durch die Anzahl der Push-Benachrichtigungen, die von all diesen Kampagnen gesendet und Empfängern zugestellt wurden. |
| Push-Öffnungsrate, gruppiert nach Kampagne | `push-open-rate-grouped-by-campaign` | Prozentsatz der Push-Benachrichtigungen, die von Empfängern geöffnet wurden, für jede Kampagne, die einem Projekt zugeordnet ist. Diese Metrik wird als die Anzahl der Push-Benachrichtigungen berechnet, die von einer Kampagne gesendet und von Empfängern geöffnet wurden, dividiert durch die Anzahl der Push-Benachrichtigungen, die von der Kampagne gesendet und Empfängern zugestellt wurden. Die Abfrageergebnisse für diese Metrik werden nach der Kampagnen-ID (`CampaignId`) gruppiert, einer Zeichenfolge, die eine Kampagne eindeutig identifiziert. |
# Amazon Pinpoint Pinpoint-Anwendungsmetriken für Transaktions-E-Mail-Nachrichten
In der folgenden Tabelle werden Standardanwendungsmetriken aufgeführt und beschrieben, die Sie abfragen können, um Trends für alle Transaktions-E-Mail-Nachrichten zu überwachen, die einem Amazon-Pinpoint-Projekt zugeordnet sind. Um Daten für diese Metriken abzufragen, verwenden Sie die Ressource [Anwendungsmetriken](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) der Amazon-Pinpoint-API. Die Spalte **kpi-name** in der Tabelle gibt den Wert an, der für den `kpi-name`-Parameter in einer Abfrage verwendet werden soll.
Beachten Sie, dass diese Metriken keine Daten zu E-Mail-Nachrichten enthalten, die von Kampagnen gesendet wurden. Sie stellen lediglich Daten zu transaktionsbezogenen E-Mail-Nachrichten bereit. Um Daten nach Nachrichten zu durchsuchen, die von einer oder mehreren Kampagnen gesendet wurden, verwenden Sie eine [Kampagnenmetrik](campaign-metrics.md) oder eine [Anwendungsmetrik für Kampagnen](application-metrics-campaigns.md).
| Metrik | Kpi-name | Description |
| --- | --- | --- |
| Clicks (Klickvorgänge) | `txn-emails-clicked` | Anzahl der Klicks von Empfängern auf die Links in den Nachrichten. Wenn ein Empfänger auf mehrere Links in einer Nachricht oder mehrmals auf denselben Link geklickt hat, wird jeder dieser Klickvorgänge gezählt. |
| Klicks, gruppiert nach Datum | `txn-emails-clicked-grouped-by-date` | Die Anzahl der Klickvorgänge von Empfängern auf Links in den Nachrichten für jeden Tag im angegebenen Zeitraum. Wenn ein Empfänger auf mehrere Links in einer Nachricht oder mehrmals auf denselben Link geklickt hat, wird jeder dieser Klickvorgänge gezählt. Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Complaint rate (Beschwerderate) | `txn-emails-complaint-rate` | Der Prozentsatz der Nachrichten, die von den Empfängern als unerwünschte E-Mails gemeldet wurden. Diese Metrik wird berechnet als die Anzahl der Nachrichten, die von Empfängern als unerwünschte E-Mails gemeldet wurden, geteilt durch die Anzahl der gesendeten Nachrichten. |
| Beschwerderate, gruppiert nach Datum | `txn-emails-complaint-rate-grouped-by-date` | Der Prozentsatz der Nachrichten, die von den Empfängern als unerwünschte E-Mails gemeldet wurden, für jeden Tag im angegebenen Zeitraum. Diese Metrik wird berechnet als die Anzahl der Nachrichten, die von Empfängern als unerwünschte E-Mails gemeldet wurden, geteilt durch die Anzahl der gesendeten Nachrichten für jeden Tag im angegebenen Zeitraum. Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Complaints (Beschwerden) | `txn-emails-with-complaints` | Die Anzahl der Nachrichten, die von Empfängern als unerwünschte E-Mails gemeldet wurden. |
| Beschwerden, gruppiert nach Datum | `txn-emails-with-complaints-grouped-by-date` | Die Anzahl der Nachrichten, die von Empfängern als unerwünschte E-Mails gemeldet wurden, für jeden Tag im angegebenen Zeitraum.Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Deliveries (Zustellungen) | `txn-emails-delivered` | Die Anzahl der Nachrichten, die Empfängern zugestellt wurden. Diese Metrik wird als die Anzahl der gesendeten Nachrichten berechnet, abzüglich der Anzahl der Nachrichten, die aufgrund einer temporären oder permanenten Unzustellbarkeit oder aufgrund einer Ablehnung nicht zugestellt werden konnten. Eine Nachricht wird zurückgewiesen, wenn Amazon Pinpoint feststellt, dass sie Malware enthält. Amazon Pinpoint versucht nicht, abgelehnte Nachrichten zu senden. |
| Zustellungen, gruppiert nach Datum | `txn-emails-delivered-grouped-by-date` | Die Anzahl der Nachrichten, die an Empfänger zugestellt wurden, für jeden Tag im angegebenen Zeitraum. Diese Metrik wird berechnet als die Anzahl der gesendeten Nachrichten, abzüglich der Anzahl der Nachrichten, die aufgrund einer temporären oder permanenten Unzustellbarkeit oder einer Ablehnung nicht zugestellt werden konnten (für jeden Tag im angegebenen Zeitraum). Eine Nachricht wird zurückgewiesen, wenn Amazon Pinpoint feststellt, dass sie Malware enthält. Amazon Pinpoint versucht nicht, abgelehnte Nachrichten zu senden. Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Delivery rate (Zustellungsrate) | `txn-emails-delivery-rate` | Der Prozentsatz der Nachrichten, die Empfänger zugestellt wurden. Diese Metrik wird berechnet als die Anzahl der Nachrichten, die gesendet und Empfängern zugestellt wurden, dividiert durch die Anzahl der gesendeten Nachrichten. |
| Zustellungsrate, gruppiert nach Datum | `txn-emails-delivery-rate-grouped-by-date` | Der Prozentsatz der Nachrichten, die an Empfänger zugestellt wurden, für jeden Tag im angegebenen Zeitraum. Diese Metrik wird berechnet als die Anzahl der Nachrichten, die an Empfänger gesendet und zugestellt wurden, geteilt durch die Anzahl der gesendeten Nachrichten, für jeden Tag im angegebenen Zeitraum. Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Hard bounces (Permanente Unzustellbarkeiten) | `txn-emails-hard-bounced` | Die Anzahl der Nachrichten, die aufgrund einer permanenten Unzustellbarkeit nicht an Empfänger übermittelt werden konnten. Eine permanente Unzustellbarkeit tritt auf, wenn ein anhaltendes Problem die Zustellung einer Nachricht verhindert, z. B. wenn die E-Mail-Adresse eines Empfängers nicht existiert. |
| Permanente Unzustellbarkeiten, gruppiert nach Datum | `txn-emails-hard-bounced-grouped-by-date` | Die Anzahl der Nachrichten, die aufgrund einer permanenten Unzustellbarkeit nicht an die Empfänger zugestellt werden konnten (für jeden Tag im angegebenen Zeitraum). Eine permanente Unzustellbarkeit tritt auf, wenn ein anhaltendes Problem die Zustellung einer Nachricht verhindert, z. B. wenn die E-Mail-Adresse eines Empfängers nicht existiert. Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Opens (Öffnungsvorgänge) | `txn-emails-opened` | Die Anzahl der Nachrichten, die von Empfängern geöffnet wurden. |
| Öffnungsvorgänge, gruppiert nach Datum | `txn-emails-opened-grouped-by-date` | Die Anzahl der Nachrichten, die von Empfängern geöffnet wurde (für jeden Tag im angegebenen Zeitraum). Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Sends (Sendevorgänge) | `txn-emails-sent` | Anzahl der gesendeten Nachrichten. |
| Sendevorgänge, gruppiert nach Datum | `txn-emails-sent-grouped-by-date` | Die Anzahl der gesendeten Nachrichten (für jeden Tag im angegebenen Zeitraum). Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Temporäre Unzustellbarkeiten | `txn-emails-soft-bounced` | Die Anzahl der Nachrichten, die aufgrund einer temporären Unzustellbarkeit nicht an Empfänger zugestellt werden konnten. Eine temporäre Unzustellbarkeit tritt auf, wenn ein vorübergehendes Problem die Zustellung einer Nachricht verhindert, z. B. wenn der Posteingang eines Empfängers voll ist oder wenn der empfangende Server vorübergehend nicht verfügbar ist. |
| Temporäre Unzustellbarkeiten, gruppiert nach Datum | `txn-emails-soft-bounced-grouped-by-date` | Die Anzahl der Nachrichten, die aufgrund einer temporären Unzustellbarkeit nicht an Empfänger zugestellt werden konnten (für jeden Tag im angegebenen Zeitraum). Eine temporäre Unzustellbarkeit tritt auf, wenn ein vorübergehendes Problem die Zustellung einer Nachricht verhindert, z. B. wenn der Posteingang eines Empfängers voll ist oder wenn der empfangende Server vorübergehend nicht verfügbar ist. Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Eindeutige Benutzerklickereignisse | `txn-emails-unique-clicks` | Die Anzahl der eindeutigen Empfänger (Endpunkte), die auf Links in Nachrichten geklickt haben. Im Gegensatz zur Metrik **Clicks (Klickvorgänge)** meldet diese Metrik die Anzahl der eindeutigen Empfänger, die auf Links geklickt haben, und nicht die Anzahl der aufgetretenen Klickereignisse. Wenn beispielsweise ein einzelner Empfänger auf mehrere Links in derselben Nachricht oder auf denselben Link mehr als einmal geklickt hat, meldet diese Metrik nur ein Klickereignis für diesen Empfänger. |
| Eindeutige Benutzerklickereignisse, gruppiert nach Datum | `txn-emails-unique-clicks-grouped-by-date` | Die Anzahl der eindeutigen Empfänger (Endpunkte), die für jeden Tag im angegebenen Zeitraum auf Links in Nachrichten geklickt haben. Im Gegensatz zur Metrik für **Clicks, grouped by date (Klickereignisse, gruppiert nach Datum)** meldet diese Metrik die Anzahl der eindeutigen Empfänger, die auf Links geklickt haben, und nicht die Anzahl der aufgetretenen Klickereignisse. Wenn beispielsweise ein einzelner Empfänger auf mehrere Links in derselben Nachricht oder auf denselben Link mehr als einmal geklickt hat, meldet diese Metrik nur ein Klickereignis für diesen Empfänger. Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Eindeutige Benutzeröffnungsvorgänge | `txn-emails-unique-opens` | Die Anzahl der eindeutigen Empfänger (Endpunkte), die Nachrichten geöffnet haben. Anders als die Metrik **Opens (Öffnungsvorgänge)** meldet diese Metrik die Anzahl der eindeutigen Empfänger, die Nachrichten geöffnet haben, und nicht die Anzahl der aufgetretenen Öffnungsvorgänge. Wenn beispielsweise ein einzelner Empfänger dieselbe Nachricht mehrmals öffnet, meldet diese Metrik nur einen Öffnungsvorgang für diesen Empfänger. |
| Eindeutige Öffnungsvorgänge, gruppiert nach Datum | `txn-emails-unique-opens-grouped-by-date` | Die Anzahl der eindeutigen Empfänger (Endpunkte), die Nachrichten geöffnet haben (für jeden Tag im angegebenen Zeitraum). Im Gegensatz zur Metrik **Opens, grouped by date (Öffnungsvorgänge, gruppiert nach Datum)** meldet diese Metrik die Anzahl der eindeutigen Empfänger, die Nachrichten geöffnet haben, und nicht die Anzahl der aufgetretenen Öffnungsvorgänge. Wenn beispielsweise ein einzelner Empfänger dieselbe Nachricht mehrmals öffnet, meldet diese Metrik nur einen Öffnungsvorgang für diesen Empfänger. Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
# Amazon Pinpoint Pinpoint-Anwendungsmetriken für Transaktions-SMS-Nachrichten
In der folgenden Tabelle werden Standardanwendungsmetriken aufgeführt und beschrieben, die Sie abfragen können, um Trends für alle Transaktions-SMS-Nachrichten zu überwachen, die einem Amazon-Pinpoint-Projekt zugeordnet sind. Um Daten für diese Metriken abzufragen, verwenden Sie die Ressource [Anwendungsmetriken](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) der Amazon-Pinpoint-API. Die Spalte **kpi-name** in der Tabelle gibt den Wert an, der für den `kpi-name`-Parameter in einer Abfrage verwendet werden soll.
Beachten Sie, dass diese Metriken keine Daten über SMS-Nachrichten liefern, die von Kampagnen gesendet wurden. Sie stellen lediglich Daten zu transaktionsnezogenen SMS-Nachrichten bereit. Um Daten nach Nachrichten zu durchsuchen, die von einer oder mehreren Kampagnen gesendet wurden, verwenden Sie eine [Kampagnenmetrik](campaign-metrics.md) oder eine [Anwendungsmetrik für Kampagnen](application-metrics-campaigns.md).
| Metrik | Kpi-name | Description |
| --- | --- | --- |
| Durchschnittspreis pro Nachricht, gruppiert nach Land | `txn-sms-average-price-grouped-by-country` | Die durchschnittlichen Kosten für das Senden jeder Nachricht für jedes Land oder jede Region, an die Nachrichten gesendet wurden. Der Preis wird in Tausendstel eines US-Cents angegeben. Wenn der Wert dieses Attributs beispielsweise 645 lautet, wird Ihnen für das Senden der Nachricht 0,645 ¢ in Rechnung gestellt (645/1 000 = 0,645 ¢ = 0,00645 \$1). Diese Metrik wird als Gesamtkosten aller Nachrichten berechnet, die an Empfänger in jedem Land oder Region gesendet wurden, geteilt durch die Anzahl der Nachrichten, die an Empfänger in jedem dieser Länder und Regionen gesendet wurden. Die Abfrageergebnisse für diese Metrik werden im Format ISO 3166-1 alpha-2 nach Land oder Region gruppiert. |
| Durchschnittspreis pro Nachrichtenteil, gruppiert nach Land | `txn-sms-average-price-by-parts-grouped-by-country` | Die durchschnittlichen Kosten für das Senden jedes Nachrichtenteils für jedes Land oder jede Region, an die Nachrichten gesendet wurden. Ein Nachrichtenteil ist ein Teil einer SMS-Nachricht. Der Preis wird in Tausendstel eines US-Cents angegeben. Wenn der Wert dieses Attributs beispielsweise 645 lautet, wird Ihnen für das Senden der Nachricht 0,645 ¢ in Rechnung gestellt (645/1 000 = 0,645 ¢ = 0,00645 \$1). Diese Metrik wird als Gesamtkosten aller Nachrichtenteile berechnet, die an Empfänger in jedem Land oder Region gesendet wurden, geteilt durch die Anzahl der Nachrichtenteile, die an Empfänger in jedem dieser Länder und Regionen gesendet wurden. Die Abfrageergebnisse für diese Metrik werden im Format ISO 3166-1 alpha-2 nach Land oder Region gruppiert. |
| Deliveries (Zustellungen) | `txn-sms-delivered` | Die Anzahl der Nachrichten, die Empfängern zugestellt wurden. |
| Zustellungen, gruppiert nach Land | `txn-sms-delivered-grouped-by-country` | Die Anzahl der Nachrichten, die an Empfänger zugestellt wurden, für jedes Land oder jede Region, an die die Nachrichten gesendet wurden. Die Abfrageergebnisse für diese Metrik werden im Format ISO 3166-1 alpha-2 nach Land oder Region gruppiert. |
| Zustellungen, gruppiert nach Datum | `txn-sms-delivered-grouped-by-date` | Die Anzahl der Nachrichten, die an Empfänger zugestellt wurden, für jeden Tag im angegebenen Zeitraum. Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Zustellungsfehler | `txn-sms-error-distribution` | Die Anzahl der Fehler beim Versuch, die Nachrichten zu senden, für jede Art von aufgetretenem Fehler. Die Abfrageergebnisse für diese Metrik werden nach Fehlercode für jede aufgetretene Fehlerart gruppiert. |
| Delivery rate (Zustellungsrate) | `txn-sms-delivery-rate` | Der Prozentsatz der Nachrichten, die Empfänger zugestellt wurden. Diese Metrik wird berechnet als die Anzahl der Nachrichten, die gesendet und Empfängern zugestellt wurden, dividiert durch die Anzahl der gesendeten Nachrichten. |
| Zustellungsrate, gruppiert nach Datum | `txn-sms-delivery-rate-grouped-by-date` | Der Prozentsatz der Nachrichten, die an Empfänger zugestellt wurden, für jeden Tag im angegebenen Zeitraum. Diese Metrik wird berechnet als die Anzahl der Nachrichten, die an Empfänger gesendet und zugestellt wurden, geteilt durch die Anzahl der gesendeten Nachrichten, für jeden Tag im angegebenen Zeitraum. Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Zugestellte Nachrichtenteile | `txn-sms-delivered-by-parts` | Die Anzahl der Nachrichtenteile, die an Teilnehmer zugestellt wurden. Ein *Nachrichtenteil* ist ein Teil einer SMS-Nachricht. Wenn eine SMS-Nachricht mehr Zeichen enthält, als das SMS-Protokoll zulässt, teilt Amazon Pinpoint die Nachricht in so viele Nachrichtenteile auf, wie erforderlich sind, um die Nachricht an einen Empfänger zu senden. |
| Zugestellte Nachrichtenteile, gruppiert nach Ländern | `txn-sms-delivered-by-parts-grouped-by-country` | Die Anzahl der Nachrichtenteile, die an Empfänger zugestellt wurden, für jedes Land oder jede Region, an die die Nachrichtenteile gesendet wurden. Ein *Nachrichtenteil* ist ein Teil einer SMS-Nachricht. Die Abfrageergebnisse für diese Metrik werden im Format ISO 3166-1 alpha-2 nach Land oder Region gruppiert. |
| Gesendete Nachrichtenteile | `txn-sms-sent-by-parts` | Die Anzahl der gesendeten Nachrichtenteile. Ein *Nachrichtenteil* ist ein Teil einer SMS-Nachricht. Wenn eine SMS-Nachricht mehr Zeichen enthält, als das SMS-Protokoll zulässt, teilt Amazon Pinpoint die Nachricht in so viele Nachrichtenteile auf, wie erforderlich sind, um die Nachricht an einen Empfänger zu senden. |
| Gesendete Nachrichtenteile, gruppiert nach Ländern | `txn-sms-sent-by-parts-grouped-by-country` | Die Anzahl der gesendeten Nachrichtenteile für jedes Land oder jede Region, an die Nachrichten gesendet wurden. Ein *Nachrichtenteil* ist ein Teil einer SMS-Nachricht. Die Abfrageergebnisse für diese Metrik werden im Format ISO 3166-1 alpha-2 nach Land oder Region gruppiert. |
| Messages sent (Gesendete Nachrichten) | `txn-sms-sent` | Anzahl der gesendeten Nachrichten. |
| Gesendete Nachrichten, gruppiert nach Ländern | `txn-sms-sent-grouped-by-country` | Die Anzahl der gesendeten Nachrichten für jedes Land oder jede Region, an die Nachrichten gesendet wurden. Die Abfrageergebnisse für diese Metrik werden im Format ISO 3166-1 alpha-2 nach Land oder Region gruppiert. |
| Gesendete Nachrichten, gruppiert nach Datum | `txn-sms-sent-grouped-by-date` | Die Anzahl der gesendeten Nachrichten (für jeden Tag im angegebenen Zeitraum). Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Gesamtpreis, gruppiert nach Land | `txn-sms-total-price-grouped-by-country` | Die Gesamtkosten für das Senden der Nachrichten für jedes Land oder jede Region, an die Nachrichten gesendet wurden. Der Preis wird in Tausendstel eines US-Cents angegeben. Wenn der Wert dieses Attributs beispielsweise 645 lautet, wird Ihnen für das Senden der Nachricht 0,645 ¢ in Rechnung gestellt (645/1 000 = 0,645 ¢ = 0,00645 \$1). Die Abfrageergebnisse für diese Metrik werden im Format ISO 3166-1 alpha-2 nach Land oder Region gruppiert. |
# Kampagnenmetriken von Amazon Pinpoint
In der folgenden Tabelle werden Standardkampagnenmetriken aufgeführt und beschrieben, die Sie abfragen können, um die Leistung einer einzelnen Kampagne zu bewerten. Um Daten für diese Metriken abzufragen, verwenden Sie die Ressource [Kampagnenmetriken](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) der Amazon-Pinpoint-API. Die Spalte **kpi-name** in der Tabelle gibt den Wert an, der für den `kpi-name`-Parameter in Ihrer Abfrage verwendet werden soll.
| Metrik | Kpi-name | Description |
| --- | --- | --- |
| Bounce rate (Unzustellbarkeitsrate) | `hard-bounce-rate` | Prozentsatz der E-Mail-Nachrichten, die den Empfängern nicht zugestellt werden konnten, für alle Kampagnenausführungen. Diese Metrik berücksichtigt nur permanente Unzustellbarkeiten, d. h. Nachrichten, bei denen es aufgrund eines Problems mit der E-Mail-Adresse des Empfängers dazu kommt, dass die Nachricht dauerhaft nicht zugestellt werden kann. Diese Metrik wird berechnet als Anzahl der unzustellbaren E-Mail-Nachrichten, die von allen Kampagnenausführungen gesendet wurden, dividiert durch die Anzahl der E-Mail-Nachrichten, die von all diesen Kampagnenausführungen gesendet wurden. |
| Unzustellbarkeitsrate, gruppiert nach Kampagnenausführung | `hard-bounce-rate-grouped-by-campaign-activity` | Prozentsatz der E-Mail-Nachrichten, die den Empfängern nicht zugestellt werden konnten, für jede Kampagnenausführung. Diese Metrik berücksichtigt nur permanente Unzustellbarkeiten, d. h. Nachrichten, bei denen es aufgrund eines Problems mit der E-Mail-Adresse des Empfängers dazu kommt, dass die Nachricht dauerhaft nicht zugestellt werden kann. Diese Metrik wird berechnet als Anzahl der unzustellbaren E-Mail-Nachrichten, die von einer Kampagnenausführung gesendet wurden, dividiert durch die Anzahl der E-Mail-Nachrichten, die von der Kampagnenausführung gesendet wurden. Die Abfrageergebnisse für diese Metrik werden nach Kampagnenaktivitäts-ID (`CampaignActivityId`) gruppiert, also einer Zeichenfolge, die eine Kampagnenausführung eindeutig identifiziert. |
| Delivery rate (Zustellungsrate) | `successful-delivery-rate` | Prozentsatz der Nachrichten, die Empfängern zugestellt wurden, für alle Kampagnenausführungen. Diese Metrik wird berechnet als Anzahl der Nachrichten, die von allen Kampagnenausführungen gesendet und den Empfängern zugestellt wurden, dividiert durch die Anzahl der Nachrichten, die von all diesen Kampagnenausführungen gesendet wurden. |
| Zustellrate, gruppiert nach Kampagnenausführung | `successful-delivery-rate-grouped-by-campaign-activity` | Prozentsatz der Nachrichten, die Empfängern zugestellt wurden, für jede Kampagnenausführung. Diese Metrik wird berechnet als die Anzahl der Nachrichten, die von einer Kampagnenausführung gesendet und Empfängern zugestellt wurden, dividiert durch die Anzahl der Nachrichten, die von der Kampagnenausführung gesendet wurden. Die Abfrageergebnisse für diese Metrik werden nach Kampagnenaktivitäts-ID (`CampaignActivityId`) gruppiert, also einer Zeichenfolge, die eine Kampagnenausführung eindeutig identifiziert. |
| Zustellungsrate, gruppiert nach Datum | `successful-delivery-rate-grouped-by-date` | Prozentsatz der Nachrichten, die Empfängern an jedem Tag im angegebenen Zeitraum zugestellt wurden, für alle Kampagnenausführungen. Diese Metrik wird als Anzahl der Nachrichten gesendet, die von allen Kampagnenausführungen gesendet und Empfängern zugestellt wurden, dividiert durch die Anzahl der Nachrichten, die von all diesen Kampagnenausführungen an jedem Tag im angegebenen Zeitraum gesendet wurden. Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Email open rate (E-Mail-Öffnungsrate) | `email-open-rate` | Prozentsatz der E-Mail-Nachrichten, die von Empfängern geöffnet wurden, für alle Kampagnenausführungen.Diese Metrik wird als Anzahl der E-Mail-Nachrichten berechnet, die von allen Kampagnenausführungen gesendet und von Empfängern geöffnet wurden, dividiert durch die Anzahl der E-Mail-Nachrichten, die von all diesen Kampagnenausführungen gesendet und Empfängern zugestellt wurden. |
| E-Mail-Öffnungsrate, gruppiert nach Kampagnenausführung | `email-open-rate-grouped-by-campaign-activity` | Prozentsatz der E-Mail-Nachrichten, die von Empfängern geöffnet wurden, für jede Kampagnenausführung. Diese Metrik wird als Anzahl der E-Mail-Nachrichten berechnet, die von einer Kampagnenausführung gesendet und von Empfängern geöffnet wurden, dividiert durch die Anzahl der E-Mail-Nachrichten, die von der Kampagnenausführung gesendet und Empfängern zugestellt wurden. Die Abfrageergebnisse für diese Metrik werden nach Kampagnenaktivitäts-ID (`CampaignActivityId`) gruppiert, also einer Zeichenfolge, die eine Kampagnenausführung eindeutig identifiziert. |
| Geöffnete E-Mails, gruppiert nach Kampagnenausführung | `direct-email-opens-grouped-by-campaign-activity` | Anzahl der E-Mail-Nachrichten, die von Empfängern geöffnet wurden, für jede Kampagnenausführung. Die Abfrageergebnisse für diese Metrik werden nach Kampagnenaktivitäts-ID (`CampaignActivityId`) gruppiert, also einer Zeichenfolge, die eine Kampagnenausführung eindeutig identifiziert. |
| Endpunktzustellungen | `unique-deliveries` | Anzahl der eindeutigen Endpunkte, an die Nachrichten gesendet wurden, für alle Kampagnenausführungen. |
| Endpunktzustellungen, gruppiert nach Kampagnenausführungen | `unique-deliveries-grouped-by-campaign-activity` | Anzahl der eindeutigen Endpunkte, an die Nachrichten gesendet wurden, für jede Kampagnenausführung. Die Abfrageergebnisse für diese Metrik werden nach Kampagnenaktivitäts-ID (`CampaignActivityId`) gruppiert, also einer Zeichenfolge, die eine Kampagnenausführung eindeutig identifiziert. |
| Endpunktzustellungen, gruppiert nach Datum | `unique-deliveries-grouped-by-date` | Anzahl der eindeutigen Endpunkte, an die an jedem Tag im angegebenen Zeitraum Nachrichten gesendet wurden, für alle Kampagnenausführungen. Die Abfrageergebnisse für diese Metrik werden im erweiterten ISO-8601-Format nach Kalendertag gruppiert. |
| Links, auf die geklickt wurde, gruppiert nach Kampagnenausführung | `clicks-grouped-by-campaign-activity` | Anzahl der Klicks von Empfängern auf die Links in der E-Mail-Nachricht, für jede Kampagnenausführung. Wenn ein Empfänger auf mehrere Links in der Nachricht oder mehrmals auf denselben Link geklickt hat, wird jeder dieser Klicks gezählt. Die Abfrageergebnisse für diese Metrik werden nach Kampagnenaktivitäts-ID (`CampaignActivityId`) gruppiert, also einer Zeichenfolge, die eine Kampagnenausführung eindeutig identifiziert. |
| Zugestellte Nachrichten, gruppiert nach Kampagnenausführung | `successful-deliveries-grouped-by-campaign-activity` | Anzahl der Nachrichten, die Empfängern zugestellt wurden, für jede Kampagnenausführung. Diese Metrik wird als Anzahl der Nachrichten berechnet, die von einer Kampagnenausführung gesendet wurden, abzüglich der Anzahl der Nachrichten, die den Empfängern der Kampagnenausführung aufgrund einer permanenten Unzustellbarkeit nicht zugestellt werden konnten. Die Abfrageergebnisse für diese Metrik werden nach Kampagnenaktivitäts-ID (`CampaignActivityId`) gruppiert, also einer Zeichenfolge, die eine Kampagnenausführung eindeutig identifiziert. |
| Gesendete Nachrichten, gruppiert nach Kampagnenausführung | `attempted-deliveries-grouped-by-campaign-activity` | Anzahl der gesendeten Nachrichten für jede Kampagnenausführung. Die Abfrageergebnisse für diese Metrik werden nach Kampagnenaktivitäts-ID (`CampaignActivityId`) gruppiert, also einer Zeichenfolge, die eine Kampagnenausführung eindeutig identifiziert. |
| Push open rate (Öffnungsrate nach Push) | `push-open-rate` | Prozentsatz der Push-Benachrichtigungen, die von Empfängern geöffnet wurden, für jede Kampagnenausführung. Diese Metrik wird als Anzahl der Push-Benachrichtigungen berechnet, die von allen Kampagnenausführungen gesendet und von Empfängern geöffnet wurden, dividiert durch die Anzahl der Push-Benachrichtigungen, die von all diesen Kampagnenausführungen gesendet und Empfängern zugestellt wurden. |
| Push-Öffnungsrate, gruppiert nach Kampagnenausführung | `push-open-rate-grouped-by-campaign-activity` | Prozentsatz der Push-Benachrichtigungen, die von Empfängern geöffnet wurden, für jede Kampagnenausführung. Diese Metrik wird als Anzahl der Push-Benachrichtigungen berechnet, die von einer Kampagnenausführung gesendet und von den Empfängern geöffnet wurden, dividiert durch die Anzahl der Push-Benachrichtigungen, die von der Kampagnenausführung gesendet und Empfängern zugestellt wurden. Die Abfrageergebnisse für diese Metrik werden nach Kampagnenaktivitäts-ID (`CampaignActivityId`) gruppiert, also einer Zeichenfolge, die eine Kampagnenausführung eindeutig identifiziert. |
| Insgesamt geöffnete Push-Benachrichtigungen, gruppiert nach Kampagnenausführung | `direct-push-opens-grouped-by-campaign-activity` | Anzahl der Push-Benachrichtigungen, die von Empfängern geöffnet wurden, für jede Kampagnenausführung. Die Abfrageergebnisse für diese Metrik werden nach Kampagnenaktivitäts-ID (`CampaignActivityId`) gruppiert, also einer Zeichenfolge, die eine Kampagnenausführung eindeutig identifiziert. |
| Total SMS spend (Gesamte SMS-Ausgaben) | sms-spend | Für alle Kampagnen der Gesamtbetrag, ausgedrückt in Millicent, der für den Versand von SMS ausgegeben wurde. |
# Kennzahlen zum Kundenengagement mit Amazon Pinpoint
Die folgende Tabelle beschreibt Standard-Journey-Engagement-Metriken, die Sie abfragen können, um Trends für alle E-Mail-Nachrichten zu überwachen, die von einer Amazon-Pinpoint-Journey gesendet wurden. Um Daten für diese Metriken abzufragen, verwenden Sie die Ressource [Journey-Engagement-Metriken](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-kpis-daterange-kpi-name.html) der Amazon-Pinpoint-API. Die Spalte **kpi-name** in der Tabelle gibt den Wert an, der für den `kpi-name`-Parameter in einer Abfrage verwendet werden soll.
| Metrik | Kpi-name | Description |
| --- | --- | --- |
| Clicks (Klickvorgänge) | `journey-emails-clicked` | Die Anzahl der Klicks, die Teilnehmer auf Links in den Nachrichten ausgeführt haben. Wenn ein einzelner Teilnehmer mehrere Links in einer Nachricht angeklickt hat oder mehr als einmal auf denselben Link geklickt hat, wird jeder Klick in die Zählung einbezogen. |
| Klicks, gruppiert nach Aktivität | `emails-clicked-grouped-by-journey-activity` | Für jede Aktivität der Journey die Anzahl der Klicks der Teilnehmer auf Links in den Nachrichten. Wenn ein einzelner Teilnehmer mehrere Links in einer Nachricht angeklickt hat oder mehr als einmal auf denselben Link geklickt hat, wird jeder Klick in die Zählung einbezogen. Die Abfrageergebnisse für diese Metrik werden nach der Aktivitäts-ID (`JourneyActivityId`) gruppiert, die eine Zeichenfolge ist, die eine Aktivität eindeutig identifiziert. |
| Complaints (Beschwerden) | `journey-emails-complained` | Die Anzahl der Nachrichten, die von den Teilnehmern als unerwünschte oder unerwünschte E-Mail gemeldet wurden. |
| Beschwerden, gruppiert nach Aktivitäten | `emails-complained-grouped-by-journey-activity` | Für jede Aktivität der Journey die Anzahl der Nachrichten, die von den Teilnehmern als unaufgeforderte oder unerwünschte E-Mail gemeldet wurden.Die Abfrageergebnisse für diese Metrik werden nach der Aktivitäts-ID (`JourneyActivityId`) gruppiert, die eine Zeichenfolge ist, die eine Aktivität eindeutig identifiziert. |
| Deliveries (Zustellungen) | `journey-emails-delivered` | Die Anzahl der Nachrichten, die an Teilnehmer zugestellt wurden. Diese Metrik wird berechnet als die Anzahl der gesendeten Nachrichten, abzüglich der Anzahl der Nachrichten, die aufgrund eines Soft- oder Hard-Bounce nicht zugestellt werden konnten oder weil sie abgelehnt wurden. |
| Zustellungen, gruppiert nach Aktivitäten | `emails-delivered-grouped-by-journey-activity` | Für jede Aktivität der Journey die Anzahl der Nachrichten, die den Teilnehmern zugestellt wurden. Diese Metrik wird berechnet als die Anzahl der gesendeten Nachrichten, abzüglich der Anzahl der Nachrichten, die aufgrund eines Soft- oder Hard-Bounce nicht zugestellt werden konnten oder weil sie abgelehnt wurden, für jede Aktivität der Journey. Die Abfrageergebnisse für diese Metrik werden nach der Aktivitäts-ID (`JourneyActivityId`) gruppiert, die eine Zeichenfolge ist, die eine Aktivität eindeutig identifiziert. |
| Hard bounces (Permanente Unzustellbarkeiten) | `journey-emails-hardbounced` | Die Anzahl der Nachrichten, die den Teilnehmern aufgrund eines Hard-Bounce nicht zugestellt werden konnten. Eine permanente Unzustellbarkeit tritt auf, wenn ein anhaltendes Problem die Zustellung einer Nachricht verhindert, z. B. wenn die E-Mail-Adresse eines Teilnehmers nicht existiert. |
| Hard-Bounces, gruppiert nach Aktivität | `emails-hardbounced-grouped-by-journey-activity` | Für jede Aktivität der Journey die Anzahl der Nachrichten, die den Teilnehmern aufgrund eines Hard-Bounce nicht zugestellt werden konnten. Eine permanente Unzustellbarkeit tritt auf, wenn ein anhaltendes Problem die Zustellung einer Nachricht verhindert, z. B. wenn die E-Mail-Adresse eines Teilnehmers nicht existiert. Die Abfrageergebnisse für diese Metrik werden nach der Aktivitäts-ID (`JourneyActivityId`) gruppiert, die eine Zeichenfolge ist, die eine Aktivität eindeutig identifiziert. |
| Opens (Öffnungsvorgänge) | `journey-emails-opened` | Die Anzahl der Nachrichten, die von Teilnehmern geöffnet wurden. |
| Geöffnet, gruppiert nach Aktivität | `emails-opened-grouped-by-journey-activity` | Für jede Aktivität der Journey die Anzahl der Nachrichten, die von den Teilnehmern geöffnet wurden. Die Abfrageergebnisse für diese Metrik werden nach der Aktivitäts-ID (`JourneyActivityId`) gruppiert, die eine Zeichenfolge ist, die eine Aktivität eindeutig identifiziert. |
| Ablehnungen | `journey-emails-rejected` | Die Anzahl der Nachrichten, die nicht an die Teilnehmer gesendet wurden, weil sie abgelehnt wurden. Eine Nachricht wird zurückgewiesen, wenn Amazon Pinpoint feststellt, dass sie Malware enthält. Amazon Pinpoint versucht nicht, abgelehnte Nachrichten zu senden. |
| Ablehnungen, gruppiert nach Aktivität | `emails-rejected-grouped-by-journey-activity` | Für jede Aktivität der Journey die Anzahl der Nachrichten, die nicht an die Teilnehmer gesendet wurden, weil sie abgelehnt wurden. Eine Nachricht wird zurückgewiesen, wenn Amazon Pinpoint feststellt, dass sie Malware enthält. Amazon Pinpoint versucht nicht, abgelehnte Nachrichten zu senden. Die Abfrageergebnisse für diese Metrik werden nach der Aktivitäts-ID (`JourneyActivityId`) gruppiert, die eine Zeichenfolge ist, die eine Aktivität eindeutig identifiziert. |
| Sends (Sendevorgänge) | `journey-emails-sent` | Anzahl der gesendeten Nachrichten. |
| Gesendet, gruppiert nach Aktivität | `emails-sent-grouped-by-journey-activity` | Für jede Aktivität der Journey die Anzahl der gesendeten Nachrichten. Die Abfrageergebnisse für diese Metrik werden nach der Aktivitäts-ID (`JourneyActivityId`) gruppiert, die eine Zeichenfolge ist, die eine Aktivität eindeutig identifiziert. |
| Temporäre Unzustellbarkeiten | `journey-emails-softbounced` | Die Anzahl der Nachrichten, die aufgrund eines Soft-Bounce nicht an die Teilnehmer übermittelt werden konnten. Eine temporäre Unzustellbarkeit tritt auf, wenn ein vorübergehendes Problem die Zustellung einer Nachricht verhindert, z. B. wenn der Posteingang eines Teilnehmers voll ist oder wenn der empfangende Server vorübergehend nicht verfügbar ist. |
| Soft-Bounces, gruppiert nach Aktivität | `emails-softbounced-grouped-by-journey-activity` | Für jede Aktivität der Journey die Anzahl der Nachrichten, die aufgrund eines Soft-Bounce nicht an die Teilnehmer zugestellt werden konnten. Eine temporäre Unzustellbarkeit tritt auf, wenn ein vorübergehendes Problem die Zustellung einer Nachricht verhindert, z. B. wenn der Posteingang eines Teilnehmers voll ist oder wenn der empfangende Server vorübergehend nicht verfügbar ist. Die Abfrageergebnisse für diese Metrik werden nach der Aktivitäts-ID (`JourneyActivityId`) gruppiert, die eine Zeichenfolge ist, die eine Aktivität eindeutig identifiziert. |
| Abbestellungen | `journey-emails-unsubscribed` | Die Anzahl der Male, die Teilnehmer auf Abmeldelinks in den Nachrichten geklickt haben. Wenn ein einzelner Teilnehmer mehrmals auf den gleichen Abmeldelink geklickt hat, wird jeder Klick in die Zählung einbezogen. |
| Abmeldungen, gruppiert nach Aktivität | `emails-unsubscribed-grouped-by-journey-activity` | Für jede Aktivität der Journey die Anzahl der Male, in denen die Teilnehmer auf Abmeldelinks in den Nachrichten geklickt haben. Wenn ein einzelner Teilnehmer mehrmals auf den gleichen Abmeldelink geklickt hat, wird jeder Klick in die Zählung einbezogen. Die Abfrageergebnisse für diese Metrik werden nach der Aktivitäts-ID (`JourneyActivityId`) gruppiert, die eine Zeichenfolge ist, die eine Aktivität eindeutig identifiziert. |
# Kennzahlen zur Ausführung von Amazon Pinpoint Journeys
Die folgende Tabelle beschreibt Standardausführungsmetriken, die Sie abfragen können, um den Status der Teilnehmer einer Amazon-Pinpoint-Journey zu bewerten. Um Daten für diese Metriken abzufragen, verwenden Sie die Ressource [Journey-Ausführungsmetriken](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-execution-metrics.html) der Amazon-Pinpoint-API. Die Spalte **Field (Feld)** in der Tabelle identifiziert den Namen des Feldes, das in den Suchergebnissen für jede Metrik angezeigt wird.
| Metrik | Feld | Description |
| --- | --- | --- |
| Aktive Teilnehmer | `ENDPOINT_ACTIVE` | Die Anzahl der Teilnehmer, die aktiv durch die Aktivitäten der Journey durchlaufen. Diese Metrik berechnet sich aus der Anzahl der Teilnehmer, die in die Journey eingetreten sind, abzüglich der Anzahl der Teilnehmer, die die Journey verlassen haben, und der Anzahl der Teilnehmer, die aus der Journey entfernt wurden. |
| Teilnehmer-Stornierungen | `CANCELLED` | Die Anzahl der Teilnehmer, die die Journey nicht abgeschlossen haben, weil die Journey storniert wurde. |
| Teilnehmerabgänge | `ENDPOINT_LEFT` | Die Anzahl der Teilnehmer, die die Journey verlassen haben. |
| Teilnehmer | `ENDPOINT_ENTERED` | Die Anzahl der Teilnehmer, die die Journey begonnen haben. |
| Teilnehmerausnahmen, Wiedereintrittslimits | `REENTRY_CAP_EXCEEDED` | Die Anzahl der Teilnehmer, die die Journey nicht beendet haben, weil sie die maximale Anzahl der Male überschritten hätten, die ein einzelner Teilnehmer die Journey wieder aufnehmen kann. |
| Teilnehmerausnahmen, Ablehnungen | `ACTIVE_ENDPOINT_REJECTED` | Die Anzahl der Teilnehmer, die die Journey nicht starten können, weil sie bereits ein aktiver Teilnehmer an der Journey sind. Ein Teilnehmer wird abgelehnt, wenn der Teilnehmer eine Journey startet und Sie anschließend die Endpunktdefinition des Teilnehmers auf eine Weise aktualisieren, die sich auf die Einbeziehung der Teilnehmer in ein Segment (basierend auf Segmentkriterien) oder die Journey (basierend auf Aktivitätsbedingungen) auswirkt. |
# Kennzahlen zur Ausführung von Amazon Pinpoint Journey-Aktivitäten
Die folgende Tabelle beschreibt Standardausführungsmetriken, die Sie abfragen können, um den Status der Teilnehmer in jedem Typ der individuellen Aktivität einer Amazon-Pinpoint-Journey zu bewerten. Um Daten für diese Metriken abzufragen, verwenden Sie die Ressource [Journey-Aktivität-Ausführungsmetriken](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-activities-journey-activity-id-execution-metrics.html) der Amazon-Pinpoint-API. Die Spalte **Metrics (Metriken)** in der Tabelle listet die Felder auf, die in den Suchergebnissen für jede Aktivitätsart erscheinen. Sie enthält auch eine kurze Beschreibung der einzelnen Felder.
| Aktivitätstyp | Kennzahlen |
| --- | --- |
| Ja/Nein-Split (`CONDITIONAL_SPLIT`) | Die Metriken sind: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) Für jeden Pfad in der Aktivität stehen zusätzliche Metriken zur Verfügung. Informationen zu diesen Metriken finden Sie in der Zeile für die Aktivitätsart der Tabelle. |
| Holdout (`HOLDOUT`) | Die Metriken sind: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
| E-Mail (`MESSAGE`) | Die Metriken sind: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
| Mehrfach-Split (`MULTI_CONDITIONAL_SPLIT`) | Für jeden Pfad der Aktivität die Anzahl der Teilnehmer, die zur Aktivität auf dem Pfad übergegangen sind. Die Abfrageergebnisse für diese Metrik sind nach Pfad gruppiert, `Branch_#` wobei *\$1* es sich um die numerische Kennung für einen Pfad handelt, z. B. `Branch_1` für den ersten Pfad der Aktivität. Für jeden Pfad in der Aktivität stehen zusätzliche Metriken zur Verfügung. Informationen zu diesen Metriken finden Sie in der Zeile für die Aktivitätsart der Tabelle. |
| Zufalls-Split (`RANDOM_SPLIT`) | Für jeden Pfad der Aktivität die Anzahl der Teilnehmer, die zur Aktivität auf dem Pfad übergegangen sind. Die Abfrageergebnisse für diese Metrik sind nach Pfad gruppiert, `Branch_#` wobei *\$1* es sich um den numerischen Bezeichner für einen Pfad handelt, z. B. `Branch_1` für den ersten Pfad der Aktivität. Für jeden Pfad in der Aktivität stehen zusätzliche Metriken zur Verfügung. Informationen zu diesen Metriken finden Sie in der Zeile für die Aktivitätsart der Tabelle. |
| Warten (`WAIT`) | Die Metriken sind: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
| Kontaktcenter (`CONTACT_CENTER`) | Die Metriken sind: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
# Kennzahlen zur Reise und zur Kampagnenausführung von Amazon Pinpoint
Sie können Standardausführungsmetriken abfragen, um den Status der Teilnehmer in jedem Typ der individuellen Aktivität einer Amazon-Pinpoint-Journey oder -Kampagne zu bewerten. Um Daten für diese Metriken abzufragen, verwenden Sie die Ressource [Journey-Laufaktivität-Ausführungsmetriken](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-runs-run-id-activities-journey-activity-id-execution-metrics.html) oder [Kampagnenmetriken](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) der Amazon-Pinpoint-API. Die folgende Tabelle listet die Felder auf, die in den Suchergebnissen für jede Aktivitätsart erscheinen.
****
| Metrikname | Gilt für Journeys, Kampagnen oder beides | Description |
| --- | --- | --- |
| ENDPOINT\$1PRODUCED | beides | Die Anzahl der Endpunkte, die ursprünglich aus dem Segment oder Ereignis erstellt wurden, bevor eine Filterung vorgenommen wurde. |
| ENDPOINTS\$1FROM\$1USER | beides | Wenn der Kunde nur über ein Benutzer-ID-Segment verfügt, werden alle Endpunkte dieser Benutzer hinzugefügt. Diese Metrik misst die Anzahl der Endpunkte, die auf diese Weise hinzugefügt wurden. |
| ENDPOINT\$1OPT\$1OUT | beides | Der Endpunkt wurde deaktiviert und hat nicht an der Kampagne oder Journey teilgenommen. |
| ENDPOINT\$1INACTIVE | beides | Der Endpunkt war inaktiv und hat nicht an der Kampagne oder Journey teilgenommen. |
| FILTERED\$1OUT\$1BY\$1SEGMENT | beides | Der Endpunkt entsprach nicht den Segmentfiltern und hat weder an der Kampagne noch an der Journey teilgenommen. |
| ENDPOINT\$1MISSING\$1ADDRESS | beides | Dem Endpunkt fehlte eine Adresse und er hat weder an der Kampagne noch an der Journey teilgenommen. |
| ENDPOINT\$1MISSING\$1CHANNEL | beides | Dem Endpunkt fehlte ein Kanal und er hat weder an der Kampagne noch an der Journey teilgenommen. |
| ENDPOINT\$1MISSING\$1TIMEZONE | beides | Dem Endpunkt fehlte ein Wert für die Zeitzone und er wurde herausgefiltert. Dies passiert nur, wenn ein Zeitzonenwert erforderlich ist. |
| ENDPOINT\$1TIMEZONE\$1MISMATCH | beides | Der Endpunkt befand sich in einer Zeitzone, die zu diesem Zeitpunkt nicht in der Ausführung enthalten war. |
| ENDPOINT\$1CHANNEL\$1MISMATCH | Kampagnen | Für die Kampagne ist keine Nachricht für den Kanaltyp dieses Endpunkts konfiguriert. |
| DUPLICATE\$1ENDPOINT | beides | Doppelte Endpunkte wurden gefunden und dedupliziert. |
| DUPLICATE\$1USER | beides | Doppelte Benutzer wurden gefunden und aus einem Segment, das nur eine Benutzer-ID hat, dedupliziert. Wenn sie dieselbe Benutzer-ID haben, wird die Metrik 1 ausgegeben. |
| PAUSED | Journeys | Aus der Ausführung entfernt, weil die Journey unterbrochen wurde. |
| ENDED | Journeys | Aus der Ausführung entfernt, weil die Journey beendet wurde. |
| TREATMENT\$1HOLDOUT | Kampagnen | Dies wird in A/B Kampagnen für Endgeräte ausgegeben, deren Kohorten nicht der aktuellen Behandlung entsprechen. Bei einer A/B Aufteilung von 50/50 geben beispielsweise 50% der Endpunkte diese Metrik für jede Behandlung aus |
| ENDPOINT\$1ESTIMATED\$1TIMEZONE | Journeys | Die Zeitzonenschätzung war in der Lage, eine Zeitzone für den Endpunkt zu schätzen. |
# Amazon Pinpoint Pinpoint-Analysedaten für Kampagnen abfragen
Zusätzlich zur Nutzung der Analyseseiten in der Amazon Pinpoint-Konsole können Sie Amazon Pinpoint Analytics verwenden, APIs um Analysedaten für eine Teilmenge von Standardmetriken abzufragen, die Einblicke in Liefer- und Interaktionstrends für Kampagnen bieten.
Jede dieser Metriken ist ein messbarer Wert, auch als *Key Performance Indicator (KPI)* bezeichnet, der Ihnen helfen kann, die Leistung einer oder mehrerer Kampagnen zu überwachen und zu bewerten. Beispielsweise können Sie mit einer Metrik herausfinden, an wie viele Endpunkte eine Kampagnennachricht gesendet wurde oder wie viele dieser Nachrichten an die vorgesehenen Endpunkte zugestellt wurden.
Amazon Pinpoint sammelt und aggregiert diese Daten automatisch für alle Ihre Kampagnen. Der Service speichert die Daten für 90 Tage. Wenn Sie eine mobile App mithilfe eines AWS Mobile SDK in Amazon Pinpoint integriert haben, erweitert Amazon Pinpoint diese Unterstützung um zusätzliche Messwerte, wie z. B. den Prozentsatz der Push-Benachrichtigungen, die von Empfängern geöffnet wurden. Hinweise zum Integrieren einer mobilen Anwendung finden Sie unter [Integrieren Sie Amazon Pinpoint in Ihre Anwendung](integrate.md).
Wenn Sie Amazon Pinpoint Analytics APIs zum Abfragen von Daten verwenden, können Sie verschiedene Optionen wählen, die den Umfang, die Daten, die Gruppierung und die Filter für Ihre Abfrage definieren. Dazu verwenden Sie Parameter, die das Projekt, die Kampagne und die Metrik angeben, die Sie abfragen möchten, zusätzlich zu allen datumsbasierten Filtern, die Sie anwenden möchten.
In diesem Thema wird erläutert und es werden Beispiele aufgeführt, wie Sie diese Optionen auswählen und die Daten für eine oder mehrere Kampagnen abfragen.
## Voraussetzungen
Bevor Sie Analysedaten für eine oder mehrere Kampagnen abfragen, ist es sinnvoll, die folgenden Informationen zu sammeln, die Sie zur Definition Ihrer Abfrage verwenden:
+ **Projekt-ID**: Der eindeutige Bezeichner für das Projekt, das der Kampagne oder den Kampagnen zugeordnet ist. In der Amazon-Pinpoint-API wird dieser Wert in der -Eigenschaft gespeichert. Auf der Amazon-Pinpoint-Konsole wird dieser Wert als Projekt-ID auf der Seite Alle Projekte angezeigt.
+ **Kampagnen-ID**: Die eindeutige Kennung für die Kampagne, wenn Sie die Daten nur für eine Kampagne abfragen möchten. In der Amazon-Pinpoint-API wird dieser Wert in der `campaign-id`-Eigenschaft gespeichert. Dieser Wert wird nicht auf der Konsole angezeigt.
+ **Datumsbereich**: Optional das erste und letzte Datum und die Uhrzeit des Datumsbereichs, für den die Daten abgefragt werden sollen. Datumsbereiche werden inklusiv angegeben und dürfen maximal 31 Kalendertage umfassen. Darüber hinaus müssen sie vor 90 Tagen ab dem aktuellen Tag beginnen. Wenn Sie keinen Datumsbereich angeben, fragt Amazon Pinpoint die Daten für die letzten 31 Kalendertage automatisch ab.
+ **Metriktyp**: Der Typ der abzufragenden Metrik. Es gibt zwei Typen, *Anwendungsmetriken* und *Kampagnenmetriken*. Eine *Anwendungsmetrik* liefert Daten für alle Kampagnen, die einem Projekt zugeordnet sind, auch als *Anwendung* bezeichnet. Eine *Kampagnenmetrik* liefert Daten für nur eine Kampagne.
+ **Metrik**: Der Name der abzufragenden Metrik, genauer gesagt der `kpi-name`-Wert für die Metrik. Eine vollständige Liste der unterstützten Metriken und den `kpi-name`-Wert für die einzelnen Metriken finden Sie unter [Standardmetriken für Projekte, Kampagnen und Journeys](analytics-standard-metrics.md).
Es hilft auch zu bestimmen, ob Sie die Daten nach einem relevanten Feld gruppieren möchten. In diesem Fall können Sie die Analyse und Berichterstellung vereinfachen, indem Sie eine Metrik auswählen, mit der Daten automatisch gruppiert werden sollen. Amazon Pinpoint stellt beispielsweise mehrere Standardmetriken bereit, die den Prozentsatz der Nachrichten melden, die an Empfänger einer Kampagne übermittelt wurden. Eine dieser Metriken gruppiert die Daten automatisch nach Datum (`successful-delivery-rate-grouped-by-date`). Eine weitere Metrik gruppiert die Daten automatisch nach Kampagnenlauf (`successful-delivery-rate-grouped-by-campaign-activity`). Eine dritte Metrik gibt einfach einen einzigen Wert zurück – den Prozentsatz der Meldungen, die bei allen Kampagnenläufen (`successful-delivery-rate`) an die Empfänger zugestellt wurden.
Wenn Sie keine Standardmetrik finden können, die Daten so gruppiert, wie Sie es wünschen, können Sie eine Reihe von Abfragen entwickeln, die die gewünschten Daten zurückgeben. Sie können dann die Abfrageergebnisse manuell aufschlüsseln oder in benutzerdefinierte Gruppen zusammenfassen, die Sie entwerfen.
Schließlich ist es wichtig zu überprüfen, ob Sie berechtigt sind, auf die Daten zuzugreifen, die Sie abfragen möchten. Weitere Informationen finden Sie unter [IAM-Richtlinien zum Abfragen von Amazon-Pinpoint-Analysedaten](analytics-permissions.md).
# Amazon Pinpoint Pinpoint-Daten für eine Kampagne abfragen
Um die Daten für eine Kampagne abzufragen, verwenden Sie die [Kampagnenmetriken](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html)-API und geben Werte für die folgenden erforderlichen Parameter an:
+ **application-id**: Die Projekt-ID, bei der es sich um den eindeutigen Bezeichner für das Projekt handelt, das der Kampagne zugeordnet ist. In Amazon Pinpoint haben die Begriffe *Projekt* und *Anwendung* dieselbe Bedeutung.
+ **campaign-id**: Der eindeutige Bezeichner für die Kampagne.
+ **kpi-name**: Der Name der abzufragenden Metrik. Dieser Wert beschreibt die zugeordnete Metrik und besteht aus zwei oder mehr Begriffen, die aus alphanumerischen Kleinbuchstaben bestehen, die durch einen Bindestrich getrennt sind. Eine vollständige Liste der unterstützten Metriken und den `kpi-name`-Wert für die einzelnen Metriken finden Sie unter [Standardmetriken für Projekte, Kampagnen und Journeys](analytics-standard-metrics.md).
Sie können auch einen Filter anwenden, der die Daten für einen bestimmten Zeitraum abfragt. Wenn Sie keinen Datumsbereich angeben, werden die Daten für die letzten 31 Kalendertage von Amazon Pinpoint zurückgegeben. Um die Daten nach verschiedenen Datumsangaben zu filtern, verwenden Sie die unterstützten Datumsbereichsparameter, um das erste und letzte Datum und die Uhrzeit des Datumsbereichs anzugeben. Die Werte sollten im erweiterten ISO 8601-Format vorliegen und die koordinierte Weltzeit (UTC) verwenden, z. B. `2019-07-19T20:00:00Z` für 20.00 Uhr UTC am 19. Juli 2019. Datumsbereiche werden inklusiv angegeben und dürfen maximal 31 Kalendertage umfassen. Darüber hinaus müssen das erste Datum und die erste Uhrzeit früher als 90 Tage ab dem aktuellen Tag liegen.
Die folgenden Beispiele zeigen, wie Analysedaten für eine Kampagne mithilfe der Amazon Pinpoint REST-API AWS CLI, der und der AWS SDK für Java abgefragt werden. Sie können jedes unterstützte AWS SDK verwenden, um Analysedaten für eine Kampagne abzufragen. Die AWS CLI Beispiele sind für Microsoft Windows formatiert. Ersetzen Sie für Unix, Linux und macOS das Zeilenfortsetzungszeichen (^) durch einen umgekehrten Schrägstrich (\$1).
------
#### [ REST API ]
Um Analysedaten für eine Kampagne mithilfe der Amazon-Pinpoint-REST-API abzufragen, senden Sie eine HTTP(S)-GET-Anforderung an den [Kampagnenmetriken](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html)-URI. Geben Sie im URI die entsprechenden Werte für die erforderlichen Pfadparameter an:
```
https://endpoint/v1/apps/application-id/campaigns/campaign-id/kpis/daterange/kpi-name
```
Wobei Folgendes gilt:
+ *endpoint*ist der Amazon Pinpoint-Endpunkt für die AWS Region, in der das mit der Kampagne verknüpfte Projekt gehostet wird.
+ *application-id* ist der eindeutige Bezeichner für das Projekt, das der Kampagne zugeordnet ist.
+ *campaign-id* ist der eindeutige Bezeichner für die Kampagne.
+ *kpi-name*ist der `kpi-name` Wert für die abzufragende Metrik.
Alle Parameter sollten URL-codiert sein.
Wenn Sie einen Filter anwenden möchten, der die Daten für einen bestimmten Datumsbereich abfragt, hängen Sie die `start-time`- und `end-time`-Abfrageparameter und -werte an den URI an. Mithilfe dieser Parameter können Sie das erste und letzte Datum und die Uhrzeit im erweiterten ISO 8601-Format eines Inklusivdatumsbereichs angeben, für den die Daten abgerufen werden sollen. Verwenden Sie ein kaufmännisches Und-Zeichen (&), um die Parameter zu trennen.
Die folgende Anforderung ruft beispielsweise die Anzahl der eindeutigen Endpunkte ab, an die Nachrichten von allen Ausführungen einer Kampagne vom 19. Juli 2019 bis zum 26. Juli 2019 übermittelt wurden:
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/campaigns/80b8efd84042ff8d9c96ce2f8example/kpis/daterange/unique-deliveries?start-time=2019-07-19T00:00:00Z&end-time=2019-07-26T23:59:59Z
```
Wobei Folgendes gilt:
+ `pinpoint.us-east-1.amazonaws.com` ist der Amazon-Pinpoint-Endpunkt für die AWS -Region, die das Projekt hostet.
+ `1234567890123456789012345example` ist der eindeutige Bezeichner für das Projekt, das der Kampagne zugeordnet ist.
+ `80b8efd84042ff8d9c96ce2f8example` ist der eindeutige Bezeichner für die Kampagne.
+ `unique-deliveries` ist der `kpi-name`-Wert für die *Endpunktzustellungen*-Kampagnenmetrik, d. h. die Metrik, die die Anzahl der eindeutigen Endpunkte angibt, an die Nachrichten von allen Ausführungen einer Kampagne übermittelt wurden.
+ `2019-07-19T00:00:00Z` ist das erste Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
+ `2019-07-26T23:59:59Z` ist das letzte Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
------
#### [ AWS CLI ]
Um Analysedaten für eine Kampagne mithilfe von abzufragen AWS CLI, verwenden Sie den **get-campaign-date-range-kpi** Befehl und geben Sie die entsprechenden Werte für die erforderlichen Parameter an:
```
C:\> aws pinpoint get-campaign-date-range-kpi ^
--application-id application-id ^
--campaign-id campaign-id ^
--kpi-name kpi-name
```
Wobei Folgendes gilt:
+ *application-id* ist der eindeutige Bezeichner für das Projekt, das der Kampagne zugeordnet ist.
+ *campaign-id* ist der eindeutige Bezeichner für die Kampagne.
+ *kpi-name*ist der `kpi-name` Wert für die abzufragende Metrik.
Um einen Filter anzuwenden, der die Daten für einen bestimmten Zeitraum abfragt, fügen Sie der Abfrage die `start-time`- und `end-time`-Parameter und -Werte hinzu. Mithilfe dieser Parameter können Sie das erste und letzte Datum und die Uhrzeit im erweiterten ISO 8601-Format eines Inklusivdatumsbereichs angeben, für den die Daten abgerufen werden sollen. Die folgende Anforderung ruft beispielsweise die Anzahl der eindeutigen Endpunkte ab, an die Nachrichten von allen Ausführungen einer Kampagne vom 19. Juli 2019 bis zum 26. Juli 2019 übermittelt wurden:
```
C:\> aws pinpoint get-campaign-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--campaign-id 80b8efd84042ff8d9c96ce2f8example ^
--kpi-name unique-deliveries ^
--start-time 2019-07-19T00:00:00Z ^
--end-time 2019-07-26T23:59:59Z
```
Wobei Folgendes gilt:
+ `1234567890123456789012345example` ist der eindeutige Bezeichner für das Projekt, das der Kampagne zugeordnet ist.
+ `80b8efd84042ff8d9c96ce2f8example` ist der eindeutige Bezeichner für die Kampagne.
+ `unique-deliveries` ist der `kpi-name`-Wert für die *Endpunktzustellungen*-Kampagnenmetrik, d. h. die Metrik, die die Anzahl der eindeutigen Endpunkte angibt, an die Nachrichten von allen Ausführungen einer Kampagne übermittelt wurden.
+ `2019-07-19T00:00:00Z` ist das erste Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
+ `2019-07-26T23:59:59Z` ist das letzte Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
------
#### [ SDK for Java ]
Verwenden Sie die **GetCampaignDateRangeKpiRequest** Methode der Campaign [Metrics API AWS SDK für Java, um Analysedaten für eine Kampagne](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) mithilfe von abzufragen. Geben Sie die entsprechenden Werte für die erforderlichen Parameter an:
```
GetCampaignDateRangeKpiRequest request = new GetCampaignDateRangeKpiRequest()
.withApplicationId("applicationId")
.withCampaignId("campaignId")
.withKpiName("kpiName")
```
Wobei Folgendes gilt:
+ *applicationId* ist der eindeutige Bezeichner für das Projekt, das der Kampagne zugeordnet ist.
+ *campaignId* ist der eindeutige Bezeichner für die Kampagne.
+ *kpiName*ist der `kpi-name` Wert für die abzufragende Metrik.
Um einen Filter anzuwenden, der die Daten für einen bestimmten Datumsbereich abfragt, schließen Sie die `startTime`- und `endTime`-Parameter und -Werte in die Abfrage ein. Mithilfe dieser Parameter können Sie das erste und letzte Datum und die Uhrzeit im erweiterten ISO 8601-Format eines Inklusivdatumsbereichs angeben, für den die Daten abgerufen werden sollen. Die folgende Anforderung ruft beispielsweise die Anzahl der eindeutigen Endpunkte ab, an die Nachrichten von allen Ausführungen einer Kampagne vom 19. Juli 2019 bis zum 26. Juli 2019 übermittelt wurden:
```
GetCampaignDateRangeKpiRequest request = new GetCampaignDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withCampaignId("80b8efd84042ff8d9c96ce2f8example")
.withKpiName("unique-deliveries")
.withStartTime(Date.from(Instant.parse("2019-07-19T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-07-26T23:59:59Z")));
```
Wobei Folgendes gilt:
+ `1234567890123456789012345example` ist der eindeutige Bezeichner für das Projekt, das der Kampagne zugeordnet ist.
+ `80b8efd84042ff8d9c96ce2f8example` ist der eindeutige Bezeichner für die Kampagne.
+ `unique-deliveries` ist der `kpi-name`-Wert für die *Endpunktzustellungen*-Kampagnenmetrik, d. h. die Metrik, die die Anzahl der eindeutigen Endpunkte angibt, an die Nachrichten von allen Ausführungen einer Kampagne übermittelt wurden.
+ `2019-07-19T00:00:00Z` ist das erste Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
+ `2019-07-26T23:59:59Z` ist das letzte Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
------
Nachdem Sie Ihre Abfrage gesendet haben, gibt Amazon Pinpoint die Abfrageergebnisse in einer JSON-Antwort zurück. Die Struktur der Ergebnisse hängt von der Metrik ab, die Sie abgefragt haben. Einige Metriken geben nur einen Wert zurück. Beispielsweise gibt die Kampagnenmetrik *Endpunkt-Zustellungen* (`unique-deliveries`), die in den vorherigen Beispielen verwendet wurde, einen Wert zurück – die Anzahl der eindeutigen Endpunkte, an die Nachrichten gesendet wurden, für jede Kampagnenausführung. In diesem Fall lautet die JSON-Antwort wie folgt:
```
{
"CampaignDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"CampaignId":"80b8efd84042ff8d9c96ce2f8example",
"EndTime":"2019-07-26T23:59:59Z",
"KpiName":"unique-deliveries",
"KpiResult":{
"Rows":[
{
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"123.0"
}
]
}
]
},
"StartTime":"2019-07-19T00:00:00Z"
}
}
```
Andere Metriken geben mehrere Werte zurück und gruppieren die Werte nach einem relevanten Feld. Wenn eine Metrik mehrere Werte zurückgibt, enthält die JSON-Antwort ein Feld, das angibt, welches Feld zum Gruppieren der Daten verwendet wurde.
Weitere Informationen zur Struktur von Abfrageergebnissen finden Sie unter [Verwenden Sie JSON-Abfrageergebnisse](analytics-query-results.md).
# Fragen Sie Amazon Pinpoint Pinpoint-Daten für mehrere Kampagnen ab
Es gibt zwei Möglichkeiten, die Daten für mehrere Kampagnen abzufragen. Der beste Weg hängt davon ab, ob Sie die Daten für Kampagnen abfragen möchten, die alle demselben Projekt zugeordnet sind. Wenn ja, hängt er außerdem davon ab, ob Sie die Daten für alle Kampagnen oder nur oder nur für eine Teilmenge dieser Kampagnen abfragen möchten.
Um die Daten für Kampagnen abzufragen, die verschiedenen Projekten zugeordnet sind, oder nur für eine Teilmenge der Kampagnen, die demselben Projekt zugeordnet sind, ist es am besten, eine Reihe von einzelnen Abfragen zu erstellen und auszuführen, eine für jede Kampagne, für die Sie die Daten abfragen möchten. Im vorangegangenen Abschnitt wird erläutert, wie die Daten nur für eine Kampagne abgefragt werden.
Um die Daten für alle Kampagnen abzufragen, die demselben Projekt zugeordnet sind, können Sie die [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html)-API verwenden. Geben Sie Werte für die folgenden erforderlichen Parameter an:
+ **application-id**: Die Projekt-ID, bei der es sich um den eindeutigen Bezeichner für das Projekt handelt. In Amazon Pinpoint haben die Begriffe *Projekt* und *Anwendung* dieselbe Bedeutung.
+ **kpi-name**: Der Name der abzufragenden Metrik. Dieser Wert beschreibt die zugeordnete Metrik und besteht aus zwei oder mehr Begriffen, die aus alphanumerischen Kleinbuchstaben bestehen, die durch einen Bindestrich getrennt sind. Eine vollständige Liste der unterstützten Metriken und den `kpi-name`-Wert für die einzelnen Metriken finden Sie unter [Standardmetriken für Projekte, Kampagnen und Journeys](analytics-standard-metrics.md).
Sie können die Daten auch nach Datumsbereich filtern. Wenn Sie keinen Datumsbereich angeben, werden die Daten für die letzten 31 Kalendertage von Amazon Pinpoint zurückgegeben. Um die Daten nach verschiedenen Datumsangaben zu filtern, verwenden Sie die unterstützten Datumsbereichsparameter, um das erste und letzte Datum und die Uhrzeit des Datumsbereichs anzugeben. Die Werte sollten im erweiterten ISO 8601-Format vorliegen und die koordinierte Weltzeit (UTC) verwenden, z. B. `2019-07-19T20:00:00Z` für 20.00 Uhr UTC am 19. Juli 2019. Datumsbereiche werden inklusiv angegeben und dürfen maximal 31 Kalendertage umfassen. Darüber hinaus müssen das erste Datum und die erste Uhrzeit früher als 90 Tage ab dem aktuellen Tag liegen.
Die folgenden Beispiele zeigen, wie Analysedaten für eine Kampagne mithilfe der Amazon Pinpoint REST-API AWS CLI, der und der AWS SDK für Java abgefragt werden. Sie können jedes unterstützte AWS SDK verwenden, um Analysedaten für eine Kampagne abzufragen. Die AWS CLI Beispiele sind für Microsoft Windows formatiert. Ersetzen Sie für Unix, Linux und macOS das Zeilenfortsetzungszeichen (^) durch einen umgekehrten Schrägstrich (\$1).
------
#### [ REST API ]
Um Analysedaten für mehrere Kampagnen mithilfe der Amazon-Pinpoint-REST-API abzufragen, senden Sie eine HTTP(S)-GET-Anforderung an den [Anwendungsmetriken](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html)-URI. Geben Sie im URI die entsprechenden Werte für die erforderlichen Pfadparameter an:
```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```
Wobei Folgendes gilt:
+ *endpoint*ist der Amazon Pinpoint-Endpunkt für die AWS Region, in der das mit den Kampagnen verknüpfte Projekt gehostet wird.
+ *application-id* ist der eindeutige Bezeichner für das Projekt, das den Kampagnen zugeordnet ist.
+ *kpi-name*ist der `kpi-name` Wert für die abzufragende Metrik.
Alle Parameter sollten URL-codiert sein.
Wenn Sie einen Filter anwenden möchten, der die Daten für einen bestimmten Datumsbereich abruft, hängen Sie die `start-time`- und `end-time`-Parameter und -Werte an den URI an. Mithilfe dieser Parameter können Sie das erste und letzte Datum und die Uhrzeit im erweiterten ISO 8601-Format eines Inklusivdatumsbereichs angeben, für den die Daten abgerufen werden sollen. Verwenden Sie ein kaufmännisches Und-Zeichen (&), um die Parameter zu trennen.
Die folgende Anforderung ruft beispielsweise die Anzahl der eindeutigen Endpunkte ab, an die Nachrichten von jeder Kampagne eines Projekts vom 19. Juli 2019 bis zum 26. Juli 2019 übermittelt wurden:
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/unique-deliveries-grouped-by-campaign?start-time=2019-07-19T00:00:00Z&end-time=2019-07-26T23:59:59Z
```
Wobei Folgendes gilt:
+ `pinpoint.us-east-1.amazonaws.com` ist der Amazon-Pinpoint-Endpunkt für die AWS -Region, die das Projekt hostet.
+ `1234567890123456789012345example` ist der eindeutige Bezeichner für das Projekt, das den Kampagnen zugeordnet ist.
+ `unique-deliveries-grouped-by-campaign` ist der `kpi-name`-Wert für die *Endpunktzustellungen, gruppiert nach Kampagne*-Anwendungsmetrik. Dies ist die Metrik, die die Anzahl der eindeutigen Endpunkte zurückgibt, an die Nachrichten von jeder Kampagne übermittelt wurden.
+ `2019-07-19T00:00:00Z` ist das erste Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
+ `2019-07-26T23:59:59Z` ist das letzte Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
------
#### [ AWS CLI ]
Um Analysedaten für mehrere Kampagnen mithilfe von abzufragen AWS CLI, verwenden Sie den **get-application-date-range-kpi** Befehl und geben Sie die entsprechenden Werte für die erforderlichen Parameter an:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id application-id ^
--kpi-name kpi-name
```
Wobei Folgendes gilt:
+ *application-id* ist der eindeutige Bezeichner für das Projekt, das den Kampagnen zugeordnet ist.
+ *kpi-name*ist der `kpi-name` Wert für die abzufragende Metrik.
Um einen Filter anzuwenden, der die Daten für einen bestimmten Zeitraum abruft, schließen Sie die `start-time`- und `end-time`-Parameter und -Werte in die Abfrage ein. Mithilfe dieser Parameter können Sie das erste und letzte Datum und die Uhrzeit im erweiterten ISO 8601-Format eines Inklusivdatumsbereichs angeben, für den die Daten abgerufen werden sollen. Die folgende Anforderung ruft beispielsweise die Anzahl der eindeutigen Endpunkte ab, an die Nachrichten von jeder Kampagne eines Projekts vom 19. Juli 2019 bis zum 26. Juli 2019 übermittelt wurden:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--kpi-name unique-deliveries-grouped-by-campaign ^
--start-time 2019-07-19T00:00:00Z ^
--end-time 2019-07-26T23:59:59Z
```
Wobei Folgendes gilt:
+ `1234567890123456789012345example` ist der eindeutige Bezeichner für das Projekt, das der Kampagne zugeordnet ist.
+ `unique-deliveries-grouped-by-campaign` ist der `kpi-name`-Wert für die *Endpunktzustellungen, gruppiert nach Kampagne*-Anwendungsmetrik. Dies ist die Metrik, die die Anzahl der eindeutigen Endpunkte zurückgibt, an die Nachrichten von jeder Kampagne übermittelt wurden.
+ `2019-07-19T00:00:00Z` ist das erste Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
+ `2019-07-26T23:59:59Z` ist das letzte Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
------
#### [ SDK for Java ]
Verwenden Sie die **GetApplicationDateRangeKpiRequest** Methode der [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) API AWS SDK für Java, um Analysedaten für mehrere Kampagnen mithilfe von abzufragen. Geben Sie die entsprechenden Werte für die erforderlichen Parameter an:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
```
Wobei Folgendes gilt:
+ *applicationId* ist der eindeutige Bezeichner für das Projekt, das den Kampagnen zugeordnet ist.
+ *kpiName*ist der `kpi-name` Wert für die abzufragende Metrik.
Um einen Filter anzuwenden, der die Daten für einen bestimmten Zeitraum abruft, schließen Sie die `startTime`- und `endTime`-Parameter und -Werte in die Abfrage ein. Mithilfe dieser Parameter können Sie das erste und letzte Datum und die Uhrzeit im erweiterten ISO 8601-Format eines Inklusivdatumsbereichs angeben, für den die Daten abgerufen werden sollen. Die folgende Anforderung ruft beispielsweise die Anzahl der eindeutigen Endpunkte ab, an die Nachrichten von jeder Kampagne eines Projekts vom 19. Juli 2019 bis zum 26. Juli 2019 übermittelt wurden:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withKpiName("unique-deliveries-grouped-by-campaign")
.withStartTime(Date.from(Instant.parse("2019-07-19T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-07-26T23:59:59Z")));
```
Wobei Folgendes gilt:
+ `1234567890123456789012345example` ist der eindeutige Bezeichner für das Projekt, das den Kampagnen zugeordnet ist.
+ `unique-deliveries-grouped-by-campaign` ist der `kpi-name`-Wert für die *Endpunktzustellungen, gruppiert nach Kampagne*-Anwendungsmetrik. Dies ist die Metrik, die die Anzahl der eindeutigen Endpunkte zurückgibt, an die Nachrichten von jeder Kampagne übermittelt wurden.
+ `2019-07-19T00:00:00Z` ist das erste Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
+ `2019-07-26T23:59:59Z` ist das letzte Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
------
Nachdem Sie Ihre Abfrage gesendet haben, gibt Amazon Pinpoint die Abfrageergebnisse in einer JSON-Antwort zurück. Die Struktur der Ergebnisse hängt von der Metrik ab, die Sie abgefragt haben. Einige Metriken geben nur einen Wert zurück. Andere Metriken geben mehrere Werte zurück, und diese Werte werden nach einem relevanten Feld gruppiert. Wenn eine Metrik mehrere Werte zurückgibt, enthält die JSON-Antwort ein Feld, das angibt, welches Feld zum Gruppieren der Daten verwendet wurde.
Beispielsweise gibt die Anwendungsmetrik *Endpunkt-Zustellungen, nach Kampagnen gruppiert* (`unique-deliveries-grouped-by-campaign`), die in den vorherigen Beispielen verwendet wurde, mehrere Werte zurück – die Anzahl der eindeutigen Endpunkte, an die Nachrichten gesendet wurden, für jede einem Projekt zugeordnete Kampagne. In diesem Fall lautet die JSON-Antwort wie folgt:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-07-26T23:59:59Z",
"KpiName":"unique-deliveries-grouped-by-campaign",
"KpiResult":{
"Rows":[
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"80b8efd84042ff8d9c96ce2f8example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"123.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"810c7aab86d42fb2b56c8c966example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"456.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"42d8c7eb0990a57ba1d5476a3example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"789.0"
}
]
}
]
},
"StartTime":"2019-07-19T00:00:00Z"
}
}
```
In diesem Fall gibt das `GroupedBys`-Feld an, dass die Werte nach Kampagnen-ID (`CampaignId`) gruppiert sind.
Weitere Informationen zur Struktur von Abfrageergebnissen finden Sie unter [Verwenden Sie JSON-Abfrageergebnisse](analytics-query-results.md).
# Amazon Pinpoint Pinpoint-Analysedaten für Transaktionsnachrichten abfragen
Zusätzlich zur Nutzung der Analyseseiten in der Amazon Pinpoint-Konsole können Sie Amazon Pinpoint Analytics verwenden, APIs um Analysedaten für eine Teilmenge von Standardmetriken abzufragen, die Aufschluss über Liefer- und Engagementtrends für die Transaktionsnachrichten geben, die für ein Projekt gesendet wurden.
Jede dieser Metriken ist ein messbarer Wert, auch als *Key Performance Indicator (KPI)* bezeichnet, der Ihnen helfen kann, die Leistung von transaktionalen Nachrichten zu überwachen und zu bewerten. Beispielsweise können Sie mit einer Metrik herausfinden, wie viele Transaktions-E-Mail- oder SMS-Nachrichten Sie gesendet haben oder wie viele dieser Nachrichten an Empfänger zugestellt wurden. Amazon Pinpoint sammelt und aggregiert diese Daten automatisch für alle Transaktions-E-Mail- und SMS-Nachrichten, die Sie für ein Projekt senden. Der Service speichert die Daten für 90 Tage.
Wenn Sie Amazon Pinpoint Analytics APIs zum Abfragen von Daten verwenden, können Sie verschiedene Optionen wählen, die den Umfang, die Daten, die Gruppierung und die Filter für Ihre Abfrage definieren. Dazu verwenden Sie Parameter, die das Projekt und die Metrik angeben, die Sie abfragen möchten, zusätzlich zu allen datumsbasierten Filtern, die Sie anwenden möchten.
In diesem Thema wird erläutert und es werden Beispiele aufgeführt, wie Sie diese Optionen auswählen und Transaktions-Messaging-Daten für ein Projekt abfragen.
## Voraussetzungen
Bevor Sie Analysedaten für Transaktionsmeldungen abfragen, ist es sinnvoll, die folgenden Informationen zu sammeln, die Sie zur Definition Ihrer Abfrage verwenden:
+ **Projekt-ID**: Der eindeutige Bezeichner für das Projekt, von dem die Nachrichten gesendet wurden. In der Amazon-Pinpoint-API wird dieser Wert in der `application-id`-Eigenschaft gespeichert. Auf der Amazon-Pinpoint-Konsole wird dieser Wert als **Projekt-ID** auf der Seite **Alle Projekte** angezeigt.
+ **Datumsbereich**: Optional das erste und letzte Datum und die Uhrzeit des Datumsbereichs, für den die Daten abgefragt werden sollen. Datumsbereiche werden inklusiv angegeben und dürfen maximal 31 Kalendertage umfassen. Darüber hinaus müssen sie vor 90 Tagen ab dem aktuellen Tag beginnen. Wenn Sie keinen Datumsbereich angeben, fragt Amazon Pinpoint die Daten für die letzten 31 Kalendertage automatisch ab.
+ **Metrik**: Der Name der abzufragenden Metrik, genauer gesagt der `kpi-name`-Wert für die Metrik. Eine vollständige Liste der unterstützten Metriken und den `kpi-name`-Wert für die einzelnen Metriken finden Sie unter [Standardmetriken für Projekte, Kampagnen und Journeys](analytics-standard-metrics.md).
Es hilft auch zu bestimmen, ob Sie die Daten nach einem relevanten Feld gruppieren möchten. In diesem Fall können Sie die Analyse und Berichterstellung vereinfachen, indem Sie eine Metrik auswählen, mit der Daten automatisch gruppiert werden sollen. Amazon Pinpoint stellt beispielsweise mehrere Standardmetriken bereit, die die Anzahl der Transaktions-SMS-Nachrichten melden, die an Empfänger gesendet wurden. Eine dieser Metriken gruppiert die Daten automatisch nach Datum (`txn-sms-delivered-grouped-by-date`). Eine weitere Metrik gruppiert die Daten automatisch nach Land oder Region (`txn-sms-delivered-grouped-by-country`). Eine dritte Metrik gibt einfach einen einzigen Wert zurück – die Anzahl der Meldungen, die an die Empfänger zugestellt wurden (`txn-sms-delivered`). Wenn Sie keine Standardmetrik finden können, die Daten so gruppiert, wie Sie es wünschen, können Sie eine Reihe von Abfragen entwickeln, die die gewünschten Daten zurückgeben. Sie können dann die Abfrageergebnisse manuell aufschlüsseln oder in benutzerdefinierte Gruppen zusammenfassen, die Sie entwerfen.
Schließlich ist es wichtig zu überprüfen, ob Sie berechtigt sind, auf die Daten zuzugreifen, die Sie abfragen möchten. Weitere Informationen finden Sie unter [IAM-Richtlinien zum Abfragen von Amazon-Pinpoint-Analysedaten](analytics-permissions.md).
# Fragen Sie Amazon Pinpoint Pinpoint-Daten für Transaktions-E-Mail-Nachrichten ab
Um die Daten für Transaktions-E-Mail-Nachrichten abzufragen, die für ein Projekt gesendet wurden, verwenden Sie die [Anwendungsmetriken](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html)-API und geben Werte für die folgenden erforderlichen Parameter an:
+ **application-id**: Die Projekt-ID, bei der es sich um den eindeutigen Bezeichner für das Projekt handelt. In Amazon Pinpoint haben die Begriffe *Projekt* und *Anwendung* dieselbe Bedeutung.
+ **kpi-name**: Der Name der abzufragenden Metrik. Dieser Wert beschreibt die zugeordnete Metrik und besteht aus zwei oder mehr Begriffen, die aus alphanumerischen Kleinbuchstaben bestehen, die durch einen Bindestrich getrennt sind. Eine vollständige Liste der unterstützten Metriken und den `kpi-name`-Wert für die einzelnen Metriken finden Sie unter [Standardmetriken für Projekte, Kampagnen und Journeys](analytics-standard-metrics.md).
Sie können auch einen Filter anwenden, der die Daten für einen bestimmten Zeitraum abfragt. Wenn Sie keinen Datumsbereich angeben, werden die Daten für die letzten 31 Kalendertage von Amazon Pinpoint zurückgegeben. Um die Daten nach verschiedenen Datumsangaben zu filtern, verwenden Sie die unterstützten Datumsbereichsparameter, um das erste und letzte Datum und die Uhrzeit des Datumsbereichs anzugeben. Die Werte sollten im erweiterten ISO 8601-Format vorliegen und die koordinierte Weltzeit (UTC) verwenden, z. B. `2019-09-06T20:00:00Z` für 20.00 Uhr UTC am 06. September 2019. Datumsbereiche werden inklusiv angegeben und dürfen maximal 31 Kalendertage umfassen. Darüber hinaus müssen das erste Datum und die erste Uhrzeit früher als 90 Tage ab dem aktuellen Tag liegen.
Die folgenden Beispiele zeigen, wie Analysedaten für Transaktions-E-Mail-Nachrichten mithilfe der Amazon Pinpoint REST-API, der und der AWS CLI abgefragt werden. AWS SDK für Java Sie können jedes unterstützte AWS SDK verwenden, um Analysedaten für Transaktionsnachrichten abzufragen. Die AWS CLI Beispiele sind für Microsoft Windows formatiert. Ersetzen Sie für Unix, Linux und macOS das Zeilenfortsetzungszeichen (^) durch einen umgekehrten Schrägstrich (\$1).
------
#### [ REST API ]
Um Analysedaten für Transaktions-E-Mail-Nachrichten mithilfe der Amazon-Pinpoint-REST-API abzufragen, senden Sie eine HTTP(S)-GET-Anforderung an den [Anwendungsmetriken](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html)-URI. Geben Sie im URI die entsprechenden Werte für die erforderlichen Pfadparameter an:
```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```
Wobei Folgendes gilt:
+ *endpoint*ist der Amazon Pinpoint-Endpunkt für die AWS Region, in der das Projekt gehostet wird.
+ *application-id* ist der eindeutige Bezeichner für das Projekt.
+ *kpi-name*ist der `kpi-name` Wert für die abzufragende Metrik.
Alle Parameter sollten URL-codiert sein.
Wenn Sie einen Filter anwenden möchten, der die Daten für einen bestimmten Datumsbereich abfragt, hängen Sie die `start-time`- und `end-time`-Abfrageparameter und -werte an den URI an. Mithilfe dieser Parameter können Sie das erste und letzte Datum und die Uhrzeit im erweiterten ISO 8601-Format eines Inklusivdatumsbereichs angeben, für den die Daten abgerufen werden sollen. Verwenden Sie ein kaufmännisches Und-Zeichen (&), um die Parameter zu trennen.
Die folgende Anforderung ruft beispielsweise die Anzahl der Transaktions-E-Mail-Nachrichten ab, die für ein Projekt vom 6. September 2019 bis zum 13. September 2019 gesendet wurden:
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/txn-emails-sent?start-time=2019-09-06T00:00:00Z&end-time=2019-09-13T23:59:59Z
```
Wobei Folgendes gilt:
+ `pinpoint.us-east-1.amazonaws.com` ist der Amazon-Pinpoint-Endpunkt für die AWS -Region, die das Projekt hostet.
+ `1234567890123456789012345example` ist der eindeutige Bezeichner für das Projekt.
+ `txn-emails-sent` ist der `kpi-name`-Wert für die *Sendevorgänge*-Anwendungsmetrik, d. h. die Metrik, die die Anzahl der Transaktions-E-Mail-Nachrichten angibt, die für ein Projekt gesendet wurden.
+ `2019-09-06T00:00:00Z` ist das erste Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
+ `2019-09-13T23:59:59Z` ist das letzte Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
------
#### [ AWS CLI ]
Um Analysedaten für Transaktions-E-Mail-Nachrichten mithilfe von abzufragen AWS CLI, verwenden Sie den **get-application-date-range-kpi** Befehl und geben Sie die entsprechenden Werte für die erforderlichen Parameter an:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id application-id ^
--kpi-name kpi-name
```
Wobei Folgendes gilt:
+ *application-id* ist der eindeutige Bezeichner für das Projekt.
+ *kpi-name*ist der `kpi-name` Wert für die abzufragende Metrik.
Um einen Filter anzuwenden, der die Daten für einen bestimmten Zeitraum abfragt, fügen Sie der Abfrage die `start-time`- und `end-time`-Parameter und -Werte hinzu. Mithilfe dieser Parameter können Sie das erste und letzte Datum und die Uhrzeit im erweiterten ISO 8601-Format eines Inklusivdatumsbereichs angeben, für den die Daten abgerufen werden sollen. Die folgende Anforderung ruft beispielsweise die Anzahl der Transaktions-E-Mail-Nachrichten ab, die für ein Projekt vom 6. September 2019 bis zum 13. September 2019 gesendet wurden:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--kpi-name txn-emails-sent ^
--start-time 2019-09-06T00:00:00Z ^
--end-time 2019-09-13T23:59:59Z
```
Wobei Folgendes gilt:
+ `1234567890123456789012345example` ist der eindeutige Bezeichner für das Projekt.
+ `txn-emails-sent` ist der `kpi-name`-Wert für die *Sendevorgänge*-Anwendungsmetrik, d. h. die Metrik, die die Anzahl der Transaktions-E-Mail-Nachrichten angibt, die für ein Projekt gesendet wurden.
+ `2019-09-06T00:00:00Z` ist das erste Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
+ `2019-09-13T23:59:59Z` ist das letzte Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
------
#### [ SDK for Java ]
Verwenden Sie die **GetApplicationDateRangeKpiRequest** Methode der [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) API AWS SDK für Java, um Analysedaten für Transaktions-E-Mail-Nachrichten mithilfe von abzufragen. Geben Sie die entsprechenden Werte für die erforderlichen Parameter an:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
```
Wobei Folgendes gilt:
+ *applicationId* ist der eindeutige Bezeichner für das Projekt.
+ *kpiName*ist der `kpi-name` Wert für die abzufragende Metrik.
Um einen Filter anzuwenden, der die Daten für einen bestimmten Datumsbereich abfragt, schließen Sie die `startTime`- und `endTime`-Parameter und -Werte in die Abfrage ein. Mithilfe dieser Parameter können Sie das erste und letzte Datum und die Uhrzeit im erweiterten ISO 8601-Format eines Inklusivdatumsbereichs angeben, für den die Daten abgerufen werden sollen. Die folgende Anforderung ruft beispielsweise die Anzahl der Transaktions-E-Mail-Nachrichten ab, die für ein Projekt vom 6. September 2019 bis zum 13. September 2019 gesendet wurden:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withKpiName("txn-emails-sent")
.withStartTime(Date.from(Instant.parse("2019-09-06T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-09-13T23:59:59Z")));
```
Wobei Folgendes gilt:
+ `1234567890123456789012345example` ist der eindeutige Bezeichner für das Projekt.
+ `txn-emails-sent` ist der `kpi-name`-Wert für die *Sendevorgänge*-Anwendungsmetrik, d. h. die Metrik, die die Anzahl der Transaktions-E-Mail-Nachrichten angibt, die für ein Projekt gesendet wurden.
+ `2019-09-06T00:00:00Z` ist das erste Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
+ `2019-09-13T23:59:59Z` ist das letzte Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
------
Nachdem Sie Ihre Abfrage gesendet haben, gibt Amazon Pinpoint die Abfrageergebnisse in einer JSON-Antwort zurück. Die Struktur der Ergebnisse hängt von der Metrik ab, die Sie abgefragt haben. Einige Metriken geben nur einen Wert zurück. Beispielsweise gibt die Anwendungsmetrik *Sendungen* (`txn-emails-sent`), die in den vorherigen Beispielen verwendet wurde, einen Wert zurück – die Anzahl der Transaktions-E-Mail-Nachrichten, die von einem Projekt gesendet wurden. In diesem Fall lautet die JSON-Antwort wie folgt:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-09-13T23:59:59Z",
"KpiName":"txn-emails-sent",
"KpiResult":{
"Rows":[
{
"Values":[
{
"Key":"TxnEmailsSent",
"Type":"Double",
"Value":"62.0"
}
]
}
]
},
"StartTime":"2019-09-06T00:00:00Z"
}
}
```
Andere Metriken geben mehrere Werte zurück und gruppieren die Werte nach einem relevanten Feld. Wenn eine Metrik mehrere Werte zurückgibt, enthält die JSON-Antwort ein Feld, das angibt, welches Feld zum Gruppieren der Daten verwendet wurde.
Weitere Informationen zur Struktur von Abfrageergebnissen finden Sie unter [Verwenden Sie JSON-Abfrageergebnisse](analytics-query-results.md).
# Fragen Sie Amazon Pinpoint Pinpoint-Daten für Transaktions-SMS-Nachrichten ab
Um die Daten für Transaktions-SMS-Nachrichten abzufragen, die für ein Projekt gesendet wurden, verwenden Sie die [Anwendungsmetriken](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html)-API und geben Werte für die folgenden erforderlichen Parameter an:
+ **application-id**: Die Projekt-ID, bei der es sich um den eindeutigen Bezeichner für das Projekt handelt. In Amazon Pinpoint haben die Begriffe *Projekt* und *Anwendung* dieselbe Bedeutung.
+ **kpi-name**: Der Name der abzufragenden Metrik. Dieser Wert beschreibt die zugeordnete Metrik und besteht aus zwei oder mehr Begriffen, die aus alphanumerischen Kleinbuchstaben bestehen, die durch einen Bindestrich getrennt sind. Eine vollständige Liste der unterstützten Metriken und den `kpi-name`-Wert für die einzelnen Metriken finden Sie unter [Standardmetriken für Projekte, Kampagnen und Journeys](analytics-standard-metrics.md).
Sie können auch einen Filter anwenden, der die Daten für einen bestimmten Zeitraum abfragt. Wenn Sie keinen Datumsbereich angeben, werden die Daten für die letzten 31 Kalendertage von Amazon Pinpoint zurückgegeben. Um die Daten nach verschiedenen Daten zu filtern, verwenden Sie die unterstützten Datumsbereichsparameter, um das erste Datum und die erste Uhrzeit sowie das letzte Datum und die letzte Uhrzeit des Datumsbereichs anzugeben. Die Werte sollten im erweiterten ISO 8601-Format vorliegen und die koordinierte Weltzeit (UTC) verwenden, z. B. `2019-09-06T20:00:00Z` für 20.00 Uhr UTC am 06. September 2019. Datumsbereiche werden inklusiv angegeben und dürfen maximal 31 Kalendertage umfassen. Darüber hinaus müssen das erste Datum und die erste Uhrzeit früher als 90 Tage ab dem aktuellen Tag liegen.
Die folgenden Beispiele zeigen, wie Analysedaten für Transaktions-SMS-Nachrichten mithilfe der Amazon Pinpoint REST-API, der und der AWS CLI abgefragt werden. AWS SDK für Java Sie können jedes unterstützte AWS SDK verwenden, um Analysedaten für Transaktionsnachrichten abzufragen. Die AWS CLI Beispiele sind für Microsoft Windows formatiert. Ersetzen Sie für Unix, Linux und macOS das Zeilenfortsetzungszeichen (^) durch einen umgekehrten Schrägstrich (\$1).
------
#### [ REST API ]
Um Analysedaten für Transaktions-SMS-Nachrichten mithilfe der Amazon-Pinpoint-REST-API abzufragen, senden Sie eine HTTP(S)-GET-Anforderung an den [Anwendungsmetriken](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html)-URI. Geben Sie im URI die entsprechenden Werte für die erforderlichen Pfadparameter an:
```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```
Wobei Folgendes gilt:
+ *endpoint*ist der Amazon Pinpoint-Endpunkt für die AWS Region, in der das Projekt gehostet wird.
+ *application-id* ist der eindeutige Bezeichner für das Projekt.
+ *kpi-name*ist der `kpi-name` Wert für die abzufragende Metrik.
Alle Parameter sollten URL-codiert sein.
Wenn Sie einen Filter anwenden möchten, der die Daten für einen bestimmten Datumsbereich abruft, hängen Sie die `start-time`- und `end-time`-Parameter und -Werte an den URI an. Mithilfe dieser Parameter können Sie das erste und letzte Datum und die Uhrzeit im erweiterten ISO 8601-Format eines Inklusivdatumsbereichs angeben, für den die Daten abgerufen werden sollen. Verwenden Sie ein kaufmännisches Und-Zeichen (&), um die Parameter zu trennen.
Die folgende Anforderung ruft beispielsweise die Anzahl der Transaktions-SMS-Nachrichten ab, die jeden Tag vom 6. September 2019 bis zum 8. September 2019 gesendet wurden:
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/txn-sms-sent-grouped-by-date?start-time=2019-09-06T00:00:00Z&end-time=2019-09-08T23:59:59Z
```
Wobei Folgendes gilt:
+ `pinpoint.us-east-1.amazonaws.com` ist der Amazon-Pinpoint-Endpunkt für die AWS -Region, die das Projekt hostet.
+ `1234567890123456789012345example` ist der eindeutige Bezeichner für das Projekt.
+ `txn-sms-sent-grouped-by-date` ist der `kpi-name`-Wert für die *Sendevorgänge, gruppiert nach Datum*-Anwendungsmetrik. Dabei handelt es sich um die Metrik, die die Anzahl der Transaktions-SMS-Nachrichten zurückgibt, die an jedem Tag des Datumsbereichs gesendet wurden.
+ `2019-09-06T00:00:00Z` ist das erste Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
+ `2019-09-08T23:59:59Z` ist das letzte Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
------
#### [ AWS CLI ]
Um Analysedaten für Transaktions-SMS-Nachrichten mithilfe von abzufragen AWS CLI, verwenden Sie den **get-application-date-range-kpi** Befehl und geben Sie die entsprechenden Werte für die erforderlichen Parameter an:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id application-id ^
--kpi-name kpi-name
```
Wobei Folgendes gilt:
+ *application-id* ist der eindeutige Bezeichner für das Projekt.
+ *kpi-name*ist der `kpi-name` Wert für die abzufragende Metrik.
Um einen Filter anzuwenden, der die Daten für einen bestimmten Zeitraum abruft, schließen Sie die `start-time`- und `end-time`-Parameter und -Werte in die Abfrage ein. Mithilfe dieser Parameter können Sie das erste und letzte Datum und die Uhrzeit im erweiterten ISO 8601-Format eines Inklusivdatumsbereichs angeben, für den die Daten abgerufen werden sollen. Die folgende Anforderung ruft beispielsweise die Anzahl der Transaktions-SMS-Nachrichten ab, die jeden Tag vom 6. September 2019 bis zum 8. September 2019 gesendet wurden:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--kpi-name txn-sms-sent-grouped-by-date ^
--start-time 2019-09-06T00:00:00Z ^
--end-time 2019-09-08T23:59:59Z
```
Wobei Folgendes gilt:
+ `1234567890123456789012345example` ist der eindeutige Bezeichner für das Projekt.
+ `txn-sms-sent-grouped-by-date` ist der `kpi-name`-Wert für die *Sendevorgänge, gruppiert nach Datum*-Anwendungsmetrik. Dabei handelt es sich um die Metrik, die die Anzahl der Transaktions-SMS-Nachrichten zurückgibt, die an jedem Tag des Datumsbereichs gesendet wurden.
+ `2019-09-06T00:00:00Z` ist das erste Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
+ `2019-09-08T23:59:59Z` ist das letzte Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
------
#### [ SDK for Java ]
Um Analysedaten für Transaktions-SMS-Nachrichten mithilfe von abzufragen AWS SDK für Java, verwenden Sie die **GetApplicationDateRangeKpiRequest** Methode der [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) API und geben Sie die entsprechenden Werte für die erforderlichen Parameter an:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
```
Wobei Folgendes gilt:
+ *applicationId* ist der eindeutige Bezeichner für das Projekt.
+ *kpiName*ist der `kpi-name` Wert für die abzufragende Metrik.
Um einen Filter anzuwenden, der die Daten für einen bestimmten Zeitraum abruft, schließen Sie die `startTime`- und `endTime`-Parameter und -Werte in die Abfrage ein. Mithilfe dieser Parameter können Sie das erste und letzte Datum und die Uhrzeit im erweiterten ISO 8601-Format eines Inklusivdatumsbereichs angeben, für den die Daten abgerufen werden sollen. Die folgende Anforderung ruft beispielsweise die Anzahl der Transaktions-SMS-Nachrichten ab, die jeden Tag vom 6. September 2019 bis zum 8. September 2019 gesendet wurden:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withKpiName("txn-sms-sent-grouped-by-date")
.withStartTime(Date.from(Instant.parse("2019-09-06T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-09-08T23:59:59Z")));
```
Wobei Folgendes gilt:
+ `1234567890123456789012345example` ist der eindeutige Bezeichner für das Projekt.
+ `txn-sms-sent-grouped-by-date` ist der `kpi-name`-Wert für die *Sendevorgänge, gruppiert nach Datum*-Anwendungsmetrik. Dabei handelt es sich um die Metrik, die die Anzahl der Transaktions-SMS-Nachrichten zurückgibt, die an jedem Tag des Datumsbereichs gesendet wurden.
+ `2019-09-06T00:00:00Z` ist das erste Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
+ `2019-09-08T23:59:59Z` ist das letzte Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.
------
Nachdem Sie Ihre Abfrage gesendet haben, gibt Amazon Pinpoint die Abfrageergebnisse in einer JSON-Antwort zurück. Die Struktur der Ergebnisse hängt von der Metrik ab, die Sie abgefragt haben. Einige Metriken geben nur einen Wert zurück. Andere Metriken geben mehrere Werte zurück und gruppieren diese Werte nach einem relevanten Feld. Wenn eine Metrik mehrere Werte zurückgibt, enthält die JSON-Antwort ein Feld, das angibt, welches Feld zum Gruppieren der Daten verwendet wurde.
Beispielsweise gibt die Anwendungsmetrik *Sends, gruppiert nach date* (`txn-sms-sent-grouped-by-date`), die in den vorherigen Beispielen verwendet wurde, mehrere Werte zurück — die Anzahl der Transaktions-SMS-Nachrichten, die an jedem Tag im angegebenen Zeitraum gesendet wurden. In diesem Fall lautet die JSON-Antwort wie folgt:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-09-08T23:59:59Z",
"KpiName":"txn-sms-sent-grouped-by-date",
"KpiResult":{
"Rows":[
{
"GroupedBys":[
{
"Key":"Date",
"Type":"String",
"Value":"2019-09-06"
}
],
"Values":[
{
"Key":"TxnSmsSent",
"Type":"Double",
"Value":"29.0"
}
]
},
{
"GroupedBys":[
{
"Key":"Date",
"Type":"String",
"Value":"2019-09-07"
}
],
"Values":[
{
"Key":"TxnSmsSent",
"Type":"Double",
"Value":"35.0"
}
]
},
{
"GroupedBys":[
{
"Key":"Date",
"Type":"String",
"Value":"2019-09-08"
}
],
"Values":[
{
"Key":"TxnSmsSent",
"Type":"Double",
"Value":"10.0"
}
]
}
]
},
"StartTime":"2019-09-06T00:00:00Z"
}
}
```
In diesem Fall gibt das `GroupedBys`-Feld an, dass die Werte nach Kalendertag (`Date`) gruppiert sind. Dies bedeutet, dass:
+ 29 Nachrichten am 6. September 2019 gesendet wurden.
+ 35 Nachrichten am 7. September 2019 gesendet wurden.
+ 10 Nachrichten am 8. September 2019 gesendet wurden.
Weitere Informationen zur Struktur von Abfrageergebnissen finden Sie unter [Verwenden Sie JSON-Abfrageergebnisse](analytics-query-results.md).
# Verwenden Sie die JSON-Abfrageergebnisse von Amazon Pinpoint Analytics
Wenn Sie Amazon Pinpoint Analytics verwenden, APIs um Analysedaten abzufragen, gibt Amazon Pinpoint die Ergebnisse in einer JSON-Antwort zurück. Bei Anwendungsmetriken, Kampagnenmetriken und Journey-Engagement-Metriken entsprechen die Daten in der Antwort einem Standard JSON-Schema für das Reporting von Amazon-Pinpoint-Analysedaten.
Das bedeutet, dass Sie mit der Programmiersprache oder dem Tool Ihrer Wahl eine benutzerdefinierte Lösung implementieren können, die die Daten für eine oder mehrere dieser Metriken abfragt, die Ergebnisse jeder Abfrage erfasst und die Ergebnisse dann in eine Tabelle, ein Objekt oder einen anderen Speicherort schreibt. Sie können dann mit den Abfrageergebnissen an diesem Speicherort arbeiten, indem Sie einen anderen Service oder eine andere Anwendung verwenden.
Beispielsweise ist Folgendes möglich:
+ Ein benutzerdefiniertes Dashboard erstellen, das regelmäßig eine Reihe von Metriken abfragt und die Ergebnisse mithilfe des bevorzugten Datenvisualisierungsrahmens anzeigt.
+ Erstellen Sie einen Bericht, der die Interaktionsraten verfolgt, indem Sie die entsprechenden Metriken abfragen und die Ergebnisse in einem Diagramm oder einem anderen Berichtstyp anzeigen, den Sie entwerfen.
+ Analysedaten analysieren und in ein bestimmtes Speicherformat schreiben und anschließend die Ergebnisse in eine Langzeitspeicherlösung portieren.
Beachten Sie, dass Amazon Pinpoint Analytics APIs nicht dafür konzipiert ist, persistente Objekte zu erstellen oder zu speichern, die Sie anschließend in einem Amazon Pinpoint Pinpoint-Projekt oder Ihrem Amazon Pinpoint Pinpoint-Konto lesen oder verwenden können. Stattdessen APIs sollen sie Ihnen helfen, Analysedaten abzurufen und diese Daten zur weiteren Analyse, Speicherung oder Berichterstattung an andere Dienste und Anwendungen zu übertragen. Sie tun dies zum Teil, indem sie dieselbe JSON-Antwortstruktur und dasselbe Schema für alle Analysedaten verwenden, die Sie programmgesteuert nach Anwendungsmetriken, Kampagnenmetriken und Journey-Engagement-Metriken abfragen können.
In diesem Thema werden die Struktur, die Objekte und die Felder in einer JSON-Antwort auf eine Anfrage nach einer Anwendungsmetrik, einer Kampagnenmetrik oder einer Journey-Engagement-Metrik erläutert. Informationen zu den Feldern in einer JSON-Antwort auf eine Abfrage für eine Journey-Ausführungs- oder Journey-Aktivitätsausführungsmetrik finden Sie unter [Standardkennzahlen, die für Projekte, Kampagnen und Journeys von Amazon Pinpoint gelten](analytics-standard-metrics.md).
## JSON-Struktur
Um Ihnen bei der Analyse und Verwendung von Abfrageergebnissen zu helfen, verwendet Amazon Pinpoint Analytics APIs dieselbe JSON-Antwortstruktur für alle Amazon Pinpoint Pinpoint-Analysedaten, die Sie programmgesteuert nach Anwendungsmetriken, Kampagnenmetriken und Kennzahlen zur Kundenbindung abfragen können. Jede JSON-Antwort gibt die Werte zur Definition der Abfrage an, wie beispielsweise die Projekt-ID (`ApplicationId`), an. Die Antwort beinhaltet ein (nur ein einziges) `KpiResult`-Objekt. Das `KpiResult`-Objekt enthält die Gesamtergebnismenge für eine Abfrage.
Jedes `KpiResult`-Objekt enthält ein `Rows`-Objekt. Dies ist ein Array von Objekten, die die Abfrageergebnisse und relevante Metadaten zu den Werten in diesen Ergebnissen enthalten. Struktur und Inhalt eines `Rows`-Objekts weisen folgende allgemeine Merkmale auf:
+ Jede Zeile mit Abfrageergebnissen ist ein separates JSON-Objekt mit dem Namen `Values` im `Rows`-Objekt. Wenn eine Abfrage beispielsweise drei Werte zurückgibt, enthält das `Rows`-Objekt drei `Values`-Objekte. Jedes `Values`-Objekt enthält ein individuelles Ergebnis für die Abfrage.
+ Jede Spalte mit Abfrageergebnissen ist eine Eigenschaft des `Values`-Objekts, auf das sie angewendet wird. Der Name der Spalte wird im `Key`-Feld des `Values`-Objekts gespeichert.
+ Für gruppierte Abfrageergebnisse verfügt jedes `Values`-Objekt über ein zugeordnetes `GroupedBys`-Objekt. Das `GroupedBys`-Objekt gibt an, in welchem Feld die Ergebnisse gruppiert wurden. Es liefert auch den Gruppierungswert für das zugehörige `Values`-Objekt.
+ Wenn die Abfrageergebnisse für eine Metrik null sind, ist das `Rows`-Objekt leer.
Neben diesen allgemeinen Merkmalen variieren Struktur und Inhalt des `Rows`-Objekts je nach Metrik. Dies liegt daran, dass zwei Arten von Metriken von Amazon Pinpoint unterstützt werden:*einwertige Metriken* und *mehrwertige Metriken*.
Eine *Einzelwertmetrik* liefert nur einen kumulativen Wert. Ein Beispiel ist der Prozentsatz der Nachrichten, die von allen Läufen einer Kampagne an die Empfänger zugestellt wurden. Eine *Mehrwertmetrik* liefert mehr als einen Wert und gruppiert diese Werte nach einem relevanten Feld. Ein Beispiel ist der Prozentsatz der Nachrichten, die für jeden Lauf einer Kampagne an die Empfänger zugestellt wurden, gruppiert nach Kampagnenlauf.
Sie können schnell feststellen, ob es sich bei einer Metrik um eine einwertige oder eine mehrwertige Metrik handelt, indem Sie Bezug auf den Namen der Metrik nehmen. Wenn `grouped-by` im Namen nicht enthalten ist, handelt es sich um eine einwertige Metrik. Falls doch, handelt es sich um eine mehrwertige Metrik. Eine vollständige Liste der Metriken, die Sie programmgesteuert abfragen können, finden Sie unter [Standardkennzahlen, die für Projekte, Kampagnen und Journeys von Amazon Pinpoint gelten](analytics-standard-metrics.md).
### Einzelwert-Metriken
Bei einer einwertigen Metrik enthält das `Rows`-Objekt ein `Values`-Objekt, das:
+ Den Anzeigenamen der Metrik angibt, die abgefragt wurde.
+ Den Wert für die abgefragte Metrik angibt.
+ Den Datentyp des zurückgegebenen Wertes angibt.
Die folgende JSON-Antwort enthält beispielsweise die Abfrageergebnisse für eine Einzelwertmetrik. Diese Metrik gibt die Anzahl der eindeutigen Endpunkte an, an die Nachrichten von allen Kampagnen, die mit einem Projekt verbunden sind, vom 1. August 2019 bis zum 31. August 2019 gesendet wurden:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-08-31T23:59:59Z",
"KpiName":"unique-deliveries",
"KpiResult":{
"Rows":[
{
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"1368.0"
}
]
}
]
},
"StartTime":"2019-08-01T00:00:00Z"
}
}
```
In diesem Beispiel zeigt die Antwort, dass alle Kampagnen des Projekts vom 1. August 2019 bis 31. August 2019 Nachrichten an 1.368 eindeutige Endpunkte lieferten, wobei folgendes gilt:
+ `Key` ist der Anzeigename der Metrik, deren Wert im `Value`-Feld (`UniqueDeliveries`) angegeben ist.
+ `Type` ist der Datentyp des im `Value`-Feld (`Double`) angegebenen Wertes.
+ `Value` ist der tatsächliche Wert für die Metrik, die abgefragt wurde, einschließlich aller angewendeten Filter (`1368.0`).
Wenn die Abfrageergebnisse für eine einwertige Metrik Null sind (nicht größer oder gleich Null), ist das `Rows`-Objekt leer. Amazon Pinpoint gibt einen Nullwert für eine Metrik zurück, wenn keine Daten für die Metrik zurückgegeben werden können. Beispiel:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"2345678901234567890123456example",
"EndTime":"2019-08-31T23:59:59Z",
"KpiName":"unique-deliveries",
"KpiResult":{
"Rows":[
]
},
"StartTime":"2019-08-01T00:00:00Z"
}
}
```
### Mehrwertige Metriken
Struktur und Inhalt des `Rows`-Objekts für eine mehrwertige Metrik sind meist identisch mit einer einwertigen Metrik. Das `Rows`-Objekt für eine Mehrwertmetrik enthält auch ein `Values`-Objekt. Das `Values`-Objekt gibt den Anzeigenamen der abgefragten Metrik an, liefert den Wert für diese Metrik und identifiziert den Datentyp dieses Wertes.
Das `Rows`-Objekt für eine mehrwertige Metrik enthält jedoch auch ein oder mehrere `GroupedBy`-Objekte. Es gibt ein `GroupedBy`-Objekt für jedes `Values`-Objekt in den Abfrageergebnissen. Das `GroupedBy`-Objekt gibt an, in welchem Feld die Daten in den Ergebnissen gruppiert wurden und den Datentyp dieses Feldes. Es zeigt auch den Gruppierungswert für dieses Feld an (für das zugehörige `Values`-Objekt).
Die folgende JSON-Antwort enthält beispielsweise die Abfrageergebnisse für eine mehrwertige Metrik, die die Anzahl der eindeutigen Endpunkte angibt, an die Nachrichten gesendet wurden, für jede Kampagne, die einem Projekt zugeordnet ist, vom 1. August 2019 bis zum 31. August 2019 :
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-08-31T23:59:59Z",
"KpiName":"unique-deliveries-grouped-by-campaign",
"KpiResult":{
"Rows":[
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"80b8efd84042ff8d9c96ce2f8example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"123.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"810c7aab86d42fb2b56c8c966example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"456.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"42d8c7eb0990a57ba1d5476a3example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"789.0"
}
]
}
]
},
"StartTime":"2019-08-01T00:00:00Z"
}
}
```
In diesem Beispiel zeigt die Antwort an, dass drei der Kampagnen des Projekts vom 1. August 2019 bis zum 31. August 2019 Nachrichten an eindeutige Endpunkte übermittelt haben. Für jede dieser Kampagnen lautet die Aufschlüsselung der Zustellanzahl:
+ Kampagne `80b8efd84042ff8d9c96ce2f8example` hat Nachrichten an 123 eindeutige Endpunkte übermittelt.
+ Kampagne `810c7aab86d42fb2b56c8c966example` hat Nachrichten an 456 eindeutige Endpunkte übermittelt.
+ Kampagne `42d8c7eb0990a57ba1d5476a3example` hat Nachrichten an 789 eindeutige Endpunkte übermittelt.
Wobei dies die allgemeine Struktur der Objekte und Felder ist:
+ `GroupedBys.Key`: Der Name der Eigenschaft oder des Feldes, in dem der im `GroupedBys.Value`-Feld (`CampaignId`) angegebene Gruppierungswert gespeichert wird.
+ `GroupedBys.Type`: Der Datentyp des im `GroupedBys.Value`-Feld (`String`) angegebenen Wertes.
+ `GroupedBys.Value`: Der tatsächliche Wert für das Feld, das zur Gruppierung der Daten verwendet wurde, wie im `GroupedBys.Key`-Feld angegeben (Kampagnen-ID).
+ `Values.Key`: Der Anzeigename der Metrik, deren Wert im `Values.Value`-Feld (`UniqueDeliveries`) angegeben ist.
+ `Values.Type`: Der Datentyp des im `Values.Value`-Feld (`Double`) angegebenen Wertes.
+ `Values.Value`: Der tatsächliche Wert für die abgefragte Metrik, einschließlich aller angewendeten Filter.
Wenn die Abfrageergebnisse für eine mehrwertige Metrik für ein bestimmtes Projekt, eine Kampagne oder eine andere Ressource null (nicht größer als oder gleich Null) sind, werden von Amazon Pinpoint keine Objekte oder Felder für die Ressource zurückgegeben. Wenn die Abfrageergebnisse für eine mehrwertige Metrik für alle Ressourcen null sind, wird ein leeres `Rows`-Objekt von Amazon Pinpoint zurückgegeben.
## JSON-Objekte und -Felder
Zusätzlich zur Angabe der Werte, die eine Abfrage definiert haben, wie z. B. die Projekt-ID (`ApplicationId`), beinhaltet jede JSON-Antwort auf eine Abfrage für eine Anwendungsmetrik, einer Kampagnenmetrik oder einer Journey-Engagement-Metrik ein `KpiResult`-Objekt. Dieses Objekt enthält die Gesamtergebnismenge für eine Abfrage, die Sie analysieren können, um Analysedaten an einen anderen Service oder eine andere Anwendung zu senden. Jedes `KpiResult`-Objekt enthält einige oder alle der folgenden Standardobjekte und -felder, abhängig von der Metrik.
| Objekt oder Feld | Description |
| --- | --- |
| Rows | Ein Array von Objekten, das die Ergebnismenge für eine Abfrage enthält. |
| Rows.GroupedBys | Bei einer mehrwertigen Metrik ein Array von Feldern, das das Feld und die Werte definiert, die zum Gruppieren von Daten in Abfrageergebnissen verwendet wurden. |
| Rows.GroupedBys.Key | Bei einer mehrwertigen Metrik der Name der Eigenschaft oder des Feldes, in dem der im GroupedBys.Value-Feld angegebene Wert gespeichert wird. |
| Rows.GroupedBys.Type | Bei einer mehrwertigen Metrik der Datentyp des im GroupedBys.Value-Feld angegebenen Wertes. |
| Rows.GroupedBys.Value | Bei einer mehrwertigen Metrik der tatsächliche Wert für das Feld, das zum Gruppieren von Daten in Abfrageergebnissen verwendet wurde. Dieser Wert korreliert mit einem zugeordneten Values-Objekt. |
| Rows.Values | Ein Array von Feldern, das Abfrageergebnisse enthält. |
| Rows.Values.Key | Der Anzeigename der Metrik, die abgefragt wurde. Der Wert der Metrik wird im Feld Values.Value angegeben. |
| Rows.Values.Type | Der Datentyp des im Values.Value-Feld angegebenen Wertes. |
| Rows.Values.Value | Der tatsächliche Wert für die abgefragte Metrik, einschließlich aller angewendeten Filter. |
Informationen zu den Feldern in einer JSON-Antwort auf eine Abfrage für eine Journey-Ausführungs- oder Journey-Aktivitätsausführungsmetrik finden Sie unter [Standardkennzahlen, die für Projekte, Kampagnen und Journeys von Amazon Pinpoint gelten](analytics-standard-metrics.md).