푸시 스토리

필수 조건

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

Push Stories를 수신하려면 다음 최소 SDK 버전이 필요합니다:

Push Stories 설정

1단계: 알림 콘텐츠 확장 타겟 추가

앱 프로젝트에서 File > New > Target 메뉴로 이동하여 새로운 Notification Content Extension 타겟을 추가하고 활성화합니다.

Xcode가 자동으로 새 타겟을 생성하고 다음 파일들을 포함하여 자동으로 만들어 줍니다:

• NotificationViewController.swift
• MainInterface.storyboard

2단계: 기능 활성화

Xcode에서 메인 앱 타겟의 Signing & Capabilities 패널을 사용하여 Background Modes 기능을 추가합니다. Background fetch와 Remote notifications 체크박스를 모두 선택합니다.

앱 그룹 추가

또한 Xcode의 Signing & Capabilities 패널에서 메인 앱 타겟과 알림 콘텐츠 확장 타겟 모두에 App Groups 기능을 추가합니다. 그런 다음 + 버튼을 클릭합니다. 앱의 번들 ID를 사용하여 앱 그룹을 생성합니다. 예를 들어, 앱의 번들 ID가 com.company.appname인 경우 앱 그룹의 이름을 group.com.company.appname.xyz로 지정할 수 있습니다.

중요

여기서 앱 그룹은 Apple의 App Groups Entitlement를 의미하며, Braze 워크스페이스(이전의 앱 그룹) ID와는 다릅니다.

앱을 앱 그룹에 추가하지 않으면 푸시 페이로드에서 특정 필드가 채워지지 않아 정상적으로 작동하지 않을 수 있습니다.

3단계: 앱에 Push Story 프레임워크 추가

• 스위프트 패키지 매니저
• cocoapods
• 수동

스위프트 패키지 매니저 통합 가이드를 따른 후, Notification Content Extension에 BrazePushStory를 추가합니다:

Podfile에 다음 줄을 추가합니다:

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

참고

리치 푸시 구현 방법은 리치 알림을 참조하세요.

Podfile을 업데이트한 후, 터미널에서 Xcode 앱 프로젝트 디렉토리로 이동하여 pod install을 실행합니다.

GitHub 릴리스 페이지에서 최신 BrazePushStory.zip을 다운로드하고 압축을 풀어 프로젝트의 Notification Content Extension에 BrazePushStory.xcframework를 추가합니다.

중요

Embed 열에서 BrazePushStory.xcframework에 대해 Do Not Embed가 선택되어 있는지 확인하세요.

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 사전을 추가하고, REPLACE_WITH_APPGROUP을 2단계에서 생성한 앱 그룹으로 교체합니다:

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

6단계: 메인 앱에서 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)