הסבר על מסירת הודעות

כדי לפתור בעיות שקשורות לשיבוש בהעברת הודעות, אפשר להשתמש בפותר הבעיות של FCM ולעיין בפוסט הזה בבלוג כדי להבין את הסיבות השונות לכך שההודעה לא מוצגת. אפשר גם להיכנס ללוח הבקרה של סטטוס FCM כדי לבדוק אם יש שיבושים בשירות שמשפיעים על FCM.

בנוסף, FCM מספק שלוש קבוצות של כלים שיעזרו לכם לקבל תובנות לגבי הערכה רחבה של הצלחת העברת ההודעות והאסטרטגיה:

• דוחות מסירת הודעות במסוף Firebase
• מדדים מצטברים של מסירת Android SDK מ-Firebase Cloud Messaging Data API
• ייצוא נתונים מקיף ל-Google BigQuery

כדי לייצא נתונים אל BigQuery וגם כדי להשתמש בכרטיסייה Reports במסוף Firebase, צריך את ההרשאה Google Analytics. אפשר להפעיל את Google Analytics בsettings הגדרות > בכרטיסייה שילובים במסוף Firebase. נתוני משלוח מצטברים לא מחייבים את Google Analytics כדי לפעול.

חשוב לזכור שהדיווח על הרבה מהנתונים הסטטיסטיים בדף הזה עשוי להתעכב עד 24 שעות בגלל אצווה של נתוני ניתוח.

דוחות מסירת הודעות

במסוף Firebase, עוברים אל DevOps & Engagement (פיתוח אפליקציות ואינטראקציה עם משתמשים) > Messaging (העברת הודעות) > הכרטיסייה Reports (דוחות) כדי לראות את הנתונים הבאים לגבי הודעות שנשלחו לערכות SDK של FCM בפלטפורמות Android או Apple, כולל הודעות שנשלחו באמצעות הכלי ליצירת הודעות ו-API של FCM:

• נשלח – הודעת הנתונים או הודעת ההתראה הוכנסה לתור למסירה או הועברה בהצלחה לשירות של צד שלישי כמו APNs למסירה. שימו לב: יכול להיות עיכוב של כמה שעות בנתונים הסטטיסטיים של השליחות. מידע נוסף זמין במאמר בנושא משך החיים של הודעה.
• התקבלה (זמין רק במכשירי Android) – הודעת הנתונים או הודעת ההתראה התקבלו באפליקציה. הנתונים האלה זמינים אם במכשיר Android המקבל מותקן FCM SDK בגרסה 18.0.1 ומעלה.
• חשיפות (זמין רק להודעות התראה במכשירי Android) – התראת התצוגה הוצגה במכשיר כשהאפליקציה פועלת ברקע.
• פתיחות – המשתמש פתח את הודעת ההתראה. הנתונים האלה מדווחים רק לגבי התראות שהתקבלו כשהאפליקציה פועלת ברקע.

הנתונים האלה זמינים לכל ההודעות עם מטען ייעודי (payload) של התראות ולכל הודעות הנתונים המתויגות. מידע נוסף על תוויות זמין במאמר הוספת תוויות של ניתוח נתונים להודעות.

כשאתם צופים בדוחות על סמסים, אתם יכולים להגדיר טווח תאריכים לנתונים שמוצגים, ולייצא אותם לקובץ CSV. אפשר גם לסנן לפי הקריטריונים הבאים:

• פלטפורמה (iOS או Android)
• אפליקציה
• תוויות מותאמות אישית של ניתוח נתונים

הוספת תוויות של Analytics להודעות

הוספת תוויות להודעות שימושית מאוד לניתוח בהתאמה אישית, ומאפשרת לסנן את נתוני המסירה לפי תוויות או לפי קבוצות של תוויות. אפשר להוסיף תווית לכל הודעה שנשלחת באמצעות HTTP v1 API על ידי הגדרת השדה fcmOptions.analyticsLabel באובייקט message או בשדות AndroidFcmOptions או ApnsFcmOptions הספציפיים לפלטפורמה.

