Method: projects.androidApps.deliveryData.list

Liệt kê dữ liệu phân phối tổng hợp cho ứng dụng Android đã cho.

yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

Bắt buộc. Ứng dụng liệt kê dữ liệu phân phối. Định dạng: projects/{projectId}/androidApps/{appId}

Tham số truy vấn

Thông số
pageSize

integer

Số mục nhập tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, hệ thống sẽ trả về tối đa 1.000 mục nhập. Giá trị tối đa là 10.000; nếu vượt quá 10.000 thì sẽ bị giới hạn ở mức 10.000. Chế độ mặc định này có thể thay đổi theo thời gian.
pageToken

string

Mã thông báo trang, nhận được từ lệnh gọi ListAndroidDeliveryDataRequest trước đó. Cung cấp mã này để truy xuất trang tiếp theo. Khi phân trang, tất cả các tham số khác được cung cấp cho ListAndroidDeliveryDataRequest phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Thông báo phản hồi cho deliveryData.list.

Nếu thành công, nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "androidDeliveryData": [
    {
      object (AndroidDeliveryData)
    }
  ],
  "nextPageToken": string
}
Trường
androidDeliveryData[]

object (AndroidDeliveryData)

Dữ liệu phân phối cho ứng dụng được cung cấp. Sẽ có một mục nhập cho mỗi tổ hợp ứng dụng, ngày và nhãn phân tích.
nextPageToken

string

Mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua thì sẽ không có trang tiếp theo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau đây:

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

Dữ liệu phân phối của Android

Dữ liệu gửi tin nhắn cho một tổ hợp ngày, ứng dụng và nhãn số liệu phân tích cụ thể.

Biểu diễn dưới dạng JSON 
{
  "appId": string,
  "date": {
    object (Date)
  },
  "analyticsLabel": string,
  "data": {
    object (Data)
  }
}
Trường
appId

string

Mã ứng dụng mà thông báo được gửi đến.
date

object (Date)

Ngày được thể hiện trên mục này.
analyticsLabel

string

Nhãn số liệu phân tích được liên kết với thư đã gửi. Tất cả thư được gửi không có nhãn phân tích sẽ được nhóm lại với nhau trong một mục nhập duy nhất.
data

object (Data)

Dữ liệu của appId, date và analyticsLabel được chỉ định.

Ngày

Đại diện cho toàn bộ hoặc một phần ngày theo lịch, chẳng hạn như ngày sinh nhật. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không đáng kể. Ngày này có liên quan đến Lịch Gregory. Thông tin này có thể là một trong những trường hợp sau:

  • Ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
  • Tháng và ngày, thể hiện giá trị năm 0 (ví dụ: ngày kỷ niệm).
  • Một năm riêng biệt, tháng không tháng và ngày không tháng.
  • Năm và tháng, không có ngày (ví dụ: ngày hết hạn thẻ tín dụng).

Các loại có liên quan:

Biểu diễn dưới dạng JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Trường
year

integer

Năm của ngày. Giá trị phải từ 1 đến 9999 hoặc bằng 0 để chỉ định ngày không có năm.
month

integer

Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc bằng 0 để chỉ định một năm không có tháng và ngày.
day

integer

Ngày trong tháng. Phải có giá trị từ 1 đến 31 và có giá trị hợp lệ trong năm và tháng, hoặc bằng 0 để chỉ định một năm độc lập hoặc là một năm và tháng mà ngày không quan trọng.

Dữ liệu

Dữ liệu chi tiết về quá trình gửi tin nhắn

Biểu diễn dưới dạng JSON 
{
  "countMessagesAccepted": string,
  "countNotificationsAccepted": string,
  "messageOutcomePercents": {
    object (MessageOutcomePercents)
  },
  "deliveryPerformancePercents": {
    object (DeliveryPerformancePercents)
  },
  "messageInsightPercents": {
    object (MessageInsightPercents)
  },
  "proxyNotificationInsightPercents": {
    object (ProxyNotificationInsightPercents)
  }
}
Trường
countMessagesAccepted

string (int64 format)

