- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- AndroidDeliveryData (w języku angielskim)
- Data
- Dane
- MessageResultPercents
- Procent wydajności wyświetlania
- MessageInsightPercents
- ProxynotificationInsightPercents
- Wypróbuj
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 |
Wymagane. Aplikacja, dla której ma zostać wyświetlona lista danych dostawy. Format: |
Parametry zapytania
Parametry | |
---|---|
pageSize |
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 zostaną ograniczone do 10 000. To ustawienie domyślne może się z czasem zmienić. |
pageToken |
Token strony otrzymany z poprzedniego wywołania funkcji |
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 ( |
Pola | |
---|---|
androidDeliveryData[] |
Dane dostawy dla udostępnionej aplikacji. W przypadku każdej kombinacji aplikacji, daty i etykiety Analytics będzie 1 wpis. |
nextPageToken |
Token, który może zostać wysłany jako |
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 ( |
Pola | |
---|---|
appId |
Identyfikator aplikacji, do której zostały wysłane wiadomości. |
date |
Data reprezentowana przez ten wpis. |
analyticsLabel |
Etykieta analityczna powiązana z wysłanymi wiadomościami. Wszystkie wiadomości wysłane bez etykiety Analytics zostaną zgrupowane w jednym wpisie. |
data |
Dane w funkcjach: |
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:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Zapis JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Pola | |
---|---|
year |
Rok daty. Wartość musi mieścić się w zakresie od 1 do 9999 lub od 0 do określenia daty bez roku. |
month |
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 |
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 ( |
Pola | |
---|---|
countMessagesAccepted |
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 |
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 |
Wzajemnie wykluczające się wyniki dostarczania wiadomości. |
deliveryPerformancePercents |
Dodatkowe informacje o wydajności dostarczania wiadomości, które zostały dostarczone. |
messageInsightPercents |
Dodatkowe ogólne statystyki na temat dostarczania wiadomości. |
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 |
Odsetek wszystkich zaakceptowanych wiadomości, które zostały dostarczone na urządzenie. |
pending |
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 |
Odsetek zaakceptowanych wiadomości, które zostały zwinięte przez inną wiadomość. |
droppedTooManyPendingMessages |
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 metodę OnRemoveMessages(). |
droppedAppForceStopped |
Odsetek zaakceptowanych wiadomości, które zostały pominięte z powodu wymuszenia zatrzymania aplikacji w momencie dostarczania i ponownych prób. |
droppedDeviceInactive |
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 |
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
. Kategorie te nie wzajemnie się wykluczają. wysłanie wiadomości może opóźnić się z wielu powodów.
Zapis JSON |
---|
{ "deliveredNoDelay": number, "delayedDeviceOffline": number, "delayedDeviceDoze": number, "delayedMessageThrottled": number, "delayedUserStopped": number } |
Pola | |
---|---|
deliveredNoDelay |
Odsetek zaakceptowanych wiadomości, które zostały dostarczone na urządzenie bez opóźnienia przez system FCM. |
delayedDeviceOffline |
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 |
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 |
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 |
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 |
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 na temat dostarczania powiadomień o serwerze 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 |
Odsetek zaakceptowanych powiadomień, które zostały przesłane przez Usługi Google Play przez serwer proxy. |
failed |
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 |
Odsetek zaakceptowanych powiadomień, które zostały pominięte, ponieważ odbiorca nie obsługuje powiadomień serwera proxy. |
skippedNotThrottled |
Odsetek zaakceptowanych powiadomień, które zostały pominięte, ponieważ wiadomości nie były ograniczane. |
skippedUnconfigured |
Odsetek zaakceptowanych powiadomień, które zostały pominięte z powodu braku konfiguracji wymaganych do przesyłania powiadomień przez serwer proxy. |
skippedOptedOut |
Odsetek zaakceptowanych powiadomień, które zostały pominięte, ponieważ aplikacja nie zezwalała na przesyłanie tych wiadomości przez serwer proxy. |