Method: projects.androidApps.deliveryData.list

Wyświetla zbiorcze dane dotyczące przesyłania dla danej aplikacji na Androida.

Żądanie HTTP

GET https://fcmdata.googleapis.com/v1beta1/{parent=projects/*/androidApps/*}/deliveryData

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

To pole jest wymagane. Aplikacja, dla której ma zostać wyświetlona lista danych dostawy. Format: projects/{projectId}/androidApps/{appId}

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba wpisów do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 1000 wpisów. Maksymalna wartość to 10 000. Wartości powyżej 10 000 będą ograniczone do 10 000. To ustawienie domyślne może się z czasem zmienić.

pageToken

string

Token strony otrzymany z poprzedniego wywołania funkcji ListAndroidDeliveryDataRequest. Podaj go, aby pobrać kolejną stronę. Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListAndroidDeliveryDataRequest muszą być zgodne z wywołaniem, które dostarczyło token strony.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Komunikat z odpowiedzią dla deliveryData.list.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "androidDeliveryData": [
    {
      object (AndroidDeliveryData)
    }
  ],
  "nextPageToken": string
}
Pola
androidDeliveryData[]

object (AndroidDeliveryData)

Dane dotyczące dostawy udostępnionej aplikacji. Na każdą kombinację aplikacji, daty i etykiety analitycznej będzie znajdować się 1 wpis.

nextPageToken

string

Token, który może zostać wysłany jako pageToken w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

Zakresy autoryzacji

Wymaga następującego zakresu protokołu OAuth:

  • https://www.googleapis.com/auth/cloud-platform

DaneDostawa Android

Dane dotyczące dostarczania wiadomości dotyczące określonej kombinacji daty, aplikacji i etykiety Analytics.

Zapis JSON
{
  "appId": string,
  "date": {
    object (Date)
  },
  "analyticsLabel": string,
  "data": {
    object (Data)
  }
}
Pola
appId

string

Identyfikator aplikacji, do której zostały wysłane wiadomości.

date

object (Date)

Data reprezentowana przez ten wpis.

analyticsLabel

string

Etykieta analityczna powiązana z wysłanymi wiadomościami. Wszystkie wiadomości wysłane bez etykiety Analytics zostaną zgrupowane w jednym wpisie.

data

object (Data)

Dane w funkcjach: appId, date i analyticsLabel.

Data

Reprezentuje całą datę lub jej część, na przykład datę urodzin. Pora dnia i strefa czasowa zostały określone w innym miejscu lub są nieistotne. Data zależy od kalendarza gregoriańskiego. Może to być jedna z tych wartości:

  • Pełna data z wartościami niezerowymi dotyczącymi roku, miesiąca i dnia.
  • Miesiąc i dzień bez roku (np. rocznica).
  • Sam rok z zerowym miesiącem i zerowym dniem.
  • Rok i miesiąc z zerową datą ważności (np. data ważności karty kredytowej).

Podobne typy:

Zapis JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer

Rok daty. Wartość musi mieścić się w zakresie od 1 do 9999 lub od 0 do określenia daty bez roku.

month

integer

Miesiąc w roku. Musi mieścić się w zakresie od 1 do 12 lub 0, jeśli chcesz określić rok bez miesiąca i dnia.

day

integer

Dzień miesiąca. Wartość musi należeć do zakresu od 1 do 31 i jest ważna dla roku i miesiąca. Wartość 0 pozwala określić pojedynczy rok lub rok i miesiąc, w którym dzień nie jest istotny.

Dane

Dane ze szczegółowymi informacjami o dostarczaniu wiadomości

Zapis JSON
{
  "countMessagesAccepted": string,
  "countNotificationsAccepted": string,
  "messageOutcomePercents": {
    object (MessageOutcomePercents)
  },
  "deliveryPerformancePercents": {
    object (DeliveryPerformancePercents)
  },
  "messageInsightPercents": {
    object (MessageInsightPercents)
  },
  "proxyNotificationInsightPercents": {
    object (ProxyNotificationInsightPercents)
  }
}
Pola
countMessagesAccepted

