- HTTP 요청
- 경로 매개변수
- 쿼리 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- AndroidDeliveryData
- 날짜
- 데이터
- 메시지결과퍼센트
- 배달 실적백분율
- 메시지통찰퍼센트
- 시도 해봐!
특정 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년의 달. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다. |
day | 한 달의 일. 1부터 31까지이고 연도와 월에 유효해야 합니다. 연도 자체를 지정하거나 일자가 중요하지 않은 연도와 월을 지정하려면 0이어야 합니다. |
데이터
메시징 전달을 자세히 설명하는 데이터
JSON 표현 |
---|
{ "countMessagesAccepted": string, "messageOutcomePercents": { object ( |
필드 | |
---|---|
countMessagesAccepted | Android 기기를 대상으로 FCM에서 허용한 메시지 수입니다. 대상 장치는 사용 및 진단 정보 수집을 선택해야 합니다. |
messageOutcomePercents | 메시지 전달 결과를 상호 배타적으로 분석합니다. |
deliveryPerformancePercents | 성공적으로 전달된 메시지의 전달 성능에 대한 추가 정보입니다. |
messageInsightPercents | 메시지 전달에 대한 추가 일반 정보입니다. |
메시지결과퍼센트
메시지 전달 결과의 백분율 분석입니다. 이러한 범주는 상호 배타적입니다. 모든 백분율은 countMessagesAccepted
분모로 사용하여 계산됩니다. 이러한 범주는 모든 메시지 결과를 설명하지 못할 수도 있습니다.
JSON 표현 |
---|
{ "delivered": number, "pending": number, "droppedTooManyPendingMessages": number, "droppedAppForceStopped": number, "droppedDeviceInactive": number } |
필드 | |
---|---|
delivered | 장치에 성공적으로 전달된 수락된 모든 메시지의 비율입니다. |
pending | 해당 날짜에 수락된 메시지 중 기기 연결이 끊어져 삭제되지 않고 전달되지 않은 메시지의 비율입니다(메시지가 FCM으로 전송된 America/Los_Angeles 날짜 종료 기준). 이러한 메시지 중 일부는 다음 날 장치가 연결될 때 전달되지만 다른 메시지는 궁극적으로 다시 연결되지 않는 장치로 전송될 수 있습니다. |
droppedTooManyPendingMessages | 전달되지 않은 축소할 수 없는 메시지가 너무 많아 삭제된 수락된 메시지의 비율입니다. 특히, 각 앱 인스턴스에는 연결이 끊긴 기기에 대해 서버에 저장된 보류 메시지가 100개만 있을 수 있습니다. 해당 장치가 다시 연결되면 해당 메시지가 전달됩니다. 보류 중인 메시지가 최대 개수보다 많은 경우 메시지를 전달하는 대신 SDK에서 OnDeletedMessages()를 호출합니다. |
droppedAppForceStopped | 전달 시 애플리케이션이 장치에서 강제 중지되어 재시도가 실패하여 삭제된 허용된 메시지의 비율입니다. |
droppedDeviceInactive | 대상 장치가 비활성 상태이기 때문에 삭제된 허용된 메시지의 비율입니다. FCM은 대상 장치가 서버에서 비활성화된 것으로 간주되면 메시지를 삭제합니다. 장치가 다시 연결되면 메시지를 전달하는 대신 SDK에서 OnDeletedMessages()를 호출합니다. |
배달 실적백분율
성공적으로 전달된 메시지의 전달 성능 개요입니다. 모든 백분율은 countMessagesAccepted
분모로 사용하여 계산됩니다. 이러한 범주는 상호 배타적이지 않습니다. 여러 가지 이유로 메시지가 지연될 수 있습니다.
JSON 표현 |
---|
{ "deliveredNoDelay": number, "delayedDeviceOffline": number, "delayedDeviceDoze": number, "delayedMessageThrottled": number, "delayedUserStopped": number } |
필드 | |
---|---|
deliveredNoDelay | FCM 시스템에서 지연 없이 장치로 전달된 허용된 메시지의 비율입니다. |
delayedDeviceOffline | 전송 시 대상 장치가 연결되지 않았기 때문에 지연된 수락된 메시지의 비율입니다. 이 메시지는 결국 장치가 다시 연결되었을 때 전달되었습니다. |
delayedDeviceDoze | 기기가 잠자기 모드에 있었기 때문에 지연된 수락된 메시지의 비율입니다. 잠자기 모드로 인해 일반 우선순위 메시지 만 지연되어야 합니다. |
delayedMessageThrottled | 축소형 메시지 조절 또는 최대 메시지 속도 조절 과 같은 메시지 조절로 인해 지연된 허용된 메시지의 비율입니다. |
delayedUserStopped | 전송 시 대상 장치에서 의도한 장치 사용자 프로필이 중지 되었기 때문에 지연된 수락된 메시지의 비율입니다. 사용자 프로필이 다시 시작되었을 때 결국 메시지가 전달되었습니다. |
메시지통찰퍼센트
메시지 전달에 대한 추가 정보입니다. 모든 백분율은 countMessagesAccepted
분모로 사용하여 계산됩니다.
JSON 표현 |
---|
{ "priorityLowered": number } |
필드 | |
---|---|
priorityLowered | 우선순위가 높음에서 보통으로 낮아진 수락된 메시지의 비율입니다. 메시지 우선순위 설정에 대한 설명서를 참조하세요. |