Method: projects.androidApps.deliveryData.list

특정 Android 애플리케이션에 대한 집계 전송 데이터를 나열합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
parent

string

필수의. 배달 데이터를 나열할 애플리케이션입니다. 형식: projects/{project_id}/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

AndroidDeliveryData

특정 날짜, 앱, 분석 라벨 조합에 대한 메시지 전송 데이터입니다.

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일이 있는 1년입니다.
  • 0일이 포함된 연도 및 월입니다(예: 신용 카드 만료일).

관련 유형:

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

integer

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

month

integer

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

day

integer

한 달의 일. 1부터 31까지이고 연도와 월에 유효해야 합니다. 연도 자체를 지정하거나 일자가 중요하지 않은 연도와 월을 지정하려면 0이어야 합니다.

데이터

메시징 전달을 자세히 설명하는 데이터

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

string ( int64 format)

Android 기기를 대상으로 FCM에서 허용한 메시지 수입니다. 대상 장치는 사용 및 진단 정보 수집을 선택해야 합니다.

messageOutcomePercents

object ( MessageOutcomePercents )

메시지 전달 결과를 상호 배타적으로 분석합니다.

deliveryPerformancePercents

object ( DeliveryPerformancePercents )

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

messageInsightPercents

object ( MessageInsightPercents )

메시지 전달에 대한 추가 일반 정보입니다.

메시지결과퍼센트

메시지 전달 결과의 백분율 분석입니다. 이러한 범주는 상호 배타적입니다. 모든 백분율은 countMessagesAccepted 분모로 사용하여 계산됩니다. 이러한 범주는 모든 메시지 결과를 설명하지 못할 수도 있습니다.

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

number

장치에 성공적으로 전달된 수락된 모든 메시지의 비율입니다.

pending

number

해당 날짜에 수락된 메시지 중 기기 연결이 끊어져 삭제되지 않고 전달되지 않은 메시지의 비율입니다(메시지가 FCM으로 전송된 America/Los_Angeles 날짜 종료 기준). 이러한 메시지 중 일부는 다음 날 장치가 연결될 때 전달되지만 다른 메시지는 궁극적으로 다시 연결되지 않는 장치로 전송될 수 있습니다.

droppedTooManyPendingMessages

number

전달되지 않은 축소할 수 없는 메시지가 너무 많아 삭제된 수락된 메시지의 비율입니다. 특히, 각 앱 인스턴스에는 연결이 끊긴 기기에 대해 서버에 저장된 보류 메시지가 100개만 있을 수 있습니다. 해당 장치가 다시 연결되면 해당 메시지가 전달됩니다. 보류 중인 메시지가 최대 개수보다 많은 경우 메시지를 전달하는 대신 SDK에서 OnDeletedMessages()를 호출합니다.

droppedAppForceStopped

number

전달 시 애플리케이션이 장치에서 강제 중지되어 재시도가 실패하여 삭제된 허용된 메시지의 비율입니다.

droppedDeviceInactive

number

대상 장치가 비활성 상태이기 때문에 삭제된 허용된 메시지의 비율입니다. FCM은 대상 장치가 서버에서 비활성화된 것으로 간주되면 메시지를 삭제합니다. 장치가 다시 연결되면 메시지를 전달하는 대신 SDK에서 OnDeletedMessages()를 호출합니다.

배달 실적백분율

성공적으로 전달된 메시지의 전달 성능 개요입니다. 모든 백분율은 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

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