string (int64 format)

Liczba wiadomości zaakceptowanych przez FCM przeznaczonych na urządzenia z Androidem. Urządzenie docelowe musi mieć włączoną opcję zbierania informacji o użytkowaniu i diagnostyce.

countNotificationsAccepted

string (int64 format)

Liczba powiadomień zaakceptowanych przez FCM na urządzenia z Androidem. Urządzenie docelowe musi mieć włączoną opcję zbierania informacji o użytkowaniu i diagnostyce.

messageOutcomePercents

object (MessageOutcomePercents)

Wzajemnie wykluczające się wyniki dostarczania wiadomości.

deliveryPerformancePercents

object (DeliveryPerformancePercents)

Dodatkowe informacje o wydajności dostarczania wiadomości, które zostały dostarczone.

messageInsightPercents

object (MessageInsightPercents)

Dodatkowe ogólne statystyki na temat dostarczania wiadomości.

proxyNotificationInsightPercents

object (ProxyNotificationInsightPercents)

Dodatkowe obserwacje dotyczące dostarczania powiadomień przez serwer proxy.

Procent wyników wiadomości

Podział procentowy na wyniki związane z dostarczaniem wiadomości. Kategorie te wzajemnie się wykluczają. Wszystkie wartości procentowe są obliczane jako mianownik countMessagesAccepted. Te kategorie mogą nie uwzględniać wszystkich wiadomości.

Zapis JSON
{
  "delivered": number,
  "pending": number,
  "collapsed": number,
  "droppedTooManyPendingMessages": number,
  "droppedAppForceStopped": number,
  "droppedDeviceInactive": number,
  "droppedTtlExpired": number
}
Pola
delivered

number

Odsetek wszystkich zaakceptowanych wiadomości, które zostały dostarczone na urządzenie.

pending

number

Odsetek wiadomości zaakceptowanych tego dnia, które nie zostały usunięte i niedostarczone z powodu rozłączenia urządzenia (na koniec dnia America/Los_Angeles, kiedy wiadomość została wysłana do FCM). Część z tych wiadomości zostanie dostarczona następnego dnia, gdy urządzenie się połączy, ale część z nich może trafić do urządzeń, które w końcu nigdy się nie połączą.

collapsed

number

Odsetek zaakceptowanych wiadomości, które zostały zwinięte przez inną wiadomość.

droppedTooManyPendingMessages

number

Odsetek zaakceptowanych wiadomości, które zostały pominięte z powodu zbyt wielu niedostarczonych wiadomości, których nie można zwinąć. W szczególności każda instancja aplikacji może mieć na naszych serwerach tylko 100 oczekujących wiadomości dla odłączonego urządzenia. Gdy urządzenie połączy się ponownie, te wiadomości zostaną dostarczone. Gdy jest ich więcej, zamiast dostarczać wiadomości, wywołujemy w pakiecie SDK funkcję OnRemoveMessages().

droppedAppForceStopped

number

Odsetek zaakceptowanych wiadomości, które zostały pominięte z powodu wymuszenia zatrzymania aplikacji w momencie dostarczania i ponownych prób.

droppedDeviceInactive

number

Odsetek zaakceptowanych wiadomości, które zostały pominięte, ponieważ urządzenie docelowe jest nieaktywne. FCM usunie wiadomości, jeśli nasze serwery uznają urządzenie docelowe za nieaktywne. Gdy urządzenie ponownie połączy się z siecią, zamiast dostarczać wiadomości wywołujemy w naszym pakiecie SDK funkcję OnRemoveMessages().

droppedTtlExpired

number

Odsetek zaakceptowanych wiadomości, które wygasły, ponieważ przed ponownym połączeniem urządzenia docelowego upłynęło Czas życia danych (TTL).

