Tìm hiểu về cách gửi thư

FCM cung cấp 3 bộ công cụ để giúp bạn nắm được thông tin chi tiết về việc phân phối thông báo:

  • Firebase báo cáo về hoạt động gửi thông báo trên bảng điều khiển
  • Các chỉ số phân phối SDK Android tổng hợp từ API Dữ liệu Firebase Cloud Messaging
  • Xuất dữ liệu toàn diện sang Google BigQuery

Các công cụ báo cáo được mô tả trong trang này đều yêu cầu Google Analytics để hoạt động. Nếu chưa bật Google Analytics cho dự án, bạn có thể thiết lập tính năng này trong thẻ tích hợp của phần cài đặt dự án Firebase.

Xin lưu ý rằng việc báo cáo nhiều số liệu thống kê trên trang này có thể bị chậm trễ tối đa 24 giờ do việc phân lô dữ liệu phân tích.

Báo cáo về hoạt động gửi thư

Trong thẻ Báo cáo trên bảng điều khiển Firebase, bạn có thể xem dữ liệu sau đây cho các thông báo gửi đến SDK FCM của nền tảng Android hoặc Apple, bao gồm cả những thông báo được gửi qua trình soạn Thông báo và API FCM:

  • Gửi — Tin nhắn dữ liệu hoặc thông báo đã được đưa vào hàng đợi để phân phối hoặc đã được chuyển thành công đến một dịch vụ của bên thứ ba như APN để phân phối. Xem thời gian hoạt động của một thông báo để biết thêm thông tin.
  • Đã nhận (chỉ có trên các thiết bị Android) – Ứng dụng đã nhận được tin nhắn dữ liệu hoặc tin nhắn thông báo. Dữ liệu này sẽ có sẵn khi thiết bị Android nhận cài đặt SDK FCM 18.0.1 trở lên.
  • Số lượt hiển thị (chỉ dành cho thông báo trên thiết bị Android) – Thông báo hiển thị đã hiển thị trên thiết bị trong khi ứng dụng đang chạy ở chế độ nền.
  • Mở – Người dùng đã mở thư thông báo. Chỉ được báo cáo cho các thông báo nhận được khi ứng dụng chạy trong nền.

Dữ liệu này có sẵn cho tất cả thông báo có tải trọng thông báo và tất cả thông báo dữ liệu được gắn nhãn. Để tìm hiểu thêm về nhãn, hãy xem bài viết Thêm nhãn phân tích vào thư.

Khi xem báo cáo về thông báo, bạn có thể đặt phạm vi ngày cho dữ liệu hiển thị, cùng với tuỳ chọn xuất sang CSV. Bạn cũng có thể lọc theo các tiêu chí sau:

  • Nền tảng (iOS hoặc Android)
  • Ứng dụng
  • Nhãn phân tích tuỳ chỉnh

Thêm nhãn phân tích vào thư

Việc gắn nhãn thư rất hữu ích cho hoạt động phân tích tuỳ chỉnh, cho phép bạn lọc số liệu thống kê về thư gửi theo nhãn hoặc nhóm nhãn. Bạn có thể thêm nhãn vào bất kỳ thông báo nào được gửi qua API HTTP v1 bằng cách đặt trường fcmOptions.analyticsLabel trong đối tượng message hoặc trong các trường AndroidFcmOptions hoặc ApnsFcmOptions dành riêng cho nền tảng.

Nhãn Analytics là các chuỗi văn bản có định dạng ^[a-zA-Z0-9-_.~%]{1,50}$. Nhãn có thể bao gồm chữ cái viết thường và viết hoa, số và các ký hiệu sau:

  • -
  • ~
  • %

Độ dài tối đa là 50 ký tự. Bạn có thể chỉ định tối đa 100 nhãn duy nhất mỗi ngày; những thư có nhãn được thêm vượt quá giới hạn đó sẽ không được báo cáo.