תוויות של Analytics הן מחרוזות טקסט בפורמט ^[a-zA-Z0-9-_.~%]{1,50}$. התוויות יכולות לכלול אותיות קטנות וגדולות, מספרים ואת הסמלים הבאים:

• -
• ~
• %

האורך המקסימלי הוא 50 תווים. אפשר לציין עד 100 תוויות ייחודיות ביום. הודעות עם תוויות שנוספו מעבר למגבלה הזו לא מדווחות.

בכרטיסייה Reports של העברת ההודעות במסוף Firebase, אתם יכולים לחפש ברשימה של כל התוויות הקיימות ולהחיל אותן בנפרד או בשילוב כדי לסנן את הנתונים הסטטיסטיים שמוצגים.

נתוני משלוח מצטברים באמצעות FCM Data API

באמצעות Firebase Cloud Messaging Data API אתם יכולים לאחזר מידע שיעזור לכם להבין את התוצאות של בקשות להעברת הודעות שמטורגטות לאפליקציות ל-Android. ממשק ה-API מספק נתונים מצטברים מכל מכשירי Android שמופעל בהם איסוף נתונים בפרויקט. הנתונים האלה כוללים את אחוז ההודעות שנמסרו ללא עיכוב, וגם את מספר ההודעות שהתעכבו או נמחקו בשכבת התעבורה של Android. הערכת הנתונים האלה יכולה לחשוף מגמות רחבות במסירת ההודעות, ולעזור לכם למצוא דרכים יעילות לשפר את הביצועים של בקשות השליחה. במאמר ציר הזמן של נתונים נצברים מוסבר על הזמינות של טווחי תאריכים בדוחות.

ה-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
    }
  }

איך מפרשים את המדדים

נתוני המסירה מציגים את אחוז ההודעות שמתאימות לכל אחד מהמדדים הבאים. יכול להיות שהודעה אחת תתאים לכמה מדדים. בגלל מגבלות באופן שבו אנחנו אוספים את הנתונים וברמת הפירוט שבה צברנו את המדדים, חלק מתוצאות ההודעות לא מיוצגות במדדים בכלל, ולכן סכום האחוזים שמוצג בהמשך לא יהיה 100%.

מספר ההודעות שהתקבלו

הספירה היחידה שנכללת במערך הנתונים היא מספר ההודעות ש-FCM קיבל כדי לשלוח למכשירי Android. כל האחוזים מחושבים על סמך הערך הזה כמכנה. חשוב לזכור שהספירה הזו לא כוללת הודעות שמיועדות למשתמשים שהשביתו במכשירים שלהם את איסוף המידע על דפוסי השימוש והביצועים.

אחוזי התוצאות של ההודעות

השדות שנכללים באובייקט MessageOutcomePercents מספקים מידע על התוצאות של בקשות להודעות. כל הקטגוריות הן ייחודיות. הוא יכול לענות על שאלות כמו "האם ההודעות שלי נמסרות?" ו "מה גורם להודעות להימחק?".

לדוגמה, ערך גבוה בשדה droppedTooManyPendingMessages יכול להצביע על כך שמופעים של אפליקציות מקבלים נפחים של הודעות שלא ניתן לכווץ שחורגים מהמגבלה של FCM של 100 הודעות בהמתנה. כדי למנוע את זה, ודאו שהאפליקציה מטפלת בקריאות ל-onDeletedMessages, ושקלו לשלוח הודעות שניתן לכווץ. באופן דומה, אחוזים גבוהים של droppedDeviceInactive יכולים להצביע על הצורך לעדכן את טוקני הרישום בשרת, להסיר טוקנים לא פעילים ולבטל את ההרשמה שלהם לנושאים. במאמר ניהול טוקנים של רישום FCM מפורטות שיטות מומלצות בנושא.