Số lượng tin nhắn được FCM chấp nhận dành cho thiết bị Android. Thiết bị mục tiêu phải chọn tham gia thu thập thông tin sử dụng và chẩn đoán.
countNotificationsAccepted

string (int64 format)

Số lượng thông báo được FCM chấp nhận dành cho thiết bị Android. Thiết bị mục tiêu phải chọn tham gia thu thập thông tin sử dụng và chẩn đoán.
messageOutcomePercents

object (MessageOutcomePercents)

Phân tích hoàn toàn riêng biệt về kết quả gửi tin nhắn.
deliveryPerformancePercents

object (DeliveryPerformancePercents)

Thông tin bổ sung về hiệu suất gửi của các thư đã được gửi thành công.
messageInsightPercents

object (MessageInsightPercents)

Thông tin chi tiết chung bổ sung về gửi tin nhắn.
proxyNotificationInsightPercents

object (ProxyNotificationInsightPercents)

Thông tin chi tiết bổ sung về chế độ gửi thông báo qua proxy.

Phần trăm kết quả tin nhắn

Bảng chi tiết tỷ lệ phần trăm kết quả gửi tin nhắn. Các danh mục này loại trừ lẫn nhau. Tất cả tỷ lệ phần trăm đều được tính với mẫu số là countMessagesAccepted. Các danh mục này có thể không tính đến tất cả kết quả của thông báo.

Biểu diễn dưới dạng JSON 
{
  "delivered": number,
  "pending": number,
  "collapsed": number,
  "droppedTooManyPendingMessages": number,
  "droppedAppForceStopped": number,
  "droppedDeviceInactive": number,
  "droppedTtlExpired": number
}
Trường
delivered

number

Phần trăm gửi thành công tất cả tin nhắn được chấp nhận đến thiết bị.
pending

number

Tỷ lệ phần trăm số tin nhắn được chấp nhận trong ngày này nhưng không bị thả và không được gửi do thiết bị bị ngắt kết nối (kể từ cuối ngày Hoa Kỳ/Los_Angeles khi tin nhắn được gửi tới FCM). Một phần trong số các tin nhắn này sẽ được gửi vào ngày hôm sau khi thiết bị kết nối, nhưng những tin nhắn khác có thể được gửi đến các thiết bị cuối cùng không bao giờ kết nối lại.
collapsed

number

Tỷ lệ phần trăm số tin nhắn được chấp nhận đã bị một tin nhắn khác thu gọn.
droppedTooManyPendingMessages

number

Tỷ lệ phần trăm tin nhắn được chấp nhận bị bỏ qua do quá nhiều tin nhắn không thể thu gọn chưa được gửi. Cụ thể, mỗi phiên bản ứng dụng chỉ được lưu trữ 100 tin nhắn đang chờ xử lý trên máy chủ của chúng tôi cho một thiết bị đã bị ngắt kết nối. Khi thiết bị đó kết nối lại, các tin nhắn đó sẽ được gửi. Khi số lượng thông báo đang chờ xử lý nhiều hơn mức tối đa, chúng ta sẽ gọi OnDeletedMessages() trong SDK thay vì gửi thông báo.
droppedAppForceStopped

number

Tỷ lệ phần trăm tin nhắn được chấp nhận bị bỏ qua do ứng dụng bị buộc dừng trên thiết bị tại thời điểm gửi và các lượt thử lại không thành công.
droppedDeviceInactive

number

Tỷ lệ phần trăm tin nhắn được chấp nhận bị bỏ qua do thiết bị mục tiêu không hoạt động. FCM sẽ gửi thông báo nếu thiết bị mục tiêu bị máy chủ của chúng tôi coi là không hoạt động. Nếu thiết bị kết nối lại, chúng ta sẽ gọi OnDeletedMessages() trong SDK thay vì gửi thông báo.
droppedTtlExpired

number

Tỷ lệ phần trăm số tin nhắn được chấp nhận nhưng hết hạn do Thời gian tồn tại (TTL) đã trôi qua trước khi thiết bị mục tiêu kết nối lại.

Phân phối phần trăm hiệu suất

