درک تحویل پیام

برای عیب‌یابی کردن خطاهای تحویل پیام جاری، از عیب‌یاب FCM استفاده کنید و این پست وبلاگ را ببینید تا دلایل مختلفی را که ممکن است پیام خود را نبینید درک کنید. همچنین می‌توانید به داشبورد وضعیت FCM مراجعه کنید تا ببینید آیا اختلال سرویس جاری‌ای وجود دارد که بر FCM تأثیر بگذارد یا نه.

‫FCM همچنین سه مجموعه ابزار ارائه می‌دهد تا به شما کمک کند درباره ارزیابی کلی موفقیت و استراتژی پیام‌رسانی اطلاعات آماری کسب کنید:

• ‫Firebase گزارش تحویل پیام کنسول
• سنجه‌های تجمیعی ارائه کیت توسعه نرم‌افزار Android از Firebase Cloud Messaging Data API
• صادر کردن جامع داده‌ها به Google BigQuery

صادر کردن داده‌ها به BigQuery و برگه گزارش‌ها در کنسول Firebase هر دو برای عملکرد به Google Analytics نیاز دارند. می‌توانید Google Analytics را در settings تنظیمات > زبانه ادغام‌ها در کنسول Firebase فعال کنید. داده‌های انبوهشی تحویل برای عملکرد به Google Analytics نیاز ندارد.

به‌خاطر داشته باشید که گزارش بسیاری از آمارها در این صفحه، به‌دلیل دسته‌بندی داده‌های Analytics، ممکن است تا ۲۴ ساعت تأخیر داشته باشد.

گزارش‌های تحویل پیام

در کنسول Firebase، به برگه DevOps و تعامل > پیام‌رسانی > گزارش‌ها بروید تا داده‌های زیر را برای پیام‌های ارسال‌شده به کیت‌های توسعه نرم‌افزار FCM پلاتفرم Android یا Apple، ازجمله پیام‌های ارسال‌شده بااستفاده از سازنده اعلان‌ها و FCM API مشاهده کنید:

• ارسال‌ها — پیام داده یا پیام اعلان برای تحویل در صف قرار گرفته است یا با موفقیت به سرویس شخص ثالثی مانند APN برای تحویل منتقل شده است. توجه داشته باشید که آمار «ارسال‌ها» ممکن است چند ساعت تأخیر داشته باشد. برای اطلاعات بیشتر، طول عمر پیام را ببینید.
• دریافت‌شده (فقط در دستگاه‌های Android دردسترس است) — پیام داده یا پیام اعلان توسط برنامه دریافت شده است. این داده‌ها زمانی دردسترس است که دستگاه Android دریافت‌کننده دارای FCM SDK 18.0.1 یا بالاتر باشد.
• بازدیدها (فقط برای پیام‌های اعلان در دستگاه‌های Android دردسترس است) — اعلان نمایش در دستگاه نمایش داده شده است درحالی‌که برنامه در پس‌زمینه است.
• باز کردن — کاربر پیام اعلان را باز کرده است. فقط برای اعلان‌های دریافتی وقتی برنامه در پس‌زمینه است گزارش می‌شود.

این داده‌ها برای همه پیام‌های دارای بار اعلان و همه برچسب‌گذاری‌شده پیام‌های داده دردسترس است. برای کسب اطلاعات بیشتر درباره برچسب‌ها، افزودن برچسب‌های Analytics به پیام‌ها را ببینید.

هنگام مشاهده گزارش‌های پیام، می‌توانید محدوده تاریخی برای داده‌های نمایش‌داده‌شده تنظیم کنید، با گزینه صادر کردن به CSV. همچنین می‌توانید براساس این معیارها فیلتر کنید:

• پلاتفرم (iOS یا Android)
• برنامه
• برچسب‌های سفارشی Analytics

افزودن برچسب‌های تجزیه‌وتحلیل به پیام‌ها

برچسب‌گذاری پیام‌ها برای تجزیه‌وتحلیل سفارشی بسیار مفید است و به شما امکان می‌دهد آمار تحویل را براساس برچسب‌ها یا مجموعه‌ای از برچسب‌ها فیلتر کنید. می‌توانید با تنظیم فیلد fcmOptions.analyticsLabel در شیء پیام یا در فیلدهای مختص پلاتفرم AndroidFcmOptions یا ApnsFcmOptions، به هر پیامی که بااستفاده از HTTP v1 API ارسال می‌شود برچسب اضافه کنید.

