푸시 스토리

필수 조건

이 기능을 사용하려면 먼저 Swift Braze SDK를 통합해야 합니다. 또한 푸시 알림을 설정해야 하며, 여기에는 프레임워크UNNotification 구현이 포함됩니다.

푸시 스토리를 수신하려면 다음 최소 소프트웨어 개발 키트 버전이 필요합니다:

푸시 스토리 설정

1단계: 알림 콘텐츠 확장 대상 추가

앱 프로젝트에서 메뉴 파일 > 새로 만들기 > 타겟로 이동하여 새 Notification Content Extension 타겟을 추가하고 활성화하세요.

Xcode가 새 대상을 자동으로 생성하고 다음을 포함하여 파일을 자동으로 생성합니다.

• NotificationViewController.swift
• MainInterface.storyboard

2단계: 기능 활성화

Xcode에서 메인 앱 타깃에 서명&기능 패널을 사용하여 배경 모드 기능을 추가하십시오. 백그라운드 가져오기 및 원격 알림 체크박스를 모두 선택합니다.

앱 그룹 추가

또한 Xcode의 ‘서명&기능’ 패널에서 메인 앱 타깃과 알림 콘텐츠 확장 타깃에 앱 그룹 기능을 추가하십시오. 그런 다음 + 버튼을 클릭합니다. 앱의 번들 ID를 사용하여 앱 그룹을 만드십시오. 예를 들어 앱의 번들 ID가 com.company.appname인 경우 앱 그룹 이름을 group.com.company.appname.xyz로 지정할 수 있습니다.

앱을 앱 그룹에 추가하지 않으면 푸시 페이로드에서 특정 필드를 채우지 못하고 예상대로 완전히 작동하지 않을 수 있습니다.

3단계: 앱 {#enable-capabilities}에 푸시 스토리 프레임워크 추가

• swift package manager
• cocoapods
• manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
target 'YourAppTarget' do
pod 'BrazeKit'
pod 'BrazeUI'
pod 'BrazeLocation'
end

target 'YourNotificationContentExtensionTarget' do
pod 'BrazePushStory'
end

# Only include the below if you want to also integrate Rich Push
target 'YourNotificationServiceExtensionTarget' do
pod 'BrazeNotificationService'
end

4단계: 알림 보기 컨트롤러 업데이트

NotificationViewController.swift에서 헤더 파일을 가져오도록 다음 줄을 추가합니다.

1
import BrazePushStory

다음으로, BrazePushStory.NotificationViewController를 상속하여 기본 구현을 대체합니다.

1
class NotificationViewController: BrazePushStory.NotificationViewController {}

커스텀 처리 푸시 스토리 이벤트

푸시 스토리 알림 이벤트를 처리하기 위해 자체 커스텀 로직을 구현하려면 위와 같이 BrazePushStory.NotificationViewController을(를) 상속하고 아래와 같이 didReceive 메서드를 재정의하십시오.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
import BrazePushStory
import UserNotifications
import UserNotificationsUI

class NotificationViewController: BrazePushStory.NotificationViewController {
  override func didReceive(_ notification: UNNotification) {
    super.didReceive(notification)
    
    // Custom handling logic
  }
  
  override func didReceive(_ response: UNNotificationResponse, completionHandler completion: @escaping (UNNotificationContentExtensionResponseOption) -> Void) {
    super.didReceive(response, completionHandler: completion)
    
    // Custom handling logic
  }
}

5단계: 알림 콘텐츠 확장 plist 설정

Notification Content Extension의 Info.plist 파일을 열고 NSExtension \ NSExtensionAttributes 아래에서 다음 키를 추가 및 변경합니다.

또한, 동일한Info.plist파일에 다음 최상위Braze사전(dictionary)을 추가하고, 단계 2에서 생성한 앱 그룹으로 를 REPLACE_WITH_APPGROUP대체하십시오:

귀하의 Info.plist 파일은 다음 이미지와 일치해야 합니다:

Step 6: 주요 앱 {#update-braze}에서 Braze 통합 업데이트

Braze를 초기화하기 전에 앱 그룹의 이름을 Braze 구성의 push.appGroup 속성에 할당하십시오.

1
2
3
4
let configuration = Braze.Configuration(apiKey: "<YOUR-BRAZE-API-KEY>",
                                        endpoint: "<YOUR-BRAZE-ENDPOINT>")
configuration.push.appGroup = "REPLACE_WITH_APPGROUP"
let braze = Braze(configuration: configuration)