Trong thẻ Báo cáo nhắn tin trên bảng điều khiển của Firebase, bạn có thể tìm kiếm danh sách tất cả các nhãn hiện có và áp dụng từng nhãn hoặc kết hợp để lọc số liệu thống kê hiển thị.

Dữ liệu phân phối tổng hợp qua API Dữ liệu FCM

API Dữ liệu của Giải pháp gửi thông báo qua đám mây của Firebase cho phép bạn truy xuất thông tin có thể giúp bạn hiểu kết quả của các yêu cầu thông báo nhắm đến ứng dụng Android. API này cung cấp dữ liệu tổng hợp trên tất cả các thiết bị Android đã bật tính năng thu thập dữ liệu trong một dự án. Dữ liệu này bao gồm thông tin chi tiết về tỷ lệ phần trăm thông báo được phân phối mà không có độ trễ cũng như số lượng thông báo bị trì hoãn hoặc bỏ qua trong Lớp truyền tải Android. Việc đánh giá dữ liệu này có thể cho thấy các xu hướng chung trong việc gửi thư và giúp bạn tìm ra cách hiệu quả để cải thiện hiệu suất của các yêu cầu gửi. Hãy xem bài viết Tiến trình tổng hợp dữ liệu để biết thông tin về phạm vi ngày có sẵn trong báo cáo.

API cung cấp tất cả dữ liệu có sẵn cho một ứng dụng nhất định. Vui lòng xem Tài liệu tham khảo API.

Dữ liệu được phân tích như thế nào?