برچسب‌های Analytics رشته‌های نوشتاری در قالب ^[a-zA-Z0-9-_.~%]{1,50}$ هستند. برچسب‌ها می‌توانند شامل حروف کوچک و بزرگ، اعداد، و نمادهای زیر باشند:

• -
• ~
• %

حداکثر طول ۵۰ نویسه است. می‌توانید حداکثر ۱۰۰ برچسب یکتا در روز مشخص کنید؛ پیام‌هایی که برچسب‌های اضافه‌شده آن‌ها از این حد فراتر رود گزارش نمی‌شوند.

در برگه گزارش‌ها پیام‌رسانی کنسول Firebase، می‌توانید فهرستی از همه برچسب‌های موجود را جستجو کنید و آن‌ها را به‌صورت تکی یا ترکیبی برای فیلتر کردن آمار نمایش‌داده‌شده اعمال کنید.

داده‌های ارائه تجمیعی بااستفاده از FCM Data API

Firebase Cloud Messaging Data API به شما امکان می‌دهد اطلاعاتی را بازیابی کنید که می‌تواند به شما کمک کند نتایج درخواست‌های پیام هدف‌یابی‌شده برای برنامه‌های Android را درک کنید. این API داده‌های تجمیعی را در همه دستگاه‌های Android که جمع‌آوری داده در آن‌ها در پروژه‌ای فعال است ارائه می‌دهد. این شامل جزئیاتی درباره درصد پیام‌های تحویل‌شده بدون تأخیر و همچنین تعداد پیام‌هایی است که در لایه انتقال Android با تأخیر مواجه شده یا حذف شده‌اند. ارزیابی این داده‌ها می‌تواند روندهای کلی در تحویل پیام را آشکار کند و به شما کمک کند راه‌های مؤثری برای بهبود عملکرد درخواست‌های ارسال خود پیدا کنید. برای اطلاعات درباره دردسترس بودن محدوده تاریخ در گزارش‌ها، خطوط زمان داده‌های تجمیعی را ببینید.

این «میانای برنامه‌سازی کاربردی» همه داده‌های دردسترس برای یک برنامه معین را ارائه می‌دهد. سند مرجع میانای برنامه‌سازی کاربردی را ببینید.

داده‌ها چگونه تفکیک می‌شود؟

داده‌های تحویل براساس برنامه، تاریخ، و برچسب Analytics تفکیک می‌شود. فراخوانی میانای برنامه‌سازی کاربردی داده‌های مربوط به هر ترکیب از تاریخ، برنامه، و برچسب تجزیه‌وتحلیل را برمی‌گرداند. برای مثال، یک شیء JSON androidDeliveryData واحد شبیه این است:

 {
  "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
    }
  }

نحوه تفسیر سنجه‌ها

داده‌های تحویل درصد پیام‌هایی را که با هریک از سنجه‌های زیر مطابقت دارند نشان می‌دهد. ممکن است یک پیام واحد با چندین معیار مطابقت داشته باشد. به‌دلیل محدودیت‌هایی که در نحوه جمع‌آوری داده‌ها و سطح جزئیاتی که سنجه‌ها را تجمیع کرده‌ایم وجود دارد، برخی‌از نتایج پیام اصلاً در سنجه‌ها نشان داده نمی‌شود، بنابراین مجموع درصدهای زیر ۱۰۰٪ نخواهد بود.

تعداد پیام‌های پذیرفته‌شده

تنها شمارش موجود در مجموعه داده، شمارش پیام‌هایی است که FCM برای ارسال به دستگاه‌های Android پذیرفته است. همه درصدها از این مقدار به‌عنوان مخرج استفاده می‌کنند. به‌خاطر داشته باشید که این تعداد شامل پیام‌هایی که برای کاربرانی که جمع‌آوری اطلاعات استفاده و عیب‌یابی را در دستگاه‌هایشان غیرفعال کرده‌اند هدف‌یابی شده‌اند نمی‌شود.

درصدهای نتیجه پیام

فیلدهای موجود در شیء MessageOutcomePercents اطلاعاتی درباره نتایج درخواست‌های پیام ارائه می‌دهند. همه دسته‌ها متقابلاً انحصاری هستند. این ابزار می‌تواند به سؤالاتی مانند «آیا پیام‌های من تحویل داده می‌شوند؟» و «چه چیزی باعث می‌شود پیام‌ها حذف شوند؟» پاسخ دهد.

