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 Standardkennzahlen für Projekte, Kampagnen und Journeys.

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.