> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# iOS：相关性评分

> 如何设置相关性评分

<Frame caption="图像显示选择相关性评分到晨间摘要">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b016c19-ios15-relevance-score--1.jpeg?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=847eafa58c2ed2736a448073fce1964f" width="1000" height="562" data-path="images/docs/b016c19-ios15-relevance-score--1.jpeg" />
</Frame>

Apple 的相关性评分允许您指示每个推送通知或实时活动更新的重要性。此评分帮助 iOS 确定在通知摘要（对于推送）或动态岛/锁屏（对于实时活动）中显示您的通知的突出程度。

<Frame caption="图像显示 iPhone 上用户每日摘要的设置">
  <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7bb9b21-image_7.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=3b3d0d266acc3d6c6b71bcf021573e8c" width="4000" height="2000" data-path="images/docs/7bb9b21-image_7.png" />
</Frame>

***

## 推送通知的相关性评分

相关性评分是一个从 `0.0` 到 `1.0` 的值，用于向系统表示通知的重要性。具有更高相关性评分的通知在用户的通知摘要中显示得更突出，您可以为计划投递时间配置此摘要。

1. 确保您遵循了我们的 iOS [移动端 SDK 设置](./mobile-sdk-setup) 文档来实现通知服务扩展。此扩展允许您自定义负载，包括相关性评分。

2. 在创建[推送](./push)消息时，在 iOS 选项下，指定 **相关性评分**，从 0.0（最不重要）到 1.0（最重要）。

<Warning>
  为最关键的消息保留 `1.0` 评分。过度使用高评分将导致系统忽略这种区别，使它们在摘要中混合在一起。
</Warning>

示例用例：

* 新的直接消息设置为 `1.0`
* 促销提醒设置为 `0.2`
* 每日提醒设置为 `0.6`

<Tabs>
  <Tab title="Dashboard">
    从仪表板创建消息时，您可以在 Apple iOS 平台设置下选择**相关性评分**：

    <Frame caption="Example setting the Relevance Score via the OneSignal dashboard.">
      <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/496ae2be333a38d8d276b9edc2bb34e49131afc62585fa3ac5f37bd1778bc2d6-Screenshot_2025-04-24_at_5.39.58_PM.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=e856c8437f0f103af71e692f08d0c3ad" width="1544" height="1592" data-path="images/docs/496ae2be333a38d8d276b9edc2bb34e49131afc62585fa3ac5f37bd1778bc2d6-Screenshot_2025-04-24_at_5.39.58_PM.png" />
    </Frame>
  </Tab>

  <Tab title="API">
    <ParamField path="ios_relevance_score" type="double">
      [ios\_relevance\_score](/reference/push-notification#body-ios-relevance-score) 是一个介于 0 和 1 之间的值，用于对来自您的应用的通知进行排序。最高评分的通知将在通知摘要中突出显示。
    </ParamField>

    ```bash Request theme={null}
    curl --request POST \
     --url 'https://api.onesignal.com/notifications?c=push' \
     --header 'Authorization: <authorization>' \
     --header 'Content-Type: application/json' \
     --data '{
         "app_id": "YOUR_APP_ID",
             "include_aliases": {
                 "external_id": ["EXTERNAL_ID"],
             },
             "contents": {
                 "en": "English Message"
             },
             "ios_relevance_score": 0.5
     }'
    ```
  </Tab>
</Tabs>

***

## 实时活动的相关性评分

如果您的应用启动多个实时活动，相关性评分最高的活动将优先在动态岛中显示。如果两个或更多实时活动具有相同的评分，系统将显示最早启动的活动。在锁屏上，相关性评分也决定您的应用实时活动的显示顺序。

使用我们的[更新实时活动 API](/reference/update-live-activity-api)时，将 `ios_relevance_score` 设置为 `0.0` 到 `1.0` 之间的任何 *`double`* 数据类型值。

***