Procenty skuteczności wyświetlania

Przegląd skuteczności dostarczania wiadomości, które zostały dostarczone. Wszystkie wartości procentowe są obliczane jako mianownik countMessagesAccepted. Te kategorie nie wzajemnie się wykluczają. Wiadomość może opóźnić się z wielu powodów.

Zapis JSON
{
  "deliveredNoDelay": number,
  "delayedDeviceOffline": number,
  "delayedDeviceDoze": number,
  "delayedMessageThrottled": number,
  "delayedUserStopped": number
}
Pola
deliveredNoDelay

number

Odsetek zaakceptowanych wiadomości, które zostały dostarczone na urządzenie bez opóźnienia przez system FCM.

delayedDeviceOffline

number

Odsetek zaakceptowanych wiadomości, które zostały opóźnione, ponieważ w momencie wysyłania urządzenie docelowe nie było połączone. Te wiadomości zostały w końcu dostarczone, gdy urządzenie ponownie połączyło się z siecią.

delayedDeviceDoze

number

Odsetek zaakceptowanych wiadomości, które zostały opóźnione, ponieważ urządzenie było w trybie uśpienia. Z powodu trybu uśpienia opóźnienia mogą wystąpić tylko w przypadku wiadomości o normalnym priorytecie.

delayedMessageThrottled

number

Odsetek zaakceptowanych wiadomości, które zostały opóźnione z powodu ograniczania liczby wiadomości, takich jak ograniczenie możliwości zwijania wiadomości lub maksymalne ograniczenie liczby wiadomości.

delayedUserStopped

number

Odsetek zaakceptowanych wiadomości, które zostały opóźnione z powodu zatrzymania odpowiedniego profilu użytkownika urządzenia na urządzeniu docelowym w momencie wysyłania. Wiadomości zostały w końcu dostarczone po ponownym uruchomieniu profilu użytkownika.

Procent statystyk wiadomości

Dodatkowe informacje o dostarczaniu wiadomości. Wszystkie wartości procentowe są obliczane jako mianownik countMessagesAccepted.

Zapis JSON
{
  "priorityLowered": number
}
Pola
priorityLowered

number

Odsetek zaakceptowanych wiadomości, których priorytet został zmniejszony z wysokiego do normalnego. Więcej informacji o ustawianiu priorytetu wiadomości znajdziesz w dokumentacji.

ProxyPowiadomienieInsightPercents

Dodatkowe informacje o dostarczaniu powiadomień przez serwer proxy. Wszystkie wartości procentowe są obliczane jako mianownik countNotificationsAccepted.

Zapis JSON
{
  "proxied": number,
  "failed": number,
  "skippedUnsupported": number,
  "skippedNotThrottled": number,
  "skippedUnconfigured": number,
  "skippedOptedOut": number
}
Pola
proxied

number

Odsetek zaakceptowanych powiadomień, które zostały przesłane przez Usługi Google Play przez serwer proxy.

failed

number

Odsetek zaakceptowanych powiadomień, których nie udało się przesłać przez serwer proxy. Jest to zwykle spowodowane wyjątkami, które wystąpiły podczas wywoływania notifyAsPackage.

skippedUnsupported

number

Odsetek zaakceptowanych powiadomień, które zostały pominięte, ponieważ odbiorca nie obsługuje powiadomień serwera proxy.

skippedNotThrottled

number

Odsetek zaakceptowanych powiadomień, które zostały pominięte, ponieważ wiadomości nie były ograniczane.

skippedUnconfigured

number

Odsetek zaakceptowanych powiadomień, które zostały pominięte z powodu braku konfiguracji wymaganych do przesyłania powiadomień przez serwer proxy.

skippedOptedOut

number

Odsetek zaakceptowanych powiadomień, które zostały pominięte, ponieważ aplikacja nie zezwalała na przesyłanie tych wiadomości przez serwer proxy.