Dữ liệu phân phối được chia theo ứng dụng, ngày và nhãn phân tích. Lệnh gọi đến API sẽ trả về dữ liệu cho mọi tổ hợp ngày, ứng dụng và nhãn phân tích. Ví dụ: một đối tượng JSON androidDeliveryData sẽ có dạng như sau:

 {
  "appId": "1:23456789:android:a93a5mb1234efe56",
  "date": {
    "year": 2021,
    "month": 1,
    "day": 1
  },
  "analyticsLabel": "foo",
  "data": {
    "countMessagesAccepted": "314159",
    "messageOutcomePercents": {
      "delivered": 71,
      "pending": 15
    },
   "deliveryPerformancePercents": {
      "deliveredNoDelay": 45,
      "delayedDeviceOffline": 11
    }
  }

Cách diễn giải các chỉ số

Dữ liệu phân phối cho biết tỷ lệ phần trăm thông báo phù hợp với từng chỉ số sau. Có thể là một thông điệp phù hợp với nhiều chỉ số. Do những hạn chế về cách chúng tôi thu thập dữ liệu và mức độ chi tiết mà chúng tôi tổng hợp các chỉ số, một số kết quả của thông báo không được thể hiện trong các chỉ số, vì vậy, tỷ lệ phần trăm dưới đây sẽ không đạt 100%.

Số lượng tin nhắn đã chấp nhận

Số lượng duy nhất có trong tập dữ liệu là số lượng thông báo mà FCM chấp nhận để phân phối đến các thiết bị Android. Tất cả phần trăm đều sử dụng giá trị này làm mẫu số. Xin lưu ý rằng số lượng này sẽ không bao gồm các thông báo được nhắm đến những người dùng đã tắt tính năng thu thập thông tin chẩn đoán và sử dụng trên thiết bị của họ.

Tỷ lệ phần trăm kết quả của tin nhắn

Các trường có trong đối tượng MessageOutcomePercents cung cấp thông tin về kết quả của các yêu cầu gửi tin nhắn. Các danh mục này loại trừ lẫn nhau. Công cụ này có thể trả lời các câu hỏi như "Tin nhắn của tôi có được gửi đi không?" và "Tại sao tin nhắn bị xoá?"

Ví dụ: giá trị cao cho trường droppedTooManyPendingMessages có thể báo hiệu rằng các thực thể ứng dụng đang nhận số lượng thông báo không thể thu gọn vượt quá giới hạn 100 thông báo đang chờ xử lý của FCM. Để giảm thiểu điều này, hãy đảm bảo ứng dụng của bạn xử lý các lệnh gọi đến onDeletedMessages và cân nhắc việc gửi tin nhắn có thể thu gọn. Tương tự, tỷ lệ phần trăm cao của droppedDeviceInactive có thể là tín hiệu để cập nhật mã thông báo đăng ký trên máy chủ của bạn, xoá các mã thông báo cũ và huỷ đăng ký chúng khỏi các chủ đề. Hãy xem phần Quản lý mã thông báo đăng ký FCM để biết các phương pháp hay nhất trong lĩnh vực này.

Tỷ lệ phần trăm hiệu suất phân phối

Các trường trong đối tượng DeliveryPerformancePercents cung cấp thông tin về các thông báo đã được gửi thành công. Công cụ này có thể trả lời các câu hỏi như "Thư của tôi có bị trì hoãn không?" và "Tại sao thư bị trì hoãn?" Ví dụ: giá trị cao của delayedMessageThrottled sẽ cho biết rõ rằng bạn đang vượt quá giới hạn tối đa trên mỗi thiết bị và nên điều chỉnh tốc độ gửi tin nhắn.

Tỷ lệ phần trăm thông tin chi tiết về tin nhắn

Đối tượng này cung cấp thêm thông tin về tất cả tin nhắn đã gửi. Trường priorityLowered thể hiện tỷ lệ phần trăm thông báo được chấp nhận có mức độ ưu tiên giảm từ HIGH xuống NORMAL. Nếu giá trị này cao, hãy thử gửi ít thông báo có mức độ ưu tiên cao hơn hoặc đảm bảo rằng bạn luôn hiển thị thông báo khi gửi tin nhắn có mức độ ưu tiên cao. Hãy xem tài liệu của chúng tôi về mức độ ưu tiên của thông báo để biết thêm thông tin

Dữ liệu này khác với dữ liệu được xuất sang BigQuery như thế nào?

Tính năng xuất BigQuery cung cấp các nhật ký thông báo riêng lẻ về việc phần phụ trợ FCM chấp nhận thông báo và phân phối thông báo trong SDK trên thiết bị (Bước 2 và 4 của Cấu trúc FCM). Dữ liệu này rất hữu ích trong việc đảm bảo từng thông báo được chấp nhận và gửi. Hãy đọc thêm về tính năng xuất dữ liệu BigQuery trong phần tiếp theo.

Ngược lại, API Dữ liệu của Giải pháp gửi thông báo qua đám mây của Firebase cung cấp thông tin chi tiết tổng hợp về những gì xảy ra cụ thể trong Lớp truyền tải Android (hoặc Bước 3 của Cấu trúc FCM). Dữ liệu này đặc biệt cung cấp thông tin chi tiết về hoạt động gửi thông báo từ phần phụ trợ FCM đến SDK Android. Điều này đặc biệt hữu ích khi cho thấy xu hướng về lý do khiến thông báo bị trì hoãn hoặc bị loại bỏ trong quá trình truyền này.

Trong một số trường hợp, 2 tập dữ liệu này có thể không khớp chính xác do:

  • Các chỉ số tổng hợp chỉ lấy mẫu một phần trong tất cả thư
  • Các chỉ số tổng hợp được làm tròn
  • Chúng tôi không trình bày các chỉ số thấp hơn ngưỡng về quyền riêng tư
  • Một phần kết quả của thông báo bị thiếu do các hoạt động tối ưu hoá trong cách chúng tôi quản lý khối lượng lớn lưu lượng truy cập.

Các giới hạn của API

Tiến trình tổng hợp dữ liệu

API này sẽ trả về dữ liệu trong quá khứ trong 7 ngày; tuy nhiên, dữ liệu do API này trả về sẽ bị trễ tối đa 5 ngày. Ví dụ: vào ngày 20 tháng 1, bạn sẽ có dữ liệu từ ngày 9 tháng 1 đến ngày 15 tháng 1, nhưng không có dữ liệu từ ngày 16 tháng 1 trở đi. Ngoài ra, chúng tôi cố gắng hết sức có thể để cung cấp dữ liệu. Trong trường hợp xảy ra sự cố mất dữ liệu, FCM sẽ cố gắng khắc phục sự cố và sẽ không bổ sung dữ liệu sau khi khắc phục sự cố. Trong những trường hợp ngừng dịch vụ lớn hơn, dữ liệu có thể không có sẵn trong một tuần hoặc lâu hơn.

Mức độ phù hợp của dữ liệu

Các chỉ số do API Dữ liệu của Giải pháp gửi thông báo qua đám mây của Firebase cung cấp nhằm cung cấp thông tin chi tiết về các xu hướng chung của việc phân phối thông báo. Tuy nhiên, các trường hợp này không bao phủ 100% tất cả các tình huống về thông báo. Các trường hợp sau đây là những kết quả đã biết không được phản ánh trong các chỉ số.

Thông báo đã hết hạn

Nếu Thời gian tồn tại (TTL) hết hạn sau khi kết thúc ngày ghi nhật ký cụ thể, thì tin nhắn đó sẽ không được tính là droppedTtlExpired vào ngày này.

Thông báo đến các thiết bị không hoạt động

Tin nhắn được gửi đến các thiết bị không hoạt động có thể xuất hiện hoặc không xuất hiện trong tập dữ liệu, tuỳ thuộc vào đường dẫn dữ liệu mà chúng đi theo. Điều này có thể dẫn đến việc tính sai một số trong các trường droppedDeviceInactivepending.

Thông báo cho các thiết bị có một số lựa chọn ưu tiên nhất định của người dùng

Những người dùng đã tắt tính năng thu thập thông tin chẩn đoán và sử dụng trên thiết bị sẽ không có tin nhắn được tính vào số liệu của chúng tôi, theo lựa chọn ưu tiên của họ.

Làm tròn và tối thiểu

FCM có chủ ý làm tròn và loại trừ số lượng trong trường hợp số lượng không đủ lớn.

Xuất dữ liệu BigQuery

Bạn có thể xuất dữ liệu tin nhắn vào BigQuery để phân tích thêm. BigQuery cho phép bạn phân tích dữ liệu bằng BigQuery SQL, xuất dữ liệu sang một nhà cung cấp dịch vụ đám mây khác hoặc sử dụng dữ liệu cho các mô hình học máy tuỳ chỉnh của bạn. Quá trình xuất sang BigQuery bao gồm tất cả dữ liệu có sẵn cho thông báo, bất kể loại thông báo hoặc thông báo được gửi qua API hay trình soạn thông báo.

Đối với các thông báo được gửi đến các thiết bị có phiên bản SDK tối thiểu FCM sau đây, bạn có thêm lựa chọn để cho phép xuất dữ liệu gửi thông báo cho ứng dụng của mình:

  • Android 20.1.0 trở lên.
  • iOS 8.6.0 trở lên
  • Firebase Web SDK 9.0.0 trở lên

Hãy xem phần bên dưới để biết thông tin chi tiết về cách bật tính năng xuất dữ liệu cho AndroidiOS.

Để bắt đầu, hãy liên kết dự án của bạn với BigQuery:

  1. Chọn một trong các tùy chọn sau:

    • Mở trình soạn thông báo, sau đó nhấp vào Truy cập BigQuery ở cuối trang.

    • Trên trang Tích hợp trong bảng điều khiển Firebase, hãy nhấp vào Liên kết trong thẻ BigQuery.

      Trang này hiển thị các tuỳ chọn xuất FCM cho tất cả ứng dụng đã bật FCM trong dự án.

  2. Làm theo hướng dẫn trên màn hình để bật BigQuery.

Hãy tham khảo bài viết Liên kết Firebase với BigQuery để biết thêm thông tin.

Khi bạn bật tính năng xuất BigQuery cho Cloud Messaging:

  • Firebase xuất dữ liệu của bạn sang BigQuery. Xin lưu ý rằng quá trình truyền dữ liệu ban đầu để xuất có thể mất đến 48 giờ mới hoàn tất.

  • Sau khi tạo tập dữ liệu, bạn sẽ không thể thay đổi vị trí này nữa. Tuy nhiên, bạn có thể sao chép tập dữ liệu sang một vị trí khác hoặc tự di chuyển (tạo lại) tập dữ liệu ở một vị trí khác. Để tìm hiểu thêm, hãy xem bài viết Thay đổi vị trí tập dữ liệu.

  • Firebase thiết lập quá trình đồng bộ hoá dữ liệu thường xuyên từ dự án Firebase của bạn với BigQuery. Các hoạt động xuất hằng ngày này bắt đầu lúc 4:00 AM theo giờ Thái Bình Dương và thường kết thúc trong vòng 24 giờ.

  • Theo mặc định, mọi ứng dụng trong dự án của bạn đều được liên kết với BigQuery và mọi ứng dụng mà sau này bạn thêm vào dự án sẽ tự động được liên kết với BigQuery. Bạn có thể quản lý những ứng dụng gửi dữ liệu.

Để huỷ kích hoạt tính năng xuất BigQuery, hãy huỷ liên kết dự án của bạn trong bảng điều khiển Firebase.

Bật tính năng xuất dữ liệu phân phối tin nhắn

Các thiết bị iOS có SDK FCM 8.6.0 trở lên có thể bật tính năng xuất dữ liệu phân phối tin nhắn của ứng dụng. FCM hỗ trợ xuất dữ liệu cho cả thông báo cảnh báo và thông báo ở chế độ nền. Trước khi bật các tuỳ chọn này, trước tiên, bạn phải tạo đường liên kết FCM-BigQuery cho dự án của mình như mô tả trong phần Xuất dữ liệu sang BigQuery.

Bật tính năng xuất dữ liệu phân phối cho thông báo cảnh báo

Vì chỉ thông báo cảnh báo mới có thể kích hoạt tiện ích ứng dụng dịch vụ thông báo, bạn phải thêm tiện ích dịch vụ thông báo vào ứng dụng của mình và gọi API này bên trong tiện ích dịch vụ để bật tính năng theo dõi thông báo hiển thị. Xem tài liệu của Apple về Sửa đổi nội dung trong thông báo mới được phân phối.

Lệnh gọi sau phải được thực hiện cho mọi thông báo nhận được:

Swift

// For alert notifications, call the API inside the service extension:
class NotificationService: UNNotificationServiceExtension {
  override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
  Messaging.extensionHelper()
      .exportDeliveryMetricsToBigQuery(withMessageInfo:request.content.userInfo)
  }
}

