Skip to content

다양한 푸시 알림

Braze SDK에 대한 리치 푸시 알림을 설정하는 방법을 알아보세요.

필수 조건

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

리치 푸시 알림 설정하기

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

알림 서비스 확장을 생성하려면 Xcode에서 파일 > 새로 만들기 > 대상으로 이동하고 알림 서비스 확장을 선택합니다.

애플리케이션에 임베드가 애플리케이션에 확장을 임베드하도록 설정되었는지 확인합니다.

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

알림 서비스 확장은 앱에 번들로 제공되는 자체 바이너리입니다. Apple 개발자 포털에서 자체 앱 ID 및 프로비저닝 프로필을 사용하여 설정해야 합니다.

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

3단계: 앱 그룹 추가

Xcode에서 서명 & 기능 창에서 앱 그룹 기능을 추가하여 기본 앱 타겟과 알림 서비스 확장 타겟에 추가합니다. 그런 다음 + 버튼을 클릭합니다. 앱의 번들 ID를 사용하여 앱 그룹을 만드십시오. 예를 들어 앱의 번들 ID가 com.company.appname인 경우 앱 그룹 이름을 group.com.company.appname.xyz로 지정할 수 있습니다.

주 앱과 알림 서비스 확장이 공유 데이터를 접근할 수 있도록 공유 앱 그룹이 필요합니다. 앱을 앱 그룹에 추가하지 않으면 푸시 페이로드에서 특정 필드를 채우지 못할 수 있으며 예상대로 작동하지 않을 수 있습니다.

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

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

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

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

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

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

    플러스 아이콘은 Xcode의 프레임워크 및 라이브러리 아래에 있습니다.

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

    "BrazeNotificationService 프레임워크는 열리는 모달에서 선택할 수 있습니다.

포드파일에 다음을 추가합니다:

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

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)

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

마케팅 팀은 대시보드에서 리치 알림을 생성할 수 있습니다. 푸시 작곡기를 통해 푸시 알림을 생성하고 이미지나 GIF를 첨부하거나 이미지를 호스팅하는 URL, GIF 또는 비디오를 제공하세요. 푸시 알림을 받으면 자산이 다운로드되므로 콘텐츠를 호스팅하는 경우 요청이 동시에 급증하는 상황에 대비해야 합니다.

필수 조건

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

리치 푸시 알림 설정하기

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

Xcode 프로젝트에서 알림 서비스 확장 프로그램을 생성합니다. 전체 안내는 iOS 리치 푸시 알림 튜토리얼을 참조하세요.

2단계: 새 대상 추가

Podfile을 열고 방금 생성한 알림 서비스 확장 대상에 BrazeNotificationService를 추가합니다. BrazeNotificationService가 이미 대상에 추가되어 있는 경우 계속하기 전에 제거합니다. 중복된 심볼 오류를 방지하려면 정적 링크를 사용하세요.

1
2
3
4

target 'NOTIFICATION_SERVICE_EXTENSION' do
  use_frameworks! :linkage => :static
  pod 'BrazeNotificationService'
end

NOTIFICATION_SERVICE_EXTENSION 을 알림 서비스 확장자의 이름으로 바꿉니다. 팟파일은 다음과 비슷해야 합니다:

1
2
3
4

target 'MyAppRichNotificationService' do
  use_frameworks! :linkage => :static
  pod 'BrazeNotificationService'
end

3단계: CocoaPods 종속성 다시 설치

터미널에서 프로젝트의 iOS 디렉토리로 이동하여 CocoaPod 종속 요소를 다시 설치합니다.

1
2

cd PATH_TO_PROJECT/platform/ios
pod install

필수 조건

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

Expo를 사용하여 리치 푸시 알림 인에이블먼트하기

React Native 소프트웨어 개발 키트의 경우, Android에서는 기본값으로 리치 푸시 알림을 사용할 수 있습니다.

Expo를 사용하여 iOS에서 리치 푸시 알림을 활성화하려면 app.json의 expo.plugins 오브젝트에서 enableBrazeIosRichPush 속성정보를 true로 구성합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13

{
  "expo": {
    "plugins": [
      [
        "@braze/expo-plugin",
        {
          ...
          "enableBrazeIosRichPush": true
        }
      ]
    ]
  }
}

마지막으로, 프로젝트의 자격 증명 구성에 이 앱 확장에 대한 번들 식별자를 추가합니다. <your-app-bundle-id>.BrazeExpoRichPush. 이 프로세스에 대한 자세한 내용은 Expo 애플리케이션 서비스에서 앱 확장 사용을 참조하세요.
Github   GitHub 에서 이 페이지를 편집합니다.
New Stuff!