- Solicitação HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Solicitar corpo
- Corpo de resposta
- Escopos de autorização
- AndroidDeliveryData
- Data
- Dados
- MessageOutcomePercents
- Percentagens de desempenho de entrega
- Percentagens do MessageInsight
- Tente!
Liste os dados de entrega agregados para o aplicativo Android específico.
Solicitação HTTP
GET https://fcmdata.googleapis.com/v1beta1/{parent=projects/*/androidApps/*}/deliveryData
A URL usa sintaxe de transcodificação gRPC .
Parâmetros de caminho
Parâmetros | |
---|---|
parent | Obrigatório. O aplicativo para o qual listar os dados de entrega. Formato: |
Parâmetros de consulta
Parâmetros | |
---|---|
pageSize | O número máximo de entradas a serem retornadas. O serviço pode retornar menos que esse valor. Se não for especificado, serão retornadas no máximo 1.000 entradas. O valor máximo é 10.000; valores acima de 10.000 serão limitados a 10.000. Este padrão pode mudar com o tempo. |
pageToken | Um token de página, recebido de uma chamada |
Solicitar corpo
O corpo da solicitação deve estar vazio.
Corpo de resposta
Se for bem-sucedido, o corpo da resposta conterá dados com a seguinte estrutura:
Mensagem de resposta para deliveryData.list.
Representação JSON |
---|
{
"androidDeliveryData": [
{
object ( |
Campos | |
---|---|
androidDeliveryData[] | Os dados de entrega do aplicativo fornecido. Haverá uma entrada por combinação de aplicativo, data e rótulo de análise. |
nextPageToken | Um token, que pode ser enviado como |
Escopos de autorização
Requer o seguinte escopo OAuth:
-
https://www.googleapis.com/auth/cloud-platform
AndroidDeliveryData
Dados de entrega de mensagens para uma determinada combinação de data, aplicativo e rótulo de análise.
Representação JSON |
---|
{ "appId": string, "date": { object ( |
Campos | |
---|---|
appId | O ID do aplicativo para o qual as mensagens foram enviadas. |
date | A data representada por esta entrada. |
analyticsLabel | O rótulo de análise associado às mensagens enviadas. Todas as mensagens enviadas sem rótulo analítico serão agrupadas em uma única entrada. |
data | Os dados para |
Data
Representa uma data de calendário total ou parcial, como um aniversário. A hora do dia e o fuso horário são especificados em outro lugar ou são insignificantes. A data é relativa ao calendário gregoriano. Isso pode representar um dos seguintes:
- Uma data completa, com valores de ano, mês e dia diferentes de zero.
- Um mês e um dia, com ano zero (por exemplo, um aniversário).
- Um ano sozinho, com mês zero e dia zero.
- Um ano e um mês, com dia zero (por exemplo, data de validade do cartão de crédito).
Tipos relacionados:
-
google.type.TimeOfDay
-
google.type.DateTime
-
google.protobuf.Timestamp
Representação JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Campos | |
---|---|
year | Ano da data. Deve ser de 1 a 9999 ou 0 para especificar uma data sem ano. |
month | Mês de um ano. Deve ser de 1 a 12 ou 0 para especificar um ano sem mês e dia. |
day | Dia de um mês. Deve ser de 1 a 31 e válido para o ano e mês, ou 0 para especificar um ano sozinho ou um ano e mês onde o dia não é significativo. |
Dados
Dados detalhando a entrega de mensagens
Representação JSON |
---|
{ "countMessagesAccepted": string, "messageOutcomePercents": { object ( |
Campos | |
---|---|
countMessagesAccepted | Contagem de mensagens aceitas pelo FCM destinadas a dispositivos Android. O dispositivo de destino deve ter optado pela coleta de informações de uso e diagnóstico. |
messageOutcomePercents | Análise mutuamente exclusiva dos resultados da entrega de mensagens. |
deliveryPerformancePercents | Informações adicionais sobre o desempenho de entrega de mensagens que foram entregues com êxito. |
messageInsightPercents | Informações gerais adicionais sobre entrega de mensagens. |
MessageOutcomePercents
Detalhamento percentual dos resultados de entrega de mensagens. Essas categorias são mutuamente exclusivas. Todas as porcentagens são calculadas com countMessagesAccepted
como denominador. Estas categorias podem não contabilizar todos os resultados da mensagem.
Representação JSON |
---|
{ "delivered": number, "pending": number, "droppedTooManyPendingMessages": number, "droppedAppForceStopped": number, "droppedDeviceInactive": number } |
Campos | |
---|---|
delivered | A porcentagem de todas as mensagens aceitas que foram entregues com êxito ao dispositivo. |
pending | A porcentagem de mensagens aceitas neste dia que não foram descartadas e não entregues devido à desconexão do dispositivo (a partir do final do dia América/Los_Angeles em que a mensagem foi enviada ao FCM). Uma parte dessas mensagens será entregue no dia seguinte, quando o dispositivo se conectar, mas outras poderão ser destinadas a dispositivos que nunca se reconectarão. |
droppedTooManyPendingMessages | A porcentagem de mensagens aceitas que foram descartadas devido a muitas mensagens não recolhíveis não entregues . Especificamente, cada instância de aplicativo só pode ter 100 mensagens pendentes armazenadas em nossos servidores para um dispositivo desconectado. Quando esse dispositivo se reconectar, essas mensagens serão entregues. Quando há mais mensagens pendentes do que o máximo, chamamos OnDeletedMessages() em nosso SDK em vez de entregar as mensagens. |
droppedAppForceStopped | A porcentagem de mensagens aceitas que foram descartadas porque o aplicativo foi interrompido à força no dispositivo no momento da entrega e as novas tentativas não tiveram êxito. |
droppedDeviceInactive | A porcentagem de mensagens aceitas que foram descartadas porque o dispositivo de destino está inativo. O FCM descartará mensagens se o dispositivo alvo for considerado inativo por nossos servidores. Se um dispositivo se reconectar, chamamos OnDeletedMessages() em nosso SDK em vez de entregar as mensagens. |
Percentagens de desempenho de entrega
Visão geral do desempenho de entrega de mensagens que foram entregues com êxito. Todas as porcentagens são calculadas com countMessagesAccepted
como denominador. Estas categorias não são mutuamente exclusivas; uma mensagem pode ser atrasada por vários motivos.
Representação JSON |
---|
{ "deliveredNoDelay": number, "delayedDeviceOffline": number, "delayedDeviceDoze": number, "delayedMessageThrottled": number, "delayedUserStopped": number } |
Campos | |
---|---|
deliveredNoDelay | A porcentagem de mensagens aceitas que foram entregues ao dispositivo sem demora pelo sistema FCM. |
delayedDeviceOffline | A porcentagem de mensagens aceitas que foram atrasadas porque o dispositivo de destino não estava conectado no momento do envio. Essas mensagens foram finalmente entregues quando o dispositivo foi reconectado. |
delayedDeviceDoze | A porcentagem de mensagens aceitas que foram atrasadas porque o dispositivo estava no modo soneca. Apenas mensagens de prioridade normal devem ser atrasadas devido ao modo soneca. |
delayedMessageThrottled | A porcentagem de mensagens aceitas que foram atrasadas devido à limitação de mensagens, como limitação de mensagens recolhíveis ou limitação de taxa máxima de mensagens . |
delayedUserStopped | A porcentagem de mensagens aceitas que foram atrasadas porque o perfil de usuário do dispositivo pretendido foi interrompido no dispositivo de destino no momento do envio. As mensagens foram finalmente entregues quando o perfil do usuário foi reiniciado. |
Percentagens do MessageInsight
Informações adicionais sobre entrega de mensagens. Todas as porcentagens são calculadas com countMessagesAccepted
como denominador.
Representação JSON |
---|
{ "priorityLowered": number } |
Campos | |
---|---|
priorityLowered | A porcentagem de mensagens aceitas que tiveram sua prioridade reduzida de alta para normal. Consulte a documentação para definir a prioridade da mensagem . |