Objective-C

// For alert notifications, call the API inside the service extension:
@implementation NotificationService
- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request
                   withContentHandler:(void (^)(UNNotificationContent *_Nonnull))contentHandler {
  [[FIRMessaging extensionHelper] exportDeliveryMetricsToBigQueryWithMessageInfo:request.content.userInfo];
}
@end

Nếu bạn đang tạo các yêu cầu gửi bằng API HTTP v1, hãy nhớ chỉ định mutable-content = 1 trong đối tượng tải trọng.

Bật tính năng xuất dữ liệu phân phối cho thông báo trong nền

Đối với thông báo ở chế độ nền nhận được khi ứng dụng đang chạy ở chế độ nền trước hoặc nền sau, bạn có thể gọi API xuất dữ liệu bên trong trình xử lý thông báo dữ liệu của ứng dụng chính. Cuộc gọi này phải được thực hiện cho mọi thông báo nhận được:

Swift

// For background notifications, call the API inside the UIApplicationDelegate or NSApplicationDelegate method:
func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) {
  Messaging.extensionHelper().exportDeliveryMetricsToBigQuery(withMessageInfo:userInfo)
}

Objective-C

// For background notifications, call the API inside the UIApplicationDelegate or NSApplicationDelegate method:
@implementation AppDelegate
- (void)application:(UIApplication *)application
    didReceiveRemoteNotification:(NSDictionary *)userInfo
          fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
  [[FIRMessaging extensionHelper] exportDeliveryMetricsToBigQueryWithMessageInfo:userInfo];
}
@end

