푸시 스토리

필수 조건

이 기능을 사용하려면 먼저 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로 지정할 수 있습니다.

중요

이 컨텍스트에서 앱 그룹은 Braze 워크스페이스(이전 앱 그룹) ID가 아닌 Apple의 앱 그룹 권한을 의미합니다.

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

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)