برای مثال، مقدار بالای فیلد droppedTooManyPendingMessages می‌تواند نشان دهد که نمونه‌های برنامه حجم زیادی از پیام‌های غیرجمع‌شدنی دریافت می‌کنند که از حد مجاز FCM، یعنی ۱۰۰ پیام معلقه، فراتر می‌رود. برای کاهش این مشکل، مطمئن شوید برنامه‌تان تماس‌های onDeletedMessages را مدیریت می‌کند و ارسال پیام‌های جمع‌شدنی را درنظر بگیرید. به‌همین ترتیب، درصد بالای droppedDeviceInactive می‌تواند نشانه‌ای برای به‌روزرسانی نشان‌های ثبت در کارساز شما باشد، نشان‌های قدیمی را بردارید و اشتراک آن‌ها را از موضوعات لغو کنید. برای روال‌های مطلوب در این زمینه، مدیریت کردن نشان‌های ثبت FCM را ببینید.

درصدهای عملکرد تحویل

فیلدهای موجود در شیء DeliveryPerformancePercents اطلاعاتی درباره پیام‌هایی که با موفقیت تحویل داده شده‌اند ارائه می‌دهند. می‌تواند به سؤالاتی مثل «آیا پیام‌هایم با تأخیر ارسال شده است؟» و «چرا پیام‌ها با تأخیر ارسال می‌شود؟» پاسخ دهد. برای مثال، مقدار بالای delayedMessageThrottled به‌وضوح نشان می‌دهد که از حداکثر محدودیت‌های هر دستگاه فراتر رفته‌اید و باید نرخ ارسال پیام‌هایتان را اصلاح کنید.

درصدهای اطلاعات آماری پیام

این شیء اطلاعات بیشتری درباره همه ارسال‌های پیام ارائه می‌دهد. فیلد priorityLowered درصد پیام‌های پذیرفته‌شده‌ای را نشان می‌دهد که اولویت آن‌ها از HIGH به NORMAL کاهش یافته است. اگر این مقدار بالا است، سعی کنید پیام‌های با اولویت بالا کمتری ارسال کنید یا مطمئن شوید که همیشه هنگام ارسال پیام با اولویت بالا، اعلانی نمایش می‌دهید. برای اطلاعات بیشتر، اسناد ما درباره اولویت پیام را ببینید

این داده‌ها چه تفاوتی با داده‌های صادرشده به BigQuery دارد؟

صادر کردن BigQuery گزارش‌های پیام‌های تکی را درباره پذیرش پیام توسط بخش پشتی FCM و تحویل پیام در کیت توسعه نرم‌افزار (SDK) در دستگاه ارائه می‌دهد (مراحل ۲ و ۴ معماری FCM). این داده‌ها برای اطمینان از اینکه پیام‌های فردی پذیرفته و تحویل داده شده‌اند مفید است. در بخش بعدی، درباره صادر کردن داده‌های BigQuery بیشتر بخوانید.

درمقابل، «میانای برنامه‌سازی کاربردی داده Firebase Cloud Messaging» جزئیات تجمیعی درباره آنچه به‌طور خاص در «لایه انتقال Android» (یا «مرحله ۳ معماری FCM») اتفاق می‌افتد ارائه می‌دهد. این داده‌ها به‌طور خاص اطلاعاتی درباره ارسال پیام‌ها از زیرینه‌های FCM به «کیت توسعه نرم‌افزار Android» ارائه می‌دهد. این گزارش به‌ویژه برای نشان دادن روندهای مربوط به علت تأخیر یا حذف پیام‌ها درطول این انتقال مفید است.

در برخی موارد، ممکن است دو مجموعه داده به‌دلایل زیر دقیقاً باهم مطابقت نداشته باشند:

• سنجه‌های انبوهشی فقط بخشی از همه پیام‌ها را نمونه‌گیری می‌کنند
• سنجه‌های تجمیعی گرد شده‌اند
• سنجه‌های زیر آستانه حریم خصوصی را ارائه نمی‌دهیم
• بخشی از نتایج پیام به‌دلیل بهینه‌سازی‌هایی که در نحوه مدیریت حجم بالای ترافیک انجام داده‌ایم وجود ندارد.

محدودیت‌های میانای برنامه‌سازی کاربردی

خطوط زمان داده‌های تجمیعی