Dữ liệu nào được xuất sang BigQuery?

Xin lưu ý rằng việc nhắm mục tiêu các mã thông báo cũ hoặc lượt đăng ký không hoạt động có thể làm tăng giả tạo một số số liệu thống kê này.

Giản đồ của bảng đã xuất là:

_PARTITIONTIME DẤU THỜI GIAN Cột giả này chứa dấu thời gian cho thời điểm bắt đầu ngày (theo giờ UTC) mà dữ liệu được tải. Đối với phân vùng YYYYMMDD, cột giả này chứa giá trị TIMESTAMP('YYYY-MM-DD').
event_timestamp DẤU THỜI GIAN Dấu thời gian của sự kiện do máy chủ ghi lại
số_dự_án INTEGER Số dự án xác định dự án đã gửi thông báo
message_id STRING Mã nhận dạng của thông báo xác định một thông báo. Được tạo từ Mã ứng dụng và dấu thời gian, mã thông báo có thể không phải là mã duy nhất trên toàn cầu trong một số trường hợp.
mã_thực_tế STRING Mã nhận dạng duy nhất của ứng dụng mà thông báo được gửi đến (nếu có). Đây có thể là mã phiên bản hoặc mã cài đặt Firebase.
loại tin nhắn STRING Loại thông báo. Có thể là Tin nhắn thông báo hoặc Tin nhắn dữ liệu. Chủ đề được dùng để xác định tin nhắn ban đầu cho một chủ đề hoặc chiến dịch được gửi; các tin nhắn tiếp theo sẽ là thông báo hoặc thông điệp dữ liệu.
sdk_platform STRING Nền tảng của ứng dụng người nhận
app_name STRING Tên gói cho ứng dụng Android hoặc mã nhận dạng gói cho ứng dụng iOS
collapse_key STRING Phím thu gọn xác định một nhóm thư có thể thu gọn được. Khi một thiết bị không được kết nối, chỉ thông báo cuối cùng có khoá thu gọn nhất định mới được đưa vào hàng đợi để phân phối
tuyển sinh ưu tiên INTEGER Mức độ ưu tiên của thông báo. Các giá trị hợp lệ là "bình thường" và "cao". Trên iOS, các mức này tương ứng với mức độ ưu tiên 5 và 10 của APN
ttl INTEGER Tham số này chỉ định khoảng thời gian (tính bằng giây) mà thông báo sẽ được lưu trữ trong bộ nhớ FCM nếu thiết bị không có kết nối mạng
chủ đề STRING Tên của chủ đề mà thông báo đã được gửi đến (nếu có)
mã số hàng loạt INTEGER Mã nhận dạng hàng loạt xác định một nhóm thông báo có liên quan, chẳng hạn như một thông báo gửi đến một chủ đề cụ thể
sự kiện STRING Loại sự kiện. Các giá trị có thể sử dụng là:
  • MESSAGE_CONTINUE: máy chủ FCM đã nhận được thông báo và yêu cầu hợp lệ;
  • MESSAGE_DELIVERED: thông báo đã được gửi tới SDK FCM của ứng dụng trên thiết bị. Theo mặc định, trường này không được truyền. Để bật, hãy làm theo hướng dẫn trong setDeliveryMetricsExportToBigQuery(boolean).
  • MISSING_REGISTRATIONS: yêu cầu bị từ chối do thiếu thông tin đăng ký;
  • UNAUTHORIZED_REGISTRATION: thư đã bị từ chối vì người gửi không được phép gửi đến trang đăng ký;
  • MESSAGE_MESSAGE_INTERNAL_ERROR: xảy ra lỗi không xác định khi xử lý yêu cầu tin nhắn;
  • MISMATCH_SENDER_ID: yêu cầu gửi tin nhắn bị từ chối do mã nhận dạng người gửi gửi tin nhắn không khớp với mã nhận dạng được khai báo cho điểm cuối;
  • QUOTA_EXCEEDED: yêu cầu gửi tin nhắn bị từ chối do không đủ hạn mức;
  • INVALID_REGISTRATION: yêu cầu gửi tin nhắn đã bị từ chối do đăng ký không hợp lệ;
  • INVALID_PACKAGE_NAME: yêu cầu gửi thông báo bị từ chối do tên gói không hợp lệ;
  • INVALID_APNS_CREDENTIAL: yêu cầu gửi tin nhắn đã bị từ chối do chứng chỉ APNS không hợp lệ;
  • INVALID_PARAMETERS: yêu cầu gửi tin nhắn bị từ chối do các tham số không hợp lệ;
  • PAYLoad_TOO_LARGE: yêu cầu gửi tin nhắn đã bị từ chối do tải trọng lớn hơn giới hạn;
  • XÁC THỰC_ERROR: yêu cầu gửi thông báo đã bị từ chối do lỗi xác thực (kiểm tra Khoá API dùng để gửi thông báo);
  • INVALID_TTL: yêu cầu gửi tin nhắn đã bị từ chối do TTL không hợp lệ.
