푸시 스토리

마케팅 담당자는 푸시 스토리에서 사진 캐러셀 기능을 사용하여 푸시 알림 내에 페이지 시퀀스를 만들 수 있습니다. 이 페이지는 이미지, 클릭 동작, 제목 및 설명으로 구성됩니다.

iOS 앱에 푸시 스토리를 설정하려면 표준 푸시 알림 통합 외에도 추가 단계가 필요하며, 이는 이 기사에 설명되어 있습니다.

필수 조건

푸시 스토리를 수신하려면 다음 SDK 버전이 필요합니다.

푸시 알림 통합 튜토리얼을 따라 앱에서 푸시를 활성화했는지 확인합니다. 이 작업의 일환으로, 이 기능에 필요한 UNNotification 프레임워크를 구현해야 합니다.

1단계: 알림 콘텐츠 확장 대상 추가

앱 프로젝트에서 메뉴 파일 > 새로 만들기 > 타겟로 이동하여 새 Notification Content Extension 타겟을 추가하고 활성화하세요.

Xcode가 새 대상을 자동으로 생성하고 다음을 포함하여 파일을 자동으로 생성합니다.

• NotificationViewController.swift
• MainInterface.storyboard

2단계: 기능 활성화

Xcode에서 서명 및 기능 창을 사용하여 백그라운드 모드 기능을 기본 앱 대상에 추가합니다. 백그라운드 가져오기 및 원격 알림 체크박스를 모두 선택합니다.

앱 그룹 추가

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

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

3단계: 앱 {#enable-capabilities}에 푸시 스토리 프레임워크 추가

• 스위프트 패키지 매니저
• cocoapods
• 매뉴얼

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

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 파일은 다음 이미지와 일치해야 합니다:

6단계: 주요 앱 {#update-braze}에서 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)