iOS: Relevance Score

A guide to relevance scores in iOS push notifications.

From iOS 15, Apple has introduced the relevance-score field for iOS push notification payloads. It is designed to be used in conjunction with the new 'Notification Summary' that can be used to group notifications received into regularly scheduled summaries. The relevance score helps the device to determine the relative importance of your notifications and display them accordingly in the summary. Note that other factors, including adding an image, will also impact the importance.

Adding Relevance Scores

Notification Builder Interface

Relevance Scores can be added when building a push notification by selecting 'Relevance Score' from the iOS Only options:

470

You can then drag the slider to select the desired relevance score in a range from 0 to 1 with an accuracy of two decimal places.

470

REST API

Relevance Scores can be added to notifications sent through our Notifications, Transactional Notifications and Messages API endpoints by using the key relevance_score with the a value between 0 and 1 inclusive. This should be added to the notification.payload field:

{
  "notification": {
    "payload": {
	    "title": "hello",
      "alert": "there",
	    "relevance_score": 0.34
    }
  }
}