- HTTP-Anfrage
- Pfadparameter
- Abfrageparameter
- Anforderungstext
- Antwortkörper
- Autorisierungsbereiche
- AndroidDeliveryData
- Datum
- Daten
- MessageOutcomePercents
- DeliveryPerformancePercents
- MessageInsightPercents
- Versuch es!
Listen Sie aggregierte Lieferdaten für die angegebene Android-Anwendung auf.
HTTP-Anfrage
GET https://fcmdata.googleapis.com/v1beta1/{parent=projects/*/androidApps/*}/deliveryData
Die URL verwendet die gRPC-Transcoding -Syntax.
Pfadparameter
Parameter | |
---|---|
parent | Erforderlich. Die Anwendung, für die Lieferdaten aufgelistet werden sollen. Format: |
Abfrageparameter
Parameter | |
---|---|
pageSize | Die maximale Anzahl der zurückzugebenden Einträge. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Ohne Angabe werden höchstens 1.000 Einträge zurückgegeben. Der Maximalwert beträgt 10.000; Werte über 10.000 werden auf 10.000 begrenzt. Diese Standardeinstellung kann sich im Laufe der Zeit ändern. |
pageToken | Ein Seitentoken, das von einem vorherigen |
Anforderungstext
Der Anfragetext muss leer sein.
Antwortkörper
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
Antwortnachricht für DeliveryData.list.
JSON-Darstellung |
---|
{
"androidDeliveryData": [
{
object ( |
Felder | |
---|---|
androidDeliveryData[] | Die Lieferdaten für die bereitgestellte App. Es gibt einen Eintrag pro Kombination aus App, Datum und Analysebezeichnung. |
nextPageToken | Ein Token, das als |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
-
https://www.googleapis.com/auth/cloud-platform
AndroidDeliveryData
Nachrichtenzustellungsdaten für eine bestimmte Kombination aus Datum, App und Analysebezeichnung.
JSON-Darstellung |
---|
{ "appId": string, "date": { object ( |
Felder | |
---|---|
appId | Die App-ID, an die die Nachrichten gesendet wurden. |
date | Das durch diesen Eintrag dargestellte Datum. |
analyticsLabel | Das mit den gesendeten Nachrichten verknüpfte Analyselabel. Alle ohne Analysekennzeichnung gesendeten Nachrichten werden in einem einzigen Eintrag zusammengefasst. |
data | Die Daten für die angegebene |
Datum
Stellt ein ganzes oder einen Teil des Kalenderdatums dar, beispielsweise einen Geburtstag. Uhrzeit und Zeitzone sind entweder an anderer Stelle angegeben oder ohne Bedeutung. Das Datum ist relativ zum Gregorianischen Kalender. Dies kann Folgendes darstellen:
- Ein vollständiges Datum mit Jahres-, Monats- und Tageswerten ungleich Null.
- Ein Monat und ein Tag mit einem Nulljahr (zum Beispiel ein Jahrestag).
- Ein Jahr für sich, mit einem Monat Null und einem Tag Null.
- Ein Jahr und ein Monat mit einem Nulltag (zum Beispiel das Ablaufdatum einer Kreditkarte).
Verwandte Typen:
-
google.type.TimeOfDay
-
google.type.DateTime
-
google.protobuf.Timestamp
JSON-Darstellung |
---|
{ "year": integer, "month": integer, "day": integer } |
Felder | |
---|---|
year | Jahr des Datums. Muss zwischen 1 und 9999 liegen, oder 0, um ein Datum ohne Jahr anzugeben. |
month | Monat eines Jahres. Muss zwischen 1 und 12 liegen oder 0, um ein Jahr ohne Monat und Tag anzugeben. |
day | Tag eines Monats. Muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein, oder 0, um ein Jahr allein oder ein Jahr und einen Monat anzugeben, bei dem der Tag keine Bedeutung hat. |
Daten
Daten zur Nachrichtenübermittlung
JSON-Darstellung |
---|
{ "countMessagesAccepted": string, "messageOutcomePercents": { object ( |
Felder | |
---|---|
countMessagesAccepted | Anzahl der von FCM akzeptierten Nachrichten für Android-Geräte. Das Zielgerät muss der Erfassung von Nutzungs- und Diagnoseinformationen zugestimmt haben. |
messageOutcomePercents | Sich gegenseitig ausschließende Aufschlüsselung der Ergebnisse der Nachrichtenzustellung. |
deliveryPerformancePercents | Zusätzliche Informationen zur Zustellungsleistung für Nachrichten, die erfolgreich zugestellt wurden. |
messageInsightPercents | Zusätzliche allgemeine Erkenntnisse zur Nachrichtenzustellung. |
MessageOutcomePercents
Prozentuale Aufschlüsselung der Ergebnisse der Nachrichtenzustellung. Diese Kategorien schließen sich gegenseitig aus. Alle Prozentsätze werden mit countMessagesAccepted
als Nenner berechnet. Diese Kategorien berücksichtigen möglicherweise nicht alle Nachrichtenergebnisse.
JSON-Darstellung |
---|
{ "delivered": number, "pending": number, "droppedTooManyPendingMessages": number, "droppedAppForceStopped": number, "droppedDeviceInactive": number } |
Felder | |
---|---|
delivered | Der Prozentsatz aller akzeptierten Nachrichten, die erfolgreich an das Gerät übermittelt wurden. |
pending | Der Prozentsatz der an diesem Tag angenommenen Nachrichten, die aufgrund der Trennung des Geräts nicht verworfen und nicht zugestellt wurden (Stand: Ende des Tages in Amerika/Los_Angeles, an dem die Nachricht an FCM gesendet wurde). Ein Teil dieser Nachrichten wird am nächsten Tag zugestellt, wenn das Gerät eine Verbindung herstellt, andere sind jedoch möglicherweise für Geräte bestimmt, die letztendlich nie wieder eine Verbindung herstellen. |
droppedTooManyPendingMessages | Der Prozentsatz der akzeptierten Nachrichten, die aufgrund zu vieler nicht zugestellter, nicht reduzierbarer Nachrichten verworfen wurden. Konkret kann jede App-Instanz nur 100 ausstehende Nachrichten auf unseren Servern für ein Gerät speichern, das nicht verbunden ist. Wenn dieses Gerät die Verbindung wiederherstellt, werden diese Nachrichten zugestellt. Wenn mehr als die maximale Anzahl ausstehender Nachrichten vorhanden sind, rufen wir OnDeletedMessages() in unserem SDK auf, anstatt die Nachrichten zuzustellen. |
droppedAppForceStopped | Der Prozentsatz der akzeptierten Nachrichten, die verworfen wurden, weil die Anwendung zum Zeitpunkt der Zustellung auf dem Gerät zwangsweise gestoppt wurde und Wiederholungsversuche erfolglos waren. |
droppedDeviceInactive | Der Prozentsatz der akzeptierten Nachrichten, die verworfen wurden, weil das Zielgerät inaktiv ist. FCM verwirft Nachrichten, wenn das Zielgerät von unseren Servern als inaktiv eingestuft wird. Wenn ein Gerät die Verbindung wiederherstellt, rufen wir OnDeletedMessages() in unserem SDK auf, anstatt die Nachrichten zu übermitteln. |
DeliveryPerformancePercents
Übersicht über die Zustellungsleistung für Nachrichten, die erfolgreich zugestellt wurden. Alle Prozentsätze werden mit countMessagesAccepted
als Nenner berechnet. Diese Kategorien schließen sich nicht gegenseitig aus; Eine Nachricht kann aus mehreren Gründen verzögert werden.
JSON-Darstellung |
---|
{ "deliveredNoDelay": number, "delayedDeviceOffline": number, "delayedDeviceDoze": number, "delayedMessageThrottled": number, "delayedUserStopped": number } |
Felder | |
---|---|
deliveredNoDelay | Der Prozentsatz der akzeptierten Nachrichten, die vom FCM-System ohne Verzögerung an das Gerät übermittelt wurden. |
delayedDeviceOffline | Der Prozentsatz der akzeptierten Nachrichten, die verzögert wurden, weil das Zielgerät zum Zeitpunkt des Sendens nicht verbunden war. Diese Nachrichten wurden schließlich übermittelt, als das Gerät erneut eine Verbindung herstellte. |
delayedDeviceDoze | Der Prozentsatz der akzeptierten Nachrichten, die verzögert wurden, weil sich das Gerät im Ruhemodus befand. Aufgrund des Ruhemodus sollten nur Nachrichten mit normaler Priorität verzögert werden. |
delayedMessageThrottled | Der Prozentsatz der akzeptierten Nachrichten, die aufgrund der Nachrichtendrosselung verzögert wurden, z. B. der zusammenklappbaren Nachrichtendrosselung oder der maximalen Nachrichtenratendrosselung . |
delayedUserStopped | Der Prozentsatz der akzeptierten Nachrichten, die verzögert wurden, weil das beabsichtigte Gerätebenutzerprofil zum Zeitpunkt des Versands auf dem Zielgerät gestoppt wurde. Die Nachrichten wurden schließlich zugestellt, als das Benutzerprofil erneut gestartet wurde. |
MessageInsightPercents
Zusätzliche Informationen zur Nachrichtenzustellung. Alle Prozentsätze werden mit countMessagesAccepted
als Nenner berechnet.
JSON-Darstellung |
---|
{ "priorityLowered": number } |
Felder | |
---|---|
priorityLowered | Der Prozentsatz der akzeptierten Nachrichten, deren Priorität von hoch auf normal gesenkt wurde. Informationen zum Festlegen der Nachrichtenpriorität finden Sie in der Dokumentation . |