אחוזי ביצועי המסירה

השדות באובייקט DeliveryPerformancePercents מספקים מידע על הודעות שנמסרו בהצלחה. הוא יכול לענות על שאלות כמו "האם ההודעות שלי התעכבו?" ו"למה ההודעות מתעכבות?". לדוגמה, ערך גבוה של delayedMessageThrottled מציין בבירור שאתם חורגים מהמגבלות המקסימליות לכל מכשיר, ושאתם צריכים לשנות את קצב שליחת ההודעות.

אחוזים בתובנות לגבי הודעות

האובייקט הזה מספק מידע נוסף על כל שליחת הודעה. השדה priorityLowered מבטא את אחוז ההודעות שהתקבלו, שהעדיפות שלהן ירדה מ-HIGH ל-NORMAL. אם הערך הזה גבוה, כדאי לנסות לשלוח פחות הודעות בעדיפות גבוהה או לוודא שתמיד מוצגת התראה כשנשלחת הודעה בעדיפות גבוהה. מידע נוסף על עדיפות ההודעות

מה ההבדל בין הנתונים האלה לבין הנתונים שמיוצאים ל-BigQuery?

הייצוא ל-BigQuery מספק יומני הודעות ספציפיות לגבי קבלת ההודעות על ידי הקצה העורפי של FCM ומסירת ההודעות ב-SDK במכשיר (שלבים 2 ו-4 בארכיטקטורת FCM). הנתונים האלה שימושיים כדי לוודא שהודעות ספציפיות התקבלו ונמסרו. בקטע הבא מוסבר על ייצוא נתונים ב-BigQuery.

לעומת זאת, Firebase Cloud Messaging Data API מספק פרטים נצברים על מה שקורה ספציפית בשכבת התעבורה של Android (או שלב 3 בארכיטקטורת FCM). הנתונים האלה מספקים תובנות ספציפיות לגבי מסירת ההודעות מהקצה העורפי של FCM אל Android SDK. האפשרות הזו שימושית במיוחד כדי להראות מגמות לגבי הסיבות לעיכוב או להשמטה של הודעות במהלך ההעברה.

במקרים מסוימים, יכול להיות ששתי קבוצות הנתונים לא יהיו זהות לחלוטין מהסיבות הבאות:

• המדדים המצטברים דוגמים רק חלק מכל ההודעות
• המדדים המצטברים מעוגלים
• אנחנו לא מציגים מדדים מתחת לסף הפרטיות
• חלק מהתוצאות של ההודעות חסרות בגלל אופטימיזציות באופן שבו אנחנו מנהלים את הנפח הגדול של התנועה.

מגבלות ה-API

צירי זמן של נתונים נצברים

ה-API יחזיר נתונים היסטוריים של 7 ימים, אבל הנתונים שיוחזרו על ידי ה-API הזה יתעכבו עד 5 ימים. לדוגמה, ב-20 בינואר, הנתונים מ-9 בינואר עד 15 בינואר יהיו זמינים, אבל לא הנתונים מ-16 בינואר ואילך. בנוסף, הנתונים מסופקים כמיטב יכולתנו. במקרה של הפסקה באיסוף הנתונים, FCM יפעל כדי לתקן את הבעיה ולא ימלא את הנתונים החסרים אחרי שהבעיה תתוקן. בהפסקות שירות ארוכות יותר, יכול להיות שהנתונים לא יהיו זמינים במשך שבוע או יותר.

כיסוי נתונים

המדדים שמוצגים ב-Firebase Cloud Messaging Data API נועדו לספק תובנות לגבי מגמות כלליות של מסירת הודעות. עם זאת, הם לא מספקים כיסוי של 100% לכל התרחישים של ההודעות. אלה התרחישים שבהם התוצאות לא משתקפות במדדים:

הודעות שפג תוקפן

