Method: projects.androidApps.deliveryData.list

지정된 Android 애플리케이션의 전송 전송 데이터를 나열합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. 전송 데이터를 나열할 애플리케이션입니다. 형식: projects/{projectId}/androidApps/{appId}

쿼리 매개변수

매개변수
pageSize

integer

반환할 최대 항목 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 1,000개의 항목이 반환됩니다. 최댓값은 10,000입니다. 값이 10,000을 초과하면 10,000으로 제한됩니다. 이 기본값은 시간이 지남에 따라 변경될 수 있습니다.

pageToken

string

이전 ListAndroidDeliveryDataRequest 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나눌 때 ListAndroidDeliveryDataRequest에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

deliveryData.list의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "androidDeliveryData": [
    {
      object (AndroidDeliveryData)
    }
  ],
  "nextPageToken": string
}
필드
androidDeliveryData[]

object (AndroidDeliveryData)

제공된 앱의 전송 데이터입니다. 앱, 날짜, 분석 라벨의 조합당 하나의 항목이 표시됩니다.

nextPageToken

string

다음 페이지를 검색하기 위해 pageToken으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

Android 전송 데이터

지정된 날짜, 앱, 분석 라벨 조합의 메시지 전송 데이터입니다.

JSON 표현
{
  "appId": string,
  "date": {
    object (Date)
  },
  "analyticsLabel": string,
  "data": {
    object (Data)
  }
}
필드
appId

string

메시지가 전송된 앱 ID입니다.

date

object (Date)

이 항목이 나타내는 날짜입니다.

analyticsLabel

string

전송된 메시지와 연결된 애널리틱스 라벨입니다. 분석 라벨 없이 전송된 모든 메일은 하나의 항목으로 그룹화됩니다.

data

object (Data)

지정된 appId, date, analyticsLabel의 데이터입니다.

날짜

생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 이는 다음 중 하나를 나타낼 수 있습니다.

  • 연도, 월, 일 값이 0이 아닌 전체 날짜
  • 월과 일, 연도는 0(예: 기념일)
  • 연도만, 월과 일은 0
  • 연도와 월, 일은 0(예: 신용카드 만료일)

관련 유형:

JSON 표현
{
  "year": integer,
  "month": integer,
  "day": integer
}
필드
year

integer

날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.

month

integer

연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.

day

integer

월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.

데이터

메시지 전송을 자세히 설명하는 데이터

JSON 표현
{
  "countMessagesAccepted": string,
  "countNotificationsAccepted": string,
  "messageOutcomePercents": {
    object (MessageOutcomePercents)
  },
  "deliveryPerformancePercents": {
    object (DeliveryPerformancePercents)
  },
  "messageInsightPercents": {
    object (MessageInsightPercents)
  },
  "proxyNotificationInsightPercents": {
    object (ProxyNotificationInsightPercents)
  }
}
필드
countMessagesAccepted

string (int64 format)

Android 기기용 FCM에서 수락한 메시지 수입니다. 대상 기기가 사용 및 진단 정보 수집을 선택해야 합니다.

countNotificationsAccepted

string (int64 format)

Android 기기용 FCM에서 수락한 알림 수입니다. 대상 기기가 사용 및 진단 정보 수집을 선택해야 합니다.

messageOutcomePercents

object (MessageOutcomePercents)

상호 배타적인 메시지 전송 결과 분석

deliveryPerformancePercents

object (DeliveryPerformancePercents)

성공적으로 전송된 메시지의 전송 성능에 대한 추가 정보입니다.

messageInsightPercents

object (MessageInsightPercents)

메일 전송에 대한 추가적인 일반 통계입니다.

proxyNotificationInsightPercents

object (ProxyNotificationInsightPercents)

프록시 알림 전송에 대한 추가 통계입니다.

메시지결과Percent

메시지 전송 결과의 백분율 분석입니다. 이러한 카테고리는 상호 배타적입니다. 모든 비율은 countMessagesAccepted을 분모로 사용하여 계산됩니다. 이러한 카테고리에는 모든 메시지 결과가 고려되지 않을 수 있습니다.

JSON 표현
{
  "delivered": number,
  "pending": number,
  "collapsed": number,
  "droppedTooManyPendingMessages": number,
  "droppedAppForceStopped": number,
  "droppedDeviceInactive": number,
  "droppedTtlExpired": number
}
필드
delivered

number

기기로 전송된 모든 수락된 메시지의 비율입니다.

pending

number

이 날짜에 수락된 메시지 중 기기 연결 해제로 인해 삭제되거나 전송되지 않은 메시지의 비율입니다 (메시지가 FCM으로 전송된 America/Los_Angeles 날짜 기준). 이러한 메시지 중 일부는 다음 날 기기가 연결될 때 전송되지만, 다른 메시지는 다시 연결되지 않는 기기로 전달될 수도 있습니다.