nhãn_phân_tích STRING Với API HTTP phiên bản 1, bạn có thể đặt nhãn phân tích khi gửi thông báo để đánh dấu thông báo đó cho mục đích phân tích

Bạn có thể làm gì với dữ liệu đã xuất?

Các phần sau đây đưa ra ví dụ về các truy vấn mà bạn có thể chạy trong BigQuery dựa trên dữ liệu FCM đã xuất.

Số lượng tin nhắn đã gửi theo ứng dụng

SELECT app_name, COUNT(1)
FROM `project ID.firebase_messaging.data`
WHERE
  _PARTITIONTIME = TIMESTAMP('date as YYYY-MM-DD')
  AND event = 'MESSAGE_ACCEPTED'
  AND message_id != ''
GROUP BY 1;

Đếm số lượng thực thể ứng dụng riêng biệt mà thông báo nhắm đến

SELECT COUNT(DISTINCT instance_id)
FROM `project ID.firebase_messaging.data`
WHERE
  _PARTITIONTIME = TIMESTAMP('date as YYYY-MM-DD')
  AND event = 'MESSAGE_ACCEPTED';

Đếm số tin nhắn thông báo đã gửi

SELECT COUNT(1)
FROM `project ID.firebase_messaging.data`
WHERE
  _PARTITIONTIME = TIMESTAMP('date as YYYY-MM-DD')
  AND event = 'MESSAGE_ACCEPTED'
  AND message_type = 'DISPLAY_NOTIFICATION';

