Method: projects.androidApps.deliveryData.list

Elenca i dati di consegna aggregati per l'applicazione Android specificata.

Richiesta HTTP

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

L'URL usa la sintassi di transcodifica gRPC .

Parametri del percorso

Parametri
parent

string

Necessario. L'applicazione per la quale elencare i dati di consegna. Formato: projects/{project_id}/androidApps/{appId}

Parametri di query

Parametri
pageSize

integer

Il numero massimo di voci da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore. Se non specificato, verranno restituite al massimo 1.000 voci. Il valore massimo è 10.000; i valori superiori a 10.000 verranno limitati a 10.000. Questa impostazione predefinita potrebbe cambiare nel tempo.

pageToken

string

Un token di pagina, ricevuto da una precedente chiamata ListAndroidDeliveryDataRequest . Fornirlo per recuperare la pagina successiva. Durante l'impaginazione, tutti gli altri parametri forniti a ListAndroidDeliveryDataRequest devono corrispondere alla chiamata che ha fornito il token della pagina.

Richiedi corpo

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Messaggio di risposta per deliveryData.list.

Rappresentazione JSON
{
  "androidDeliveryData": [
    {
      object (AndroidDeliveryData)
    }
  ],
  "nextPageToken": string
}
Campi
androidDeliveryData[]

object ( AndroidDeliveryData )

I dati di consegna per l'app fornita. Sarà presente una voce per combinazione di app, data ed etichetta di analisi.

nextPageToken

string

Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non ci sono pagine successive.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Dati di consegna Android

Dati di consegna dei messaggi per una determinata combinazione di data, app ed etichetta di analisi.

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

string

L'ID dell'app a cui sono stati inviati i messaggi.

date

object ( Date )

La data rappresentata da questa voce.

analyticsLabel

string

L'etichetta di analisi associata ai messaggi inviati. Tutti i messaggi inviati senza etichetta analitica verranno raggruppati in un'unica voce.

data

object ( Data )

I dati per appId , date e analyticsLabel specificati.

Data

Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Questo può rappresentare uno dei seguenti:

  • Una data completa, con valori di anno, mese e giorno diversi da zero.
  • Un mese e un giorno, con un anno pari a zero (ad esempio, un anniversario).
  • Un anno a parte, con un mese zero e un giorno zero.
  • Un anno e un mese, con un giorno zero (ad esempio, la data di scadenza di una carta di credito).

Tipi correlati:

Rappresentazione JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.

month

integer

Mese di un anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.

day

integer

Giorno di un mese. Deve essere compreso tra 1 e 31 ed essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.

Dati

Dati che dettagliano la consegna dei messaggi

Rappresentazione JSON
{
  "countMessagesAccepted": string,
  "messageOutcomePercents": {
    object (MessageOutcomePercents)
  },
  "deliveryPerformancePercents": {
    object (DeliveryPerformancePercents)
  },
  "messageInsightPercents": {
    object (MessageInsightPercents)
  }
}
Campi
countMessagesAccepted

string ( int64 format)

Conteggio dei messaggi accettati da FCM destinati ai dispositivi Android. Il dispositivo di destinazione deve aver acconsentito esplicitamente alla raccolta di informazioni sull'utilizzo e sulla diagnostica.

messageOutcomePercents

object ( MessageOutcomePercents )

Suddivisione reciprocamente esclusiva dei risultati di recapito dei messaggi.

deliveryPerformancePercents

object ( DeliveryPerformancePercents )

Ulteriori informazioni sulle prestazioni di recapito per i messaggi recapitati correttamente.

messageInsightPercents

object ( MessageInsightPercents )

Ulteriori approfondimenti generali sulla consegna dei messaggi.

Percentuale risultato messaggio

Ripartizione percentuale dei risultati di recapito dei messaggi. Queste categorie si escludono a vicenda. Tutte le percentuali vengono calcolate con countMessagesAccepted come denominatore. Queste categorie potrebbero non rappresentare tutti i risultati dei messaggi.