این API داده‌های قدیمی ۷ روزه را برمی‌گرداند؛ بااین‌حال، داده‌های برگشتی از این API تا ۵ روز تأخیر خواهد داشت. برای مثال، در ۲۰ ژانویه، داده‌های مربوط به ۹ تا ۱۵ ژانویه دردسترس خواهد بود، اما داده‌های مربوط به ۱۶ ژانویه یا بعداز آن دردسترس نخواهد بود. علاوه‌براین، داده‌ها با حداکثر تلاش ارائه می‌شود. درصورت قطعی داده، FCM برای رفع مشکل تلاش خواهد کرد و پس‌از رفع مشکل، داده‌ها را تکمیل نخواهد کرد. در قطعی‌های بزرگ‌تر، ممکن است داده‌ها برای یک هفته یا بیشتر دردسترس نباشد.

پوشش داده‌ها

سنجه‌های ارائه‌شده توسط «میانای برنامه‌سازی کاربردی داده‌های پیام‌رسانی ابری Firebase» برای ارائه اطلاعات آماری درباره گرایش‌های کلی ارسال پیام درنظر گرفته شده است. بااین‌حال، این ویژگی‌ها همه سناریوهای پیام را ۱۰۰٪ پوشش نمی‌دهند. سناریوهای زیر نتایج شناخته‌شده‌ای هستند که در سنجه‌ها منعکس نمی‌شوند.

پیام‌های منقضی‌شده

اگر زمان زنده بودن (TTL) پس‌از پایان تاریخ گزارش داده‌شده منقضی شود، پیام به‌عنوان droppedTtlExpired در این تاریخ محاسبه نخواهد شد.

پیام‌ها به دستگاه‌های غیرفعال

پیام‌های ارسال‌شده به دستگاه‌های غیرفعال ممکن است در مجموعه داده نشان داده شود یا نشود، بسته به اینکه از کدام مسیر داده عبور کنند. این امر می‌تواند منجر به شمارش اشتباه در فیلدهای droppedDeviceInactive و pending شود.

پیام‌های ارسال‌شده به دستگاه‌هایی با اولویت‌های کاربری خاص

کاربرانی که جمع‌آوری اطلاعات استفاده و تشخیص خرابی را در دستگاه‌هایشان غیرفعال کرده‌اند، پیام‌هایشان در شمارش ما لحاظ نخواهد شد تا تنظیمات برگزیده‌شان رعایت شود.

گرد کردن و حداقل‌ها

FCM عمداً تعداد را گرد می‌کند و مواردی را که حجم آن‌ها به‌اندازه کافی بزرگ نیست مستثنی می‌کند.

صادر کردن داده‌های BigQuery

می‌توانید داده‌های پیامتان را برای تجزیه‌وتحلیل بیشتر به BigQuery صادر کنید. ‫BigQuery به شما امکان می‌دهد داده‌ها را بااستفاده از BigQuery SQL تجزیه‌وتحلیل کنید، آن را به ارائه‌دهنده فضای ابری دیگری صادر کنید، یا از داده‌ها برای مدل‌های سفارشی ML خود استفاده کنید. صادر کردن به BigQuery شامل همه داده‌های دردسترس برای پیام‌ها است، صرف‌نظر از نوع پیام یا اینکه پیام بااستفاده از API یا «سازنده اعلان‌ها» ارسال شده باشد.

برای پیام‌های ارسال‌شده به دستگاه‌هایی با حداقل نسخه‌های کیت توسعه نرم‌افزار FCM زیر، گزینه دیگری برای فعال کردن صادر کردن داده‌های تحویل پیام برای برنامه‌تان دارید:

• ‫Android نسخه ۲۰.۱.۰ یا بالاتر.
• ‫iOS نسخه ۸.۶.۰ یا بالاتر
• کیت توسعه نرم‌افزار Firebase Web نسخه ۱۲.۱۴.۰ یا بالاتر

برای شروع، پروژه‌تان را بااستفاده از کنسول Firebase به BigQuery پیوند دهید:

1. یکی از گزینه‌های زیر را انتخاب کنید:

   • به DevOps و تعامل > پیام‌رسانی > ترکیب‌کننده اعلان‌ها بروید، سپس در پایین صفحه روی دسترسی به BigQuery کلیک کنید.

   • به زبانه settings تنظیمات > ادغام‌ها بروید. سپس در BigQuery، روی پیوند کلیک کنید.

     این صفحه FCM گزینه برون‌برد برای همه برنامه‌های فعال‌شده با FCM در پروژه را نمایش می‌دهد.

