iOS 푸시 알림 원클릭 수신거부 구현 가이드 (category이용)

안녕하세요, 핑거푸시 기술지원팀입니다. 광고성 정보가 포함된 푸시 메시지 발송 시, 사용자 편의성을 높이고 규정을 준수하기 위해 알림 창에서 즉시 수신거부를 할 수 있는 '원클릭 수신거부' 기능 구현 방법을 안내해 드립니다.

1. 개요

기존 핑거푸시의 기본 category 값은 "fp"입니다. 앞으로 핑거푸시에서 메세지 발송 시 광고성 메세지 옵션을 On(광고 수신 동의자)으로 발송되는 메시지의 경우 payload의 항목 category 값이 “fp1”으로 설정되어 발송됩니다.

앱 내에서 fp1 카테고리에 대한 액션(수신거부 버튼)을 미리 등록하면, 사용자가 알림을 길게 누르거나 아래로 당겼을 때 수신거부 버튼이 노출할 수 있게 구현 가능합니다.

2. 주요 설정 내용

• 대상 카테고리: fp1

• 추가 액션: 수신거부 (Unsubscribe)

• 작동 방식: 사용자가 수신거부 버튼 클릭 시 별도의 앱 실행이 실행 되면서 핑거푸시 SDK내의 광고수신 동의 설정 API requestSetAdPushEnable 호출

3. 단계별 구현 방법 예제

1) 알림 카테고리 및 액션 등록 AppDelegate 또는 알림 관리를 담당하는 클래스에서 UNNotificationCategory를 등록해야 합니다. fp1이라는 식별자를 가진 카테고리에 '수신거부' 액션을 추가합니다.

//Swift
import UserNotifications

func registerNotificationCategories() {
    // 1. 수신거부 버튼(액션) 정의
    let unsubscribeAction = UNNotificationAction(
        identifier: "UNSUBSCRIBE_ACTION",
        title: "원클릭 수신거부",
        options: [.authenticationRequired, .destructive] // 인증 필요 및 붉은색 표시(선택)
    )

    // 2. "fp1" 카테고리에 액션 등록
    let adCategory = UNNotificationCategory(
        identifier: "fp1",
        actions: [unsubscribeAction],
        intentIdentifiers: [],
        options: .customDismissAction
    )

    // 3. 시스템에 카테고리 등록
    UNUserNotificationCenter.current().setNotificationCategories([adCategory])
}

2) 액션 이벤트 처리 (수신거부 로직) 사용자가 '원클릭 수신거부' 버튼을 눌렀을 때 실행될 로직을 작성합니다. 이 시점에 핑거푸시 API 또는 귀사의 수신거부 처리 서버 API를 호출해야 합니다.

//Swift
extension AppDelegate: UNUserNotificationCenterDelegate {
    func userNotificationCenter(_ center: UNUserNotificationCenter,
                                didReceive response: UNNotificationResponse,
                                withCompletionHandler completionHandler: @escaping () -> Void) {
        
        // 사용자가 누른 액션의 식별자 확인
        if response.actionIdentifier == "UNSUBSCRIBE_ACTION" {
            // TODO: 핑거푸시 수신거부 API 호출 
        finger.sharedData()?.requestSetAdPushEnable(false, { (posts, error) -> Void in
          
        })
        
            print("사용자가 수신거부를 선택했습니다.")
        }
        
        completionHandler()
    }
}

3) 예시 이미지

4. APNs 페이로드 예시

핑거푸시 서버에서 광고성 메시지 발송 시 전달되는 페이로드 구조는 다음과 같습니다.

//JSON
{
    "aps": {
        "alert": {
            "title": "(광고) 특별 할인 안내",
            "body": "지금 바로 확인해보세요!"
        },
        "category": "fp1",
        "mutable-content": 1,
        sound = default
    },
    code = "CD:0;IM:1;WL:1;PT:DEFT",
    msgTag = 53,
    src = fp,
    labelCode = "",
    weblink = "http://www.fingerpush.com/"
    ....
}

5. 주의사항

• 카테고리 매칭: 반드시 category 값이 fp1인 경우에만 해당 버튼이 노출됩니다. 기존 fp 값인 경우에는 일반 노티피케이션으로 동작합니다.

• 버튼 노출: iOS 정책상 알림을 롱터치(3D Touch)하거나 하단으로 드래그해야 버튼이 노출될 수 있습니다.

• API 연동: 수신거부 버튼 클릭 시 반드시 실제 수신거부 처리가 서버(핑거푸시 DB)에 반영되도록 광고수신거부API(requestSetAdPushEnable) 연동을 완료해 주세요.

도움이 필요하신가요? 구현 중 문의사항이 있으시면 핑거푸시 QnA 게시판으로 문의 주시면 빠르게 답변드리겠습니다.