Rappresentazione JSON
{
  "delivered": number,
  "pending": number,
  "droppedTooManyPendingMessages": number,
  "droppedAppForceStopped": number,
  "droppedDeviceInactive": number
}
Campi
delivered

number

La percentuale di tutti i messaggi accettati recapitati correttamente al dispositivo.

pending

number

La percentuale di messaggi accettati in questo giorno che non sono stati ignorati e non consegnati a causa della disconnessione del dispositivo (a partire dalla fine del giorno America/Los_Angeles in cui il messaggio è stato inviato a FCM). Una parte di questi messaggi verrà recapitata il giorno successivo quando il dispositivo si connetterà, ma altri potrebbero essere destinati a dispositivi che alla fine non si riconnetteranno mai.

droppedTooManyPendingMessages

number

La percentuale di messaggi accettati che sono stati eliminati a causa di troppi messaggi non comprimibili non consegnati . Nello specifico, ogni istanza dell'app può avere solo 100 messaggi in sospeso archiviati sui nostri server per un dispositivo disconnesso. Quando il dispositivo si riconnette, tali messaggi vengono recapitati. Quando i messaggi in sospeso superano il numero massimo consentito, chiamiamo OnDeletedMessages() nel nostro SDK invece di consegnare i messaggi.

droppedAppForceStopped

number

La percentuale di messaggi accettati che sono stati eliminati perché l'applicazione è stata interrotta forzatamente sul dispositivo al momento del recapito e i tentativi non sono riusciti.

droppedDeviceInactive

number

La percentuale di messaggi accettati che sono stati eliminati perché il dispositivo di destinazione è inattivo. FCM eliminerà i messaggi se il dispositivo di destinazione viene ritenuto inattivo dai nostri server. Se un dispositivo si riconnette, chiamiamo OnDeletedMessages() nel nostro SDK invece di consegnare i messaggi.

DeliveryPerformancePercents

Panoramica delle prestazioni di recapito per i messaggi recapitati correttamente. Tutte le percentuali vengono calcolate con countMessagesAccepted come denominatore. Queste categorie non si escludono a vicenda; un messaggio può essere ritardato per molteplici motivi.

Rappresentazione JSON
{
  "deliveredNoDelay": number,
  "delayedDeviceOffline": number,
  "delayedDeviceDoze": number,
  "delayedMessageThrottled": number,
  "delayedUserStopped": number
}
Campi
deliveredNoDelay

number

La percentuale di messaggi accettati recapitati al dispositivo senza ritardo dal sistema FCM.

delayedDeviceOffline

number

La percentuale di messaggi accettati che sono stati ritardati perché il dispositivo di destinazione non era connesso al momento dell'invio. Questi messaggi sono stati infine recapitati quando il dispositivo si è ricollegato.

delayedDeviceDoze

number

La percentuale di messaggi accettati che sono stati ritardati perché il dispositivo era in modalità sospensione. Solo i messaggi con priorità normale dovrebbero essere ritardati a causa della modalità doze.

delayedMessageThrottled

number

La percentuale di messaggi accettati che hanno subito un ritardo a causa della limitazione dei messaggi, ad esempio la limitazione dei messaggi comprimibili o la limitazione della velocità massima dei messaggi .

delayedUserStopped

number

La percentuale di messaggi accettati che sono stati ritardati perché il profilo utente del dispositivo previsto è stato interrotto sul dispositivo di destinazione al momento dell'invio. I messaggi sono stati infine recapitati quando il profilo utente è stato riavviato.

MessageInsightPercents

Ulteriori informazioni sulla consegna dei messaggi. Tutte le percentuali vengono calcolate con countMessagesAccepted come denominatore.

Rappresentazione JSON
{
  "priorityLowered": number
}
Campi
priorityLowered

number

La percentuale di messaggi accettati la cui priorità è stata ridotta da alta a normale. Consulta la documentazione per impostare la priorità dei messaggi .