# 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) 예시 이미지**

<figure><img src="https://1606198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff5XCUiUhwc0T57hW21TH%2Fuploads%2F5eT1UXB3XOPg5y2yTXR4%2F(%E1%84%80%E1%85%AA%E1%86%BC%E1%84%80%E1%85%A9)%20%E1%84%90%E1%85%B3%E1%86%A8%E1%84%87%E1%85%A7%E1%86%AF%20%E1%84%92%E1%85%A1%E1%86%AF%E1%84%8B%E1%85%B5%E1%86%AB%20%E1%84%8B%E1%85%A1%E1%86%AB%E1%84%82%E1%85%A2.jpg?alt=media&#x26;token=fb504c90-503c-4e0f-86fe-ac39bba7c2f5" alt=""><figcaption></figcaption></figure>

## 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 게시판으로 문의 주시면 빠르게 답변드리겠습니다.