collapsed

number

수락된 메시지 중 다른 메시지에 의해 접힌 메시지의 비율입니다.

droppedTooManyPendingMessages

number

전송되지 않은 비축소형 메시지가 너무 많아서 허용된 메시지 중 삭제된 메시지의 비율입니다. 구체적으로는 연결이 해제된 기기의 경우 각 앱 인스턴스의 Google 서버에 대기 중인 메시지를 100개만 저장할 수 있습니다. 기기가 다시 연결되면 메시지가 전송됩니다. 대기 중인 메시지가 최대 개수보다 많은 경우 메시지를 전달하는 대신 SDK에서 OnRemoveMessages()를 호출합니다.

droppedAppForceStopped

number

전송 시 애플리케이션이 기기에서 강제 종료되어 재시도에 실패했기 때문에 허용된 메시지 중 삭제된 메시지의 비율입니다.

droppedDeviceInactive

number

대상 기기가 비활성 상태이므로 수락된 메시지 중 삭제된 메시지의 비율입니다. 서버에서 대상 기기가 비활성으로 간주되면 FCM이 메시지를 삭제합니다. 기기가 다시 연결되면 메시지를 전달하는 대신 SDK에서 OnRemoveMessages()를 호출합니다.

droppedTtlExpired

number

대상 기기가 다시 연결되기 전에 TTL (수명)이 경과하여 허용된 메시지 중 만료된 메시지의 비율입니다.

전송 실적 비율

성공적으로 전송된 메시지의 전송 성능 개요입니다. 모든 비율은 countMessagesAccepted을 분모로 사용하여 계산됩니다. 이러한 카테고리는 상호 배타적이지 않습니다. 여러 가지 이유로 메일이 지연될 수 있습니다

JSON 표현
{
  "deliveredNoDelay": number,
  "delayedDeviceOffline": number,
  "delayedDeviceDoze": number,
  "delayedMessageThrottled": number,
  "delayedUserStopped": number
}
필드
deliveredNoDelay

number

FCM 시스템에서 지연 없이 기기로 전송된 수락된 메시지의 비율입니다.

delayedDeviceOffline

number

전송 시점에 대상 기기가 연결되어 있지 않아 지연된 수락된 메시지의 비율입니다. 이러한 메시지는 기기가 다시 연결되었을 때 전송되었습니다.

delayedDeviceDoze

number

기기가 잠자기 모드였기 때문에 지연된 수락된 메시지의 비율입니다. 보통 우선순위 메시지만 잠자기 모드로 인해 지연되어야 합니다.

delayedMessageThrottled

number

접을 수 있는 메시지 제한 또는 최대 메시지 속도 제한과 같은 메시지 제한으로 인해 지연된 수락된 메시지의 비율입니다.

delayedUserStopped

number

의도된 기기 사용자 프로필이 전송 시점에 대상 기기에서 중지되었기 때문에 지연된 수락된 메시지의 비율입니다. 결국 메시지는 사용자 프로필이 다시 시작되었을 때 전송되었습니다.

메시지 통계 비율

메일 전송에 대한 추가 정보입니다. 모든 비율은 countMessagesAccepted을 분모로 사용하여 계산됩니다.

JSON 표현
{
  "priorityLowered": number
}
필드
priorityLowered

number

우선순위가 높음에서 보통으로 낮아진 메시지 중 수락된 메시지의 비율입니다. 메시지 우선순위 설정 문서를 참고하세요.

ProxyNotificationInsightPercent

프록시 알림 전송에 대한 추가 정보 모든 비율은 countNotificationsAccepted을 분모로 사용하여 계산됩니다.

JSON 표현
{
  "proxied": number,
  "failed": number,
  "skippedUnsupported": number,
  "skippedNotThrottled": number,
  "skippedUnconfigured": number,
  "skippedOptedOut": number
}
필드
proxied

number

수락된 알림 중 Google Play 서비스에서 성공적으로 프록시 처리한 알림의 비율입니다.

failed

number

수락되고 프록시 처리되지 않은 알림의 비율입니다. 이 문제는 일반적으로 notifyAsPackage를 호출하는 동안 발생한 예외로 인해 발생합니다.

skippedUnsupported

number

수신자에게 프록시 알림이 지원되지 않아 건너뛴 수락된 알림 중 건너뛴 알림의 비율입니다.

skippedNotThrottled

number

메시지가 제한되지 않았기 때문에 수락된 알림 중 건너뛴 알림의 비율입니다.

skippedUnconfigured

number

알림을 프록시해야 하는 구성이 누락되어 건너뛴 허용된 알림의 비율입니다.

skippedOptedOut

number

앱에서 메시지의 프록시를 허용하지 않아 건너뛴 알림 중 허용된 알림의 비율입니다.