Tổng quan về hiệu suất gửi thư đã được gửi thành công. Tất cả tỷ lệ phần trăm đều được tính với mẫu số là countMessagesAccepted. Các danh mục này không loại trừ lẫn nhau; một thư có thể bị trì hoãn vì nhiều lý do.

Biểu diễn dưới dạng JSON 
{
  "deliveredNoDelay": number,
  "delayedDeviceOffline": number,
  "delayedDeviceDoze": number,
  "delayedMessageThrottled": number,
  "delayedUserStopped": number
}
Trường
deliveredNoDelay

number

Tỷ lệ phần trăm tin nhắn được chấp nhận được gửi tới thiết bị mà không bị hệ thống FCM chậm trễ.
delayedDeviceOffline

number

Tỷ lệ phần trăm số tin nhắn được chấp nhận nhưng bị trì hoãn do thiết bị đích không kết nối tại thời điểm gửi. Cuối cùng, những tin nhắn này cũng được gửi khi thiết bị kết nối lại.
delayedDeviceDoze

number

Tỷ lệ phần trăm số tin nhắn đã chấp nhận nhưng bị trì hoãn do thiết bị ở chế độ nghỉ. Chỉ các thông báo có mức độ ưu tiên bình thường mới bị trễ do chế độ nghỉ.
delayedMessageThrottled

number

Tỷ lệ phần trăm số tin nhắn được chấp nhận bị trì hoãn do điều tiết tin nhắn, chẳng hạn như điều tiết tin nhắn có thể thu gọn hoặc điều chỉnh tốc độ tin nhắn tối đa.
delayedUserStopped

number

Tỷ lệ phần trăm số tin nhắn được chấp nhận nhưng bị trì hoãn do hồ sơ người dùng dự kiến trên thiết bị đã dừng trên thiết bị mục tiêu tại thời điểm gửi. Cuối cùng, các tin nhắn cũng được gửi khi hồ sơ người dùng được khởi động lại.

Phần trăm phần trăm tin nhắn

Thông tin bổ sung về tính năng gửi tin nhắn. Tất cả tỷ lệ phần trăm đều được tính với mẫu số là countMessagesAccepted.

Biểu diễn dưới dạng JSON 
{
  "priorityLowered": number
}
Trường
priorityLowered

number

Tỷ lệ phần trăm thư được chấp nhận đã giảm mức độ ưu tiên từ cao xuống bình thường. Xem tài liệu về cách đặt mức độ ưu tiên của thông báo.

ProxyNotificationInsightsPercents

Thông tin bổ sung về việc gửi thông báo qua proxy. Tất cả tỷ lệ phần trăm đều được tính với mẫu số là countNotificationsAccepted.

Biểu diễn dưới dạng JSON 
{
  "proxied": number,
  "failed": number,
  "skippedUnsupported": number,
  "skippedNotThrottled": number,
  "skippedUnconfigured": number,
  "skippedOptedOut": number
}
Trường
proxied

number

Tỷ lệ phần trăm những thông báo được chấp nhận mà Dịch vụ Google Play đã xử lý thành công.
failed

number

Tỷ lệ phần trăm số thông báo được chấp nhận nhưng không qua máy chủ proxy. Việc này thường là do ngoại lệ xảy ra trong khi gọi notifyAsPackage.
skippedUnsupported

number

Tỷ lệ phần trăm thông báo được chấp nhận nhưng bị bỏ qua do thông báo proxy không được hỗ trợ cho người nhận.
skippedNotThrottled

number

Tỷ lệ phần trăm số thông báo được chấp nhận nhưng bị bỏ qua do thư không bị điều tiết.
skippedUnconfigured

number

Tỷ lệ phần trăm thông báo được chấp nhận nhưng bị bỏ qua do thiếu cấu hình cần thiết để xử lý thông báo qua máy chủ proxy.
skippedOptedOut

number

Tỷ lệ phần trăm số thông báo được chấp nhận nhưng bị bỏ qua do ứng dụng không cho phép xử lý những tin nhắn này qua máy chủ proxy.