배지 설정

참고

Cordova 또는 React Native 플러그인에 대한 배지를 설정하려면 해당 가이드를 참조하십시오:

• Cordova용 배지
• React Native용 배지

Pushwoosh iOS SDK 버전 6.4.0부터 푸시 알림을 통해 배지를 관리하고 설정하는 프로세스가 변경되었습니다.

이전에 애플리케이션에서 수신된 푸시 알림 수를 나타내기 위해 배지 번호를 사용했다면, 최신 버전의 iOS SDK(6.4.0 이상)로 마이그레이션해야 합니다. 이전 버전은 2022년 2분기 말까지 지원됩니다.

배지 값을 결정하는 요소

배지는 항상 푸시 자체에서 옵니다. Pushwoosh 기능은 자체적으로 배지를 설정하거나 지우지 않습니다. /createMessage 요청에서 "ios_badges"를 보내거나(또는 Control Panel의 badges 필드) iOS 페이로드에 aps.badge(절대값)와 aps.pw_badge(상대적 델타)를 모두 설정합니다. Android는 pw_badges에 해당하는 값을 전달하며, 지원되는 런처에 이를 적용하려면 com.pushwoosh:pushwoosh-badge 모듈이 필요합니다. 푸시를 Message Inbox에 저장해도 배지가 설정되거나 변경되지 않습니다. 이 둘은 동일한 푸시의 독립적인 효과입니다.

주의

상대적인 +1/-1 배지 값은 Notification Service Extension에 의해서만 적용되며, 아래 설명된 대로 일치하는 App Group으로 설치 및 구성된 경우에만 적용됩니다. 이 설정이 없으면 OS는 페이로드의 절대 aps.badge 값을 그대로 적용합니다. 자동 증가는 없습니다.

배지 설정 방법

배지를 설정하려면 아래 단계를 따르십시오:

1. Notification Service Extension을 추가합니다 (File -> New -> Target…)

2. “Notification Service Extension”을 선택합니다

3. 생성된 NotificationService 클래스를 PushwooshNotificationServiceExtension의 서브클래스로 교체합니다. Pushwoosh가 배지 계산, 전송 이벤트, 첨부 파일 다운로드 및 타임아웃 폴백을 처리합니다:

Swift

import PushwooshFramework

class NotificationService: PushwooshNotificationServiceExtension {}

Objective-C

#import <PushwooshFramework/PushwooshFramework.h>

@interface NotificationService : PushwooshNotificationServiceExtension
@end

@implementation NotificationService
@end

4. 두 타겟(메인 앱과 Notification Service Extension)에 App Groups 기능을 추가하고 각각에 동일한 App Group을 사용합니다.

5. 메인 앱의 info.plist에 App Group ID를 추가합니다:

<key>PW_APP_GROUPS_NAME</key>
<string>group.com.example.demoapp_example</string>

확장 프로그램은 호스트 앱에서 이 값을 상속받으므로 확장 프로그램의 info.plist에 반복해서 추가할 필요가 없습니다. 호스트 값을 재정의할 때만 추가하십시오.

info.plist 파일을 사용하지 않으려면 NotificationServiceExtension 클래스에서 pushwooshAppGroupsName을 재정의하여 코드에서 App Group을 제공하십시오:

Swift

override func pushwooshAppGroupsName() -> String? {
    "group.com.example.demoapp_example"
}

Objective-C

- (NSString *)pushwooshAppGroupsName {
    return @"group.com.example.demoapp_example";
}

예제

배지가 포함된 푸시 알림 보내기

Pushwoosh Control Panel에서 배지가 포함된 푸시 알림을 보내려면 아래 그림과 같이 badges 텍스트 필드에 원하는 배지 값을 추가하기만 하면 됩니다:

참고

배지를 올바르게 보내려면 다음 값 형식을 사용할 수 있습니다: +1, -1 또는 5. 배지 값을 증가시키려면 ”+” 기호를 사용하고, 배지를 감소시키려면 ”-” 기호를 사용하십시오. 기호 없이 5와 같이 정확한 숫자를 설정할 수도 있습니다.

피드백을 공유해주세요

여러분의 피드백은 더 나은 경험을 만드는 데 도움이 되므로 SDK 통합 과정에서 문제가 발생하면 언제든지 의견을 들려주시기 바랍니다. 어려움이 있으시면 주저하지 마시고 이 양식을 통해 의견을 공유해 주세요.