Số lượng thông báo dữ liệu đã gửi

SELECT COUNT(1)
FROM `project ID.firebase_messaging.data`
WHERE
  _PARTITIONTIME = TIMESTAMP('date as YYYY-MM-DD')
  AND event = 'MESSAGE_ACCEPTED'
  AND message_type = 'DATA_MESSAGE';

Đếm tin nhắn được gửi đến một chủ đề hoặc chiến dịch

SELECT COUNT(1)
FROM `project ID.firebase_messaging.data`
WHERE
  _PARTITIONTIME = TIMESTAMP('date as YYYY-MM-DD')
  AND event = 'MESSAGE_ACCEPTED'
  AND bulk_id = your bulk id AND message_id != '';

Để theo dõi các sự kiện cho một thông báo được gửi đến một chủ đề cụ thể, hãy sửa đổi truy vấn này để thay thế AND message_id != '' bằng AND message_id = <your message id>;.

Tính toán thời lượng fanout cho một chủ đề hoặc chiến dịch cụ thể

Thời gian bắt đầu phân phối là thời điểm nhận được yêu cầu ban đầu và thời gian kết thúc là thời điểm tạo tin nhắn riêng lẻ cuối cùng nhắm đến một thực thể.

SELECT
  TIMESTAMP_DIFF(
    end_timestamp, start_timestamp, MILLISECOND
  ) AS fanout_duration_ms,
  end_timestamp,
  start_timestamp