אם אורך החיים (TTL) פג אחרי סוף תאריך היומן הנתון, ההודעה לא תיספר כ-droppedTtlExpired בתאריך הזה.

הודעות למכשירים לא פעילים

הודעות שנשלחות למכשירים לא פעילים עשויות להופיע במערך הנתונים או לא להופיע בו, בהתאם לנתיב הנתונים שהן עוברות. זה יכול לגרום לספירה שגויה בשדות droppedDeviceInactive ו-pending.

הודעות למכשירים עם העדפות משתמש מסוימות

בהתאם להעדפות של המשתמשים, אם הם השביתו את האיסוף של דפוסי שימוש וביצועים במכשירים שלהם, ההודעות שלהם לא ייכללו בספירה שלנו.

עיגול ומינימום

מערכת FCM מעגלת בכוונה את הספירות ומוציאה אותן מהדוח אם הנפחים לא גדולים מספיק.

ייצוא נתונים ל-BigQuery

אתם יכולים לייצא את נתוני ההודעות אל BigQuery כדי לנתח אותם לעומק. ב-BigQuery אתם יכולים לנתח את הנתונים באמצעות BigQuery SQL, לייצא אותם לספק שירותי ענן אחר או להשתמש בהם במודלים של למידת מכונה בהתאמה אישית. הייצוא ל-BigQuery כולל את כל הנתונים הזמינים של ההודעות, בלי קשר לסוג ההודעה או אם ההודעה נשלחה באמצעות ה-API או באמצעות הכלי ליצירת התראות.

אם ההודעות נשלחות למכשירים שמותקנות בהם גרסאות ה-SDK המינימליות הבאות של FCM, יש לכם אפשרות נוספת להפעיל את הייצוא של נתוני מסירת ההודעות באפליקציה:

• ‫Android מגרסה 20.1.0 ואילך.
• ‫iOS מגרסה 8.6.0 ואילך
• ‫Firebase Web SDK מגרסה 12.14.0 ואילך

כדי להתחיל, מקשרים את הפרויקט ל-BigQuery באמצעות מסוף Firebase:

1. בחר אחת מהאפשרויות הבאות:

   • עוברים אל DevOps & Engagement > Messaging > the Notifications composer, ואז לוחצים על Access BigQuery בתחתית הדף.

   • עוברים אל settings הגדרות > הכרטיסייה שילובים. ואז לוחצים על קישור ב-BigQuery.

     בדף הזה מוצגות אפשרויות הייצוא של FCM לכל האפליקציות בפרויקט שמופעל בהן FCM.

2. פועלים לפי ההוראות במסך כדי להפעיל את BigQuery.

מידע נוסף זמין במאמר קישור בין Firebase ל-BigQuery.

כשמפעילים ייצוא של BigQuery ל-Cloud Messaging:

• מערכת Firebase מייצאת את הנתונים אל BigQuery. הערה: יכול להיות שיחלפו עד 48 שעות עד שהנתונים יתפשטו ויהיו זמינים לייצוא.

  • אפשר לתזמן באופן ידני השלמת חוסר בנתונים (data backfill) עד 30 ימים אחורה.

• אי אפשר לשנות את המיקום אחרי שיוצרים את קבוצת הנתונים, אבל אפשר להעתיק את קבוצת הנתונים למיקום אחר או להעביר ידנית את קבוצת הנתונים למיקום אחר (ליצור אותה מחדש). למידע נוסף, קראו את המאמר שינוי המיקום של מערך הנתונים.

• מערכת Firebase מגדירה סנכרונים קבועים של הנתונים מהפרויקט ב-Firebase אל BigQuery. פעולות הייצוא היומיות האלה מתחילות בשעה 4:00 לפי שעון החוף המערבי בארה"ב, ובדרך כלל מסתיימות תוך 24 שעות.

• כברירת מחדל, כל האפליקציות בפרויקט מקושרות אל 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;