- HTTP 요청
- 경로 매개변수
- 쿼리 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- AndroidDeliveryData
- 날짜
- 데이터
- MessageOutcomePercents
- DeliveryPerformancePercents
- MessageInsightPercents
- ProxyNotificationInsightPercents
- 사용해 보기
지정된 Android 애플리케이션의 집계 전송 데이터를 나열합니다.
HTTP 요청
GET https://fcmdata.googleapis.com/v1beta1/{parent=projects/*/androidApps/*}/deliveryData
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
parent |
필수 항목입니다. 전송 데이터를 나열할 애플리케이션입니다. 형식: |
쿼리 매개변수
매개변수 | |
---|---|
pageSize |
반환할 최대 항목 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 1,000개의 항목이 반환됩니다. 최댓값은 10,000이며, 10,000을 초과하는 값은 10,000으로 제한됩니다. 이 기본값은 시간이 지남에 따라 변경될 수 있습니다. |
pageToken |
이전 |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
DeliveryData.list의 응답 메시지입니다.
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
JSON 표현 |
---|
{
"androidDeliveryData": [
{
object ( |
필드 | |
---|---|
androidDeliveryData[] |
제공된 앱의 전송 데이터입니다. 앱, 날짜, 분석 라벨의 조합당 하나의 항목이 있습니다. |
nextPageToken |
다음 페이지를 검색하기 위해 |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/cloud-platform
AndroidDeliveryData
지정된 날짜, 앱, 분석 라벨 조합의 메시지 전송 데이터
JSON 표현 |
---|
{ "appId": string, "date": { object ( |
필드 | |
---|---|
appId |
메시지가 전송된 앱 ID입니다. |
date |
이 항목이 나타내는 날짜입니다. |
analyticsLabel |
전송된 메시지와 연결된 분석 라벨입니다. 분석 라벨 없이 보낸 모든 메일은 하나의 항목으로 그룹화됩니다. |
data |
지정된 |
날짜
생일과 같이 캘린더 날짜 전체 또는 일부를 나타냅니다. 하루 중 시간과 시간대가 다른 곳에서 지정되어 있거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.
- 연도, 월, 일 값이 0이 아닌 전체 날짜
- 0년을 사용한 월과 일 (예: 기념일)
- 0개월과 0일로 구성된 1년입니다.
- 연도와 월을 0일로 지정 (예: 신용카드 만료일)
관련 유형:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON 표현 |
---|
{ "year": integer, "month": integer, "day": integer } |
필드 | |
---|---|
year |
날짜의 연도입니다. 1에서 9999 사이의 값이어야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다. |
month |
월입니다. 1~12 사이의 값이어야 합니다. 월과 일 없이 연도를 지정하려면 0이어야 합니다. |
day |
일(일)입니다. 1~31 사이의 값이어야 하며 연도와 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않은 연도와 월을 지정하려면 0이어야 합니다. |
데이터
메시지 전송을 자세히 설명하는 데이터
JSON 표현 |
---|
{ "countMessagesAccepted": string, "countNotificationsAccepted": string, "messageOutcomePercents": { object ( |
필드 | |
---|---|
countMessagesAccepted |
Android 기기용 FCM에서 수락한 메시지 수입니다. 대상 기기가 사용 및 진단 정보를 수집하도록 선택해야 합니다. |
countNotificationsAccepted |
Android 기기용 FCM에서 수락한 알림 수입니다. 대상 기기가 사용 및 진단 정보를 수집하도록 선택해야 합니다. |
messageOutcomePercents |
메시지 전송 결과를 상호 배타적으로 분류합니다. |
deliveryPerformancePercents |
성공적으로 전송된 메일의 전송 성능에 대한 추가 정보입니다. |
messageInsightPercents |
메시지 전송에 대한 추가적인 일반 통계입니다. |
proxyNotificationInsightPercents |
프록시 알림 전송에 대한 추가 통계입니다. |
메시지 결과 비율
메시지 전송 결과의 백분율 분류입니다. 이러한 카테고리는 상호 배타적입니다. 모든 비율은 countMessagesAccepted
를 분모로 하여 계산됩니다. 이러한 카테고리에 모든 메시지 결과가 반영되지 않을 수 있습니다.
JSON 표현 |
---|
{ "delivered": number, "pending": number, "droppedTooManyPendingMessages": number, "droppedAppForceStopped": number, "droppedDeviceInactive": number } |
필드 | |
---|---|
delivered |
기기로 성공적으로 전송된 모든 수락 메시지의 비율입니다. |
pending |
이 날짜에 수락된 메시지 중 기기 연결 해제로 인해 삭제되지 않고 전송되지 않은 메시지의 비율입니다. 메시지가 FCM으로 전송된 미주/로스앤젤레스 일 종료 기준입니다. 이러한 메시지 중 일부는 기기가 연결되면 다음 날 전송되지만 다른 메시지는 최종적으로 다시 연결되지 않는 기기로 전송될 수 있습니다. |
droppedTooManyPendingMessages |
전송되지 않은 비축소형 메시지가 너무 많아 삭제된 수락된 메시지의 비율입니다. 구체적으로는 연결이 끊긴 기기의 경우 각 앱 인스턴스에 대기 중인 메시지가 100개만 Google 서버에 저장될 수 있습니다. 기기가 다시 연결되면 메시지가 전송됩니다. 대기 중인 메시지가 최대 개수보다 많으면 메시지를 전송하는 대신 SDK에서 OndeletedMessages()를 호출합니다. |
droppedAppForceStopped |
전송 시 기기에서 애플리케이션이 강제 종료되어 재시도에 실패하여 수락된 메시지의 비율입니다. |
droppedDeviceInactive |
대상 기기가 비활성화되어 삭제된 메일의 비율입니다. Google 서버에서 타겟 기기를 비활성 상태로 간주하면 FCM에서 메시지를 삭제합니다. 기기가 다시 연결되는 경우 메시지를 전송하는 대신 SDK에서 OndeleteMessages()를 호출합니다. |
게재 성능 비율
성공적으로 전송된 메일의 전송 성능 개요입니다. 모든 비율은 countMessagesAccepted
를 분모로 하여 계산됩니다. 이러한 카테고리는 상호 배타적이지 않으며 여러 가지 이유로 메일이 지연될 수 있습니다.
JSON 표현 |
---|
{ "deliveredNoDelay": number, "delayedDeviceOffline": number, "delayedDeviceDoze": number, "delayedMessageThrottled": number, "delayedUserStopped": number } |
필드 | |
---|---|
deliveredNoDelay |
FCM 시스템에서 지연 없이 기기로 전송된 수락 메시지의 비율입니다. |
delayedDeviceOffline |
전송 시 대상 기기가 연결되어 있지 않아 지연된 수락된 메일의 비율입니다. 이 메시지는 기기가 다시 연결될 때 전송되었습니다. |
delayedDeviceDoze |
기기가 잠자기 모드여서 지연된 수락 메일의 비율입니다. 잠자기 모드로 인해 보통 우선순위 메시지만 지연됩니다. |
delayedMessageThrottled |
접을 수 있는 메시지 제한 또는 최대 메시지 속도 제한과 같은 메시지 제한으로 인해 지연된 수락된 메시지의 비율입니다. |
delayedUserStopped |
전송 시 의도된 기기 사용자 프로필이 대상 기기에서 중지되어 지연된 수락된 메일의 비율입니다. 최종적으로 사용자 프로필이 다시 시작되었을 때 메시지가 전송되었습니다. |
MessageInsightPercents
메시지 전송에 대한 추가 정보입니다. 모든 비율은 countMessagesAccepted
를 분모로 하여 계산됩니다.
JSON 표현 |
---|
{ "priorityLowered": number } |
필드 | |
---|---|
priorityLowered |
우선순위가 높음에서 보통으로 낮아진 수락된 메시지의 비율입니다. 메시지 우선순위 설정 문서를 참조하세요. |
ProxyNotificationInsightPercents
프록시 알림 전송에 대한 추가 정보입니다. 모든 비율은 countNotificationsAccepted
를 분모로 하여 계산됩니다.
JSON 표현 |
---|
{ "proxied": number, "failed": number, "skippedUnsupported": number, "skippedNotThrottled": number, "skippedUnconfigured": number, "skippedOptedOut": number } |
필드 | |
---|---|
proxied |
수락된 알림 중 Google Play 서비스에 의해 성공적으로 프록시된 알림의 비율입니다. |
failed |
수락된 알림 중 프록시 처리하지 못한 알림의 비율입니다. 이 문제는 일반적으로 notifyAsPackage를 호출하는 동안 발생한 예외로 인해 발생합니다. |
skippedUnsupported |
수신자에게 프록시 알림이 지원되지 않아 건너뛴 수락된 알림의 비율입니다. |
skippedNotThrottled |
메시지가 제한되지 않아 건너뛴 수락된 알림의 비율입니다. |
skippedUnconfigured |
알림을 프록시하는 데 필요한 구성이 누락되어 수락된 알림 중 건너뛴 비율입니다. |
skippedOptedOut |
앱에서 이러한 메시지의 프록시를 허용하지 않아 건너뛴 알림의 비율입니다. |