FROM (
    SELECT MAX(event_timestamp) AS end_timestamp
    FROM `project ID.firebase_messaging.data`
    WHERE
      _PARTITIONTIME = TIMESTAMP('date as YYYY-MM-DD')
      AND event = 'MESSAGE_ACCEPTED'
      AND bulk_id = your bulk id
  ) sent
  CROSS JOIN (
    SELECT event_timestamp AS start_timestamp
    FROM `project ID.firebase_messaging.data`
    WHERE
      _PARTITIONTIME = TIMESTAMP('date as YYYY-MM-DD')
      AND event = 'MESSAGE_ACCEPTED'
      AND bulk_id = your bulk id
      AND message_type = 'TOPIC'
  ) initial_message;

Đếm phần trăm tin nhắn đã gửi

SELECT
  messages_sent,
  messages_delivered,
  messages_delivered / messages_sent * 100 AS percent_delivered
FROM (
    SELECT COUNT(DISTINCT CONCAT(message_id, instance_id)) AS messages_sent
    FROM `project ID.firebase_messaging.data`
    WHERE
      _PARTITIONTIME = TIMESTAMP('date as YYYY-MM-DD')
      AND event = 'MESSAGE_ACCEPTED'
  ) sent
  CROSS JOIN (
    SELECT COUNT(DISTINCT CONCAT(message_id, instance_id)) AS messages_delivered
    FROM `project ID.firebase_messaging.data`
    WHERE
      _PARTITIONTIME = TIMESTAMP('date as YYYY-MM-DD')
      AND (event = 'MESSAGE_DELIVERED'
      AND message_id
      IN (
        SELECT message_id FROM `project ID.firebase_messaging.data`
        WHERE
          _PARTITIONTIME = TIMESTAMP('date as YYYY-MM-DD')
          AND event = 'MESSAGE_ACCEPTED'
        GROUP BY 1
      )
  ) delivered;

Theo dõi tất cả các sự kiện cho một mã thông báo và mã trường hợp cụ thể

SELECT *
FROM `project ID.firebase_messaging.data`
WHERE
    _PARTITIONTIME = TIMESTAMP('date as YYYY-MM-DD')
    AND message_id = 'your message id'
    AND instance_id = 'your instance id'
ORDER BY event_timestamp;

Tính toán độ trễ cho một mã thông báo và mã thực thể nhất định

SELECT
  TIMESTAMP_DIFF(
    MAX(delivered_time), MIN(accepted_time), MILLISECOND
  ) AS latency_ms
FROM (
    SELECT event_timestamp AS accepted_time
    FROM `project ID.firebase_messaging.data`
    WHERE
      _PARTITIONTIME = TIMESTAMP('date as YYYY-MM-DD')
      AND message_id = 'your message id'
      AND instance_id = 'your instance id'
      AND event = 'MESSAGE_ACCEPTED'
  ) sent
  CROSS JOIN (
    SELECT event_timestamp AS delivered_time
    FROM `project ID.firebase_messaging.data`
    WHERE
      _PARTITIONTIME = TIMESTAMP('date as YYYY-MM-DD') AND
      message_id = 'your message id' AND instance_id = 'your instance id'
      AND (event = 'MESSAGE_DELIVERED'
  ) delivered;