Method: projects.androidApps.deliveryData.list

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

string

Erforderlich. Die Anwendung, für die Lieferdaten aufgelistet werden sollen. Format: projects/{project_id}/androidApps/{appId}

Abfrageparameter

Parameter
pageSize

integer

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

string

Ein Seitentoken, das von einem vorherigen ListAndroidDeliveryDataRequest Aufruf empfangen wurde. Geben Sie dies an, um die nächste Seite abzurufen. Beim Paginieren müssen alle anderen für ListAndroidDeliveryDataRequest bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

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 (AndroidDeliveryData)
    }
  ],
  "nextPageToken": string
}
Felder
androidDeliveryData[]

object ( AndroidDeliveryData )

Die Lieferdaten für die bereitgestellte App. Es gibt einen Eintrag pro Kombination aus App, Datum und Analysebezeichnung.

nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine Folgeseiten.

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 (Date)
  },
  "analyticsLabel": string,
  "data": {
    object (Data)
  }
}
Felder
appId

string

Die App-ID, an die die Nachrichten gesendet wurden.

date

object ( Date )

Das durch diesen Eintrag dargestellte Datum.

analyticsLabel

string

Das mit den gesendeten Nachrichten verknüpfte Analyselabel. Alle ohne Analysekennzeichnung gesendeten Nachrichten werden in einem einzigen Eintrag zusammengefasst.

data

object ( Data )

Die Daten für die angegebene appId , date und analyticsLabel .

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:

JSON-Darstellung
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Jahr des Datums. Muss zwischen 1 und 9999 liegen, oder 0, um ein Datum ohne Jahr anzugeben.

month

integer

Monat eines Jahres. Muss zwischen 1 und 12 liegen oder 0, um ein Jahr ohne Monat und Tag anzugeben.

day

integer

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 (MessageOutcomePercents)
  },
  "deliveryPerformancePercents": {
    object (DeliveryPerformancePercents)
  },
  "messageInsightPercents": {
    object (MessageInsightPercents)
  }
}
Felder
countMessagesAccepted

string ( int64 format)

Anzahl der von FCM akzeptierten Nachrichten für Android-Geräte. Das Zielgerät muss der Erfassung von Nutzungs- und Diagnoseinformationen zugestimmt haben.

messageOutcomePercents

object ( MessageOutcomePercents )

Sich gegenseitig ausschließende Aufschlüsselung der Ergebnisse der Nachrichtenzustellung.

deliveryPerformancePercents

object ( DeliveryPerformancePercents )

Zusätzliche Informationen zur Zustellungsleistung für Nachrichten, die erfolgreich zugestellt wurden.

messageInsightPercents

object ( 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

number

Der Prozentsatz aller akzeptierten Nachrichten, die erfolgreich an das Gerät übermittelt wurden.

pending

number

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

number

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

number

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

number

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

number

Der Prozentsatz der akzeptierten Nachrichten, die vom FCM-System ohne Verzögerung an das Gerät übermittelt wurden.

delayedDeviceOffline

number

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

number

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

number

Der Prozentsatz der akzeptierten Nachrichten, die aufgrund der Nachrichtendrosselung verzögert wurden, z. B. der zusammenklappbaren Nachrichtendrosselung oder der maximalen Nachrichtenratendrosselung .

delayedUserStopped

number

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

number

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 .