- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi ủy quyền
- Dữ liệu phân phối Android
- Ngày
- Dữ liệu
- Tin nhắnKết quảPhần trăm
- Phân phốiHiệu suấtPhần trăm
- Tin nhắnInsightPhần trăm
- Thử nó!
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 | Yêu cầu. Ứng dụng liệt kê dữ liệu giao hàng. Định dạng: |
Tham số truy vấn
Thông số | |
---|---|
pageSize | 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 | Mã thông báo trang được nhận từ lệnh gọi |
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 ( |
Lĩnh vực | |
---|---|
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 | Mã thông báo có thể được gửi dưới dạng |
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 ( |
Lĩnh vực | |
---|---|
appId | ID ứng dụng mà tin nhắn được gửi tới. |
date | Ngày được đại diện bởi mục này. |
analyticsLabel | 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 | Dữ liệu cho |
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:
-
google.type.TimeOfDay
-
google.type.DateTime
-
google.protobuf.Timestamp
Biểu diễn JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Lĩnh vực | |
---|---|
year | 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 | 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 | 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 ( |
Lĩnh vực | |
---|---|
countMessagesAccepted | 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 | Phân tích loại trừ lẫn nhau về kết quả gửi tin nhắn. |
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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 . |