> ## 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="이미지는 Morning Summary로의 관련성 점수 선택을 보여줍니다">
  <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의 관련성 점수를 사용하면 각 푸시 알림 또는 Live Activity 업데이트의 중요도를 나타낼 수 있습니다. 이 점수는 iOS가 알림 요약(푸시의 경우) 또는 Dynamic Island/잠금 화면(Live Activities의 경우)에서 알림을 얼마나 눈에 띄게 표시할지 결정하는 데 도움이 됩니다.

<Frame caption="이미지. iPhone에서 Daily Summary에 대한 사용자 설정을 보여줍니다">
  <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. Notification Service Extension을 구현하는 iOS용 [Mobile SDK 설정](./mobile-sdk-setup) 문서를 따랐는지 확인하세요. 이 확장 프로그램을 사용하면 관련성 점수를 포함한 페이로드를 사용자 정의할 수 있습니다.

2. [Push](./push) 메시지를 생성할 때 iOS 옵션 아래에서 **관련성 점수**를 0.0(가장 중요하지 않음)에서 1.0(가장 중요함)까지 지정하세요.

<Warning>
  가장 중요한 메시지를 위해 `1.0` 점수를 예약하세요. 높은 점수를 과도하게 사용하면 시스템이 구분을 무시하여 요약에서 모두 혼합됩니다.
</Warning>

예시 사용 사례:

* 새 Direct Messages를 `1.0`으로 설정
* 프로모션 알림을 `0.2`로 설정
* 일일 리마인더를 `0.6`으로 설정

<Tabs>
  <Tab title="대시보드">
    대시보드에서 메시지를 생성할 때 Apple iOS 플랫폼 설정 아래에서 **관련성 점수**를 선택할 수 있습니다:

    <Frame caption="OneSignal 대시보드를 통해 관련성 점수를 설정하는 예시.">
      <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>

***

## Live Activities에 대한 관련성 점수

앱이 여러 Live Activities를 시작하는 경우 가장 높은 relevanceScore를 가진 것이 Dynamic Island에 표시되도록 우선순위가 지정됩니다. 두 개 이상의 Live Activities가 동일한 점수를 공유하는 경우 시스템은 가장 먼저 시작된 활동을 표시합니다. 잠금 화면에서 relevanceScore는 앱의 Live Activities 표시 순서도 결정합니다.

[Update Live Activity API](/reference/update-live-activity-api)를 사용할 때 `ios_relevance_score`를 `0.0`과 `1.0` 사이의 *`double`* 데이터 유형 값으로 설정하세요.

***