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

 {
  "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 اطلاعاتی در مورد نتایج درخواست‌های پیام ارائه می‌دهند. همه دسته‌ها متقابلاً منحصر به فرد هستند. می‌تواند به سؤالاتی مانند "آیا پیام‌های من تحویل داده می‌شوند؟" و "چه چیزی باعث از دست رفتن پیام‌ها می‌شود؟" پاسخ دهد.

For example, a high value for the droppedTooManyPendingMessages field could signal that app instances are receiving volumes of non-collapsible messages exceeding FCM 's limit of 100 pending messages. To mitigate this, make sure your app handles calls to onDeletedMessages , and consider sending collapsible messages. Similarly, high percentages for droppedDeviceInactive could be a signal to update registration tokens on your server, removing stale tokens and unsubscribing them from topics. See Manage FCM registration tokens for best practices in this area.

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

The fields in the DeliveryPerformancePercents object provide information about messages that were successfully delivered. It can answer questions such as "Were my messages delayed?" and "Why are messages delayed?" For example, a high value for delayedMessageThrottled would clearly indicate that you are exceeding per-device maximum limits , and should adjust the rate at which you are sending messages.

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

This object provides additional information about all message sends. The priorityLowered field expresses the percentage of accepted messages that had priority lowered from HIGH to NORMAL . If this value is high, try sending fewer high priority messages or ensure that you always display a notification when a high priority message is sent. See our documentation on message priority for more info

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

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

By contrast, the Firebase Cloud Messaging Data API provides aggregated details about what happens specifically in the Android Transport Layer (or Step 3 of the FCM Architecture ). This data specifically provides insight into the delivery of messages from FCM backends to the Android SDK. It's particularly useful for showing trends as to why messages were delayed or dropped during this transport.

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

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

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

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

The API will return 7 days of historical data; however, data returned by this API will be delayed by up to 5 days. For example, on January 20th, the data for January 9th - January 15th would be available, but not for January 16th or later. Additionally, the data is provided at best effort. In the event of a data outage, FCM will work to fix forward and won't backfill the data after the issue is fixed. In larger outages, the data could be unavailable for a week or more.

پوشش داده

معیارهای ارائه شده توسط 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 نسخه ۱۲.۱۴.۰ یا بالاتر

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

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;