푸시 스토리

Prerequisites

Before you can use this feature, you’ll need to integrate the Cordova Braze SDK. 또한 푸시 알림을 설정해야 하며, 여기에는 UNNotification 프레임워크 구현이 포함됩니다.

푸시 스토리를 수신하려면 다음 SDK 버전이 필요합니다.

푸시 스토리 설정하기

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}에 푸시 스토리 프레임워크 추가

• 스위프트 패키지 매니저
• cocoapods
• 매뉴얼

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 파일은 다음 이미지와 일치해야 합니다:

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)