2. برای فعال کردن BigQuery، دستورالعمل‌های روی صفحه را دنبال کنید.

برای اطلاعات بیشتر، به پیوند دادن Firebase به BigQuery مراجعه کنید.

وقتی برون‌برد BigQuery را برای Cloud Messaging فعال می‌کنید:

• Firebase داده‌هایتان را به BigQuery صادر می‌کند. توجه داشته باشید که انتشار اولیه داده‌ها برای برون‌برد ممکن است تا ۴۸ ساعت طول بکشد تا تکمیل شود.

  • می‌توانید داده‌های گذشته را به‌صورت دستی زمان‌بندی کنید تا ۳۰ روز گذشته.

• پس‌از ایجاد مجموعه داده، مکان آن را نمی‌توانید تغییر دهید، اما می‌توانید مجموعه داده را در مکان دیگری کپی کنید یا مجموعه داده را به‌صورت دستی در مکان دیگری منتقل (بازسازی) کنید. برای کسب اطلاعات بیشتر، تغییر مکان مجموعه داده را ببینید.

• Firebase همگام‌سازی‌های منظمی را برای داده‌هایتان از پروژه Firebase به BigQuery راه‌اندازی می‌کند. این عملیات‌های برون‌برد روزانه در ساعت ۴:۰۰ صبح به‌وقت اقیانوسیه شروع می‌شود و معمولاً ظرف ۲۴ ساعت به‌پایان می‌رسد.

• به‌طور پیش‌فرض، همه برنامه‌های موجود در پروژه‌تان به BigQuery پیوند داده می‌شوند و هر برنامه‌ای که بعداً به پروژه اضافه کنید به‌طور خودکار به BigQuery پیوند داده می‌شود. می‌توانید مدیریت کنید کدام برنامه‌ها داده ارسال کنند.

برای غیرفعال کردن برون‌برد BigQuery، پیوند پروژه خود را لغو کنید در کنسول Firebase.

فعال کردن صادر کردن داده‌های تحویل پیام

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

// 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

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

// 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

FirebaseMessaging.getInstance().setDeliveryMetricsExportToBigQuery(true);

<application>
  <meta-data android:name="delivery_metrics_exported_to_big_query_enabled"
      android:value="true" />
</application>

// userConsent holds the decision of the user to give big query export consent.
const userConsent = ...;

const messaging = getMessagingInSw(app);

experimentalSetDeliveryMetricsExportedToBigQueryEnabled(messaging, userConsent);

چه داده‌هایی به BigQuery صادر می‌شود؟

توجه داشته باشید که هدف‌یابی کردن نشانه‌های قدیمی یا ثبت‌های غیرفعال ممکن است برخی‌از این آمارها را افزایش دهد.

طرح جدول صادرشده عبارت است از:

با داده‌های صادرشده چه کاری می‌توانید انجام دهید؟

بخش‌های زیر نمونه‌هایی از پُرسمان‌هایی را ارائه می‌دهند که می‌توانید در BigQuery درمقابل داده‌های صادرشده FCM اجرا کنید.

تعداد پیام‌های ارسال‌شده براساس برنامه

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;

تعداد نمونه‌های برنامه منحصربه‌فرد هدف‌یابی‌شده توسط پیام‌ها

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

تعداد پیام‌های اعلان ارسال‌شده

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';

تعداد پیام‌های داده ارسالی

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';

شمارش پیام‌های ارسال‌شده به موضوع یا پویش

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 != '';

برای ردیابی رویدادهای پیامی که به موضوع خاصی ارسال شده است، این پُرسمان را تغییر دهید تا AND message_id != '' با AND message_id = <your message id>; جایگزین شود.

محاسبه مدت‌زمان توزیع برای موضوع یا پویشی خاص

زمان شروع توزیع همگانی زمانی است که درخواست اصلی دریافت می‌شود و زمان پایان زمانی است که آخرین پیام شخصی که یک نمونه را هدف قرار می‌دهد ایجاد می‌شود.

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;

درصد تعداد پیام‌های تحویل‌شده

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;

پیگیری همه رویدادها برای شناسه پیام و شناسه نمونه معین

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;

محاسبه تأخیر برای شناسه پیام و شناسه نمونه داده‌شده

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;