Method: projects.androidApps.deliveryData.list

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

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

Yêu cầu. Ứng dụng liệt kê dữ liệu giao hàng. Định dạng: projects/{project_id}/androidApps/{appId}

Tham số truy vấn

Thông số
pageSize

integer

Số lượng 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 không được chỉ định, tối đa 1.000 mục sẽ được trả về. Giá trị tối đa là 10.000; giá trị trên 10.000 sẽ được giới hạn ở mức 10.000. Mặc định này có thể thay đổi theo thời gian.

pageToken

string

Mã thông báo trang được nhận từ lệnh gọi ListAndroidDeliveryDataRequest trước đó. Cung cấp điều 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

Phần thân yêu cầu phải trống.

Nội dung phản hồi

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:

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

Biểu diễn JSON
{
  "androidDeliveryData": [
    {
      object (AndroidDeliveryData)
    }
  ],
  "nextPageToken": string
}
Lĩnh vực
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 sự kết hợp giữa nhãn ứng dụng, ngày tháng và 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, sẽ không có trang tiếp theo.

Phạm vi ủy quyền

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

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

Dữ liệu phân phối Android

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

Biểu diễn JSON
{
  "appId": string,
  "date": {
    object (Date)
  },
  "analyticsLabel": string,
  "data": {
    object (Data)
  }
}
Lĩnh vực
appId

string

ID ứng dụng mà tin nhắn được gửi tới.

date

object ( Date )

Ngày được đại diện bởi mục này.

analyticsLabel

string

Nhãn phân tích được liên kết với các tin nhắn được gửi. Tất cả thư được gửi mà 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 cho appId , dateanalyticsLabel đượ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 Gregorian. Điều này có thể đại diện cho một trong những điều sau đây:

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

Các loại liên quan:

Biểu diễn JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Lĩnh vực
year

integer

Năm của ngày. Phải từ 1 đến 9999 hoặc 0 để chỉ định ngày không có năm.

month

integer

Tháng của một năm. Phải từ 1 đến 12 hoặc 0 để chỉ định năm không có tháng và ngày.

day

integer

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

Dữ liệu

Dữ liệu chi tiết việc gửi tin nhắn

Biểu diễn JSON
{
  "countMessagesAccepted": string,
  "messageOutcomePercents": {
    object (MessageOutcomePercents)
  },
  "deliveryPerformancePercents": {
    object (DeliveryPerformancePercents)
  },
  "messageInsightPercents": {
    object (MessageInsightPercents)
  }
}
Lĩnh vực
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ị được nhắm 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 loại trừ lẫn nhau 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 tin nhắn đã được gửi thành công.

messageInsightPercents

object ( MessageInsightPercents )

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

Tin nhắnKết quảPhần trăm

Phân tích phần trăm kết quả gửi tin nhắn. Những loại này là loại trừ lẫn nhau. Tất cả tỷ lệ phần trăm được tính bằng countMessagesAccepted làm mẫu số. Những danh mục này có thể không giải thích được tất cả các kết quả của tin nhắn.

Biểu diễn JSON
{
  "delivered": number,
  "pending": number,
  "droppedTooManyPendingMessages": number,
  "droppedAppForceStopped": number,
  "droppedDeviceInactive": number
}
Lĩnh vực
delivered

number

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

pending

number

Tỷ lệ phần trăm tin nhắn được chấp nhận vào ngày này không bị hủy và không được gửi do thiết bị bị ngắt kết nối (tính đến cuối ngày America/Los_Angeles khi tin nhắn được gửi tới FCM). Một phần trong số những 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 những thiết bị cuối cùng không bao giờ kết nối lại.

droppedTooManyPendingMessages

number

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

droppedAppForceStopped

number

Tỷ lệ phần trăm tin nhắn được chấp nhận đã bị loại bỏ 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ần thử lại không thành công.

droppedDeviceInactive

number

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

Phân phốiHiệu suấtPhần trăm

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

Biểu diễn JSON
{
  "deliveredNoDelay": number,
  "delayedDeviceOffline": number,
  "delayedDeviceDoze": number,
  "delayedMessageThrottled": number,
  "delayedUserStopped": number
}
Lĩnh vực
deliveredNoDelay

number

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

delayedDeviceOffline

number

Tỷ lệ tin nhắn được chấp nhận bị trì hoãn do thiết bị mục tiêu không được kết nối tại thời điểm gửi. Những tin nhắn này cuối cùng đã được gửi khi thiết bị được kết nối lại.

delayedDeviceDoze

number

Phần trăm tin nhắn được chấp nhận bị trì hoãn do thiết bị đang ở chế độ ngủ quên. Chỉ những tin nhắn ưu tiên thông thường mới bị trì hoãn do chế độ ngủ gật.

delayedMessageThrottled

number

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

delayedUserStopped

number

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

Tin nhắnInsightPhần trăm

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

Biểu diễn JSON
{
  "priorityLowered": number
}
Lĩnh vực
priorityLowered

number

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