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 Pinpoint-Ressourcen (Endpunkte, Segmente, Kampagnen, Journeys und Analysen) zugreifen. Weitere Informationen finden Sie unter Ende des Supports von Amazon Pinpoint. Hinweis: APIs In Bezug auf SMS sind Sprach-, Handy-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.
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:00Zfü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 sindemail-open-rateundsuccessful-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 verwendendenkpi-name-Wert finden Sie unter Standardkennzahlen für Projekte, Kampagnen und Journeys.
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.
