다양한 푸시 알림

필수 조건

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

리치 푸시 알림 설정하기

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

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

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

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

알림 서비스 확장은 앱과 함께 번들되는 별도의 바이너리입니다. Apple 개발자 포털에서 고유한 앱 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을 제공합니다. 에셋은 푸시 알림 수신 시 다운로드되므로, 콘텐츠를 직접 호스팅하는 경우 대규모의 동기적인 요청 급증을 대비해야 합니다.