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

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

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

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

خروجی داده‌های BigQuery و تب Reports در کنسول Firebase برای عملکرد به Google Analytics نیاز دارند. اگر Google Analytics برای پروژه شما فعال نیست، می‌توانید آن را در تب integrations در تنظیمات پروژه Firebase خود تنظیم کنید. Aggregated Delivery Data برای عملکرد به Google Analytics نیاز ندارد.

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

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

در تب Reports در کنسول Firebase ، می‌توانید داده‌های زیر را برای پیام‌های ارسال شده به FCM SDKهای پلتفرم اندروید یا اپل، از جمله آنهایی که از طریق آهنگساز Notifications و APIهای FCM ارسال شده‌اند، مشاهده کنید:

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

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

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

• پلتفرم (iOS یا اندروید)
• برنامه
• برچسب‌های تحلیلی سفارشی

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

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

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

• -
• ~
• %

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

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

داده‌های تحویل تجمیع‌شده با استفاده از FCM Data API

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

این API تمام داده‌های موجود برای یک برنامه‌ی کاربردی مشخص را ارائه می‌دهد. به مستندات مرجع API مراجعه کنید.

داده‌ها چگونه تجزیه و تحلیل می‌شوند؟

داده‌های تحویل بر اساس کاربرد، تاریخ و برچسب تحلیلی تفکیک می‌شوند. فراخوانی API، داده‌ها را برای هر ترکیبی از تاریخ، کاربرد و برچسب تحلیلی برمی‌گرداند. برای مثال، یک شیء 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 برای تحویل به دستگاه‌های اندروید پذیرفته شده‌اند. همه درصدها از این مقدار به عنوان مخرج استفاده می‌کنند. به خاطر داشته باشید که این تعداد شامل پیام‌هایی که برای کاربرانی که جمع‌آوری اطلاعات استفاده و تشخیصی را در دستگاه‌های خود غیرفعال کرده‌اند، ارسال شده‌اند، نمی‌شود.

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

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

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

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

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

درصدهای بینش پیام

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

این داده‌ها چه تفاوتی با داده‌هایی که به BigQuery ارسال می‌شوند، دارند؟

خروجی BigQuery، گزارش‌های پیام‌های جداگانه‌ای در مورد پذیرش پیام توسط backend FCM و تحویل پیام در SDK روی دستگاه ارائه می‌دهد (مراحل 2 و 4 معماری FCM ). این داده‌ها برای اطمینان از پذیرش و تحویل پیام‌های جداگانه مفید هستند. در بخش بعدی، درباره خروجی داده‌های BigQuery بیشتر بخوانید.

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

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

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

محدودیت‌های API

جدول زمانی داده‌های تجمیع‌شده

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

پوشش داده

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

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

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

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

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

پیام‌ها به دستگاه‌هایی با تنظیمات کاربری خاص

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

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

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

خروجی گرفتن از داده‌های BigQuery

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

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

• اندروید ۲۰.۱.۰ یا بالاتر.
• iOS 8.6.0 یا بالاتر
• فایربیس وب SDK 9.0.0 یا بالاتر

برای جزئیات بیشتر در مورد فعال کردن صادرات داده برای اندروید و iOS ، به زیر مراجعه کنید.

برای شروع، پروژه خود را به BigQuery لینک کنید:

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

   • کامپوزر Notifications را باز کنید، سپس در پایین صفحه روی Access BigQuery کلیک کنید.

   • از صفحه Integrations در کنسول Firebase ، روی Link در کارت BigQuery کلیک کنید.

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

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

برای اطلاعات بیشتر به لینک کردن فایربیس به بیگ‌کوئری مراجعه کنید.

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

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

  • شما می‌توانید به صورت دستی، پر کردن مجدد داده‌ها را تا 30 روز گذشته برنامه‌ریزی کنید .

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

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

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

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

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

دستگاه‌های iOS با FCM SDK 8.6.0 یا بالاتر می‌توانند خروجی داده‌های تحویل پیام برنامه خود را فعال کنند. FCM از خروجی داده‌ها برای هشدارها و اعلان‌های پس‌زمینه پشتیبانی می‌کند. قبل از فعال کردن این گزینه‌ها، ابتدا باید لینک FCM -BiqQuery را برای پروژه خود، همانطور که در BigQuery data export توضیح داده شده است، ایجاد کنید.

فعال کردن خروجی داده‌های تحویل برای اعلان‌های هشدار

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

برای هر اعلان دریافتی، باید فراخوانی زیر انجام شود:

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

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

اگر در حال ساخت درخواست‌های ارسال با استفاده از API HTTP نسخه ۱ هستید، حتماً mutable-content = 1 در شیء payload مشخص کنید.

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

برای پیام‌های پس‌زمینه که وقتی برنامه در پیش‌زمینه یا پس‌زمینه است دریافت می‌شوند، می‌توانید API مربوط به صادرات داده را درون کنترل‌کننده پیام داده برنامه اصلی فراخوانی کنید. این فراخوانی باید برای هر اعلان دریافتی انجام شود:

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

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

چه داده‌هایی به 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>; جایگزین کنید.

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

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

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;