다양한 푸시 알림

필수 조건

이 기능을 사용하려면 먼저 Swift Braze SDK를 통합해야 합니다. 푸시 알림도 설정해야 합니다.

리치 푸시 알림 설정하기

1단계: 서비스 확장 만들기

알림 서비스 확장을 만들려면 Xcode에서 File > New > Target으로 이동한 다음 Notification Service Extension을 선택합니다.

Embed In Application이 애플리케이션에 확장을 포함하도록 설정되어 있는지 확인하세요.

2단계: 알림 서비스 확장 설정하기

알림 서비스 확장은 앱과 함께 번들로 제공되는 별도의 바이너리입니다. Apple Developer Portal에서 자체 앱 ID와 프로비저닝 프로필을 사용하여 설정해야 합니다.

알림 서비스 확장의 번들 ID는 기본 앱 대상의 번들 ID와 달라야 합니다. 예를 들어, 앱의 번들 ID가 com.company.appname인 경우 서비스 확장에 com.company.appname.AppNameServiceExtension을 사용할 수 있습니다.

3단계: 앱 그룹 추가하기

Xcode에서 Signing & Capabilities 패널의 기본 앱 대상과 Notification Service Extension 대상 모두에 App Groups 기능을 추가합니다. 그런 다음 + 버튼을 클릭합니다. 앱의 번들 ID를 사용하여 앱 그룹을 만드세요. 예를 들어, 앱의 번들 ID가 com.company.appname인 경우 앱 그룹 이름을 group.com.company.appname.xyz로 지정할 수 있습니다.

중요

여기서 말하는 앱 그룹은 Apple의 앱 그룹 엔타이틀먼트를 의미하며, Braze 워크스페이스(이전의 앱 그룹) ID가 아닙니다.

기본 앱과 Notification Service Extension이 공유 데이터에 접근할 수 있도록 공유 앱 그룹이 필요합니다. 앱을 앱 그룹에 추가하지 않으면 푸시 페이로드에서 특정 필드를 채우지 못할 수 있으며, 예상대로 완전히 작동하지 않을 수 있습니다.

4단계: 리치 푸시 알림 통합하기

BrazeNotificationService를 사용한 리치 푸시 알림 통합에 대한 단계별 가이드는 튜토리얼을 참조하세요.

샘플을 확인하려면 예제 앱의 NotificationService 사용법을 참조하세요.

앱에 리치 푸시 프레임워크 추가하기

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

스위프트 패키지 매니저 통합 가이드를 따른 후, 다음을 수행하여 Notification Service Extension에 BrazeNotificationService를 추가합니다:

1. Xcode에서 프레임워크 및 라이브러리 아래의 추가 아이콘을 선택하여 프레임워크를 추가합니다.
   
   
   
   

2. “BrazeNotificationService” 프레임워크를 선택합니다.
   
   

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 'YourNotificationServiceExtensionTarget' do
  pod 'BrazeNotificationService'
end

# Only include the below if you want to also integrate Push Stories
target 'YourNotificationContentExtensionTarget' do
  pod 'BrazePushStory'
end

참고

Push Stories 구현에 대한 지침은 설명서를 참조하세요.

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

Notification Service Extension에 BrazeNotificationService.xcframework를 추가하려면 수동 통합을 참조하세요.

자체 UNNotificationServiceExtension 사용하기

자체 UNNotificationServiceExtension을 사용해야 하는 경우, didReceive 메서드에서 brazeHandle을 호출할 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

import BrazeNotificationService
import UserNotifications

class NotificationService: UNNotificationServiceExtension {

  override func didReceive(
    _ request: UNNotificationRequest,
    withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void
  ) {
    if brazeHandle(request: request, contentHandler: contentHandler) {
      return
    }

    // Custom handling here

    contentHandler(request.content)
  }
}

5단계: 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)

6단계: 대시보드에서 리치 알림 만들기

마케팅 팀에서도 대시보드에서 리치 알림을 만들 수 있습니다. 푸시 작성기를 통해 푸시 알림을 만들고 이미지나 GIF를 첨부하거나, 이미지, GIF 또는 비디오를 호스팅하는 URL을 제공합니다. 에셋은 푸시 알림 수신 시 다운로드되므로, 콘텐츠를 직접 호스팅하는 경우 대규모 동기 요청 스파이크에 대비해야 합니다.