조용한 푸시 알림

필수 조건

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

iOS 제한 사항

iOS 운영 체제는 일부 기능에 대한 알림을 제한할 수 있습니다. 이러한 기능에 어려움을 겪고 있다면 iOS의 무음 알림 게이트가 원인일 수 있습니다. 자세한 내용은 Apple의 인스턴스 메서드 및 수신되지 않은 알림 설명서를 참조하세요.

무음 푸시 알림 설정하기

무음 푸시 알림을 사용하여 백그라운드 작업을 트리거하려면, 앱이 백그라운드 상태에서도 알림을 받을 수 있도록 설정해야 합니다. 이를 위해 Xcode에서 기본 앱 타깃의 Signing & Capabilities 패널을 통해 Background Modes 기능을 추가하세요. Remote notifications 체크박스를 선택합니다.

원격 알림 백그라운드 모드가 활성화되어 있더라도, 사용자가 앱을 강제 종료한 경우 시스템이 앱을 백그라운드에서 실행하지 않습니다. 시스템이 자동으로 앱을 백그라운드에서 실행할 수 있으려면 사용자가 직접 앱을 실행하거나 기기를 재부팅해야 합니다.

자세한 내용은 백그라운드 업데이트 푸시하기 및 application:didReceiveRemoteNotification:fetchCompletionHandler: 설명서를 참조하세요.

무음 푸시 알림 보내기

무음 푸시 알림을 보내려면 푸시 알림 페이로드에서 content-available 플래그를 1로 설정합니다.

참고

Apple에서 원격 알림이라고 부르는 것은 content-available 플래그가 설정된 일반 푸시 알림에 불과합니다.

content-available 플래그는 Braze 대시보드와 메시징 API의 Apple 푸시 오브젝트에서 설정할 수 있습니다.

경고

content-available=1과 함께 제목과 본문을 모두 첨부하는 것은 정의되지 않은 동작으로 이어질 수 있으므로 권장하지 않습니다. 알림이 진정한 무음 알림이 되도록 하려면 content-available 플래그를 1로 설정할 때 제목과 본문을 모두 제외하세요. 자세한 내용은 Apple 공식 백그라운드 업데이트 문서를 참조하세요.

무음 푸시 알림을 보낼 때 알림 페이로드에 데이터를 포함하여 애플리케이션이 해당 이벤트를 참조할 수 있도록 할 수도 있습니다. 이를 통해 네트워크 요청 횟수를 줄이고 앱의 응답성을 높일 수 있습니다.

내부 푸시 알림 무시하기

Braze는 제거 추적과 같은 특정 고급 기능을 내부적으로 처리하기 위해 무음 푸시 알림을 사용합니다. 앱이 애플리케이션 실행 또는 백그라운드 푸시 시 자동 작업을 수행하는 경우, 내부 푸시 알림에 의해 해당 작업이 트리거되지 않도록 게이트 처리를 고려하세요.

예를 들어, 백그라운드 푸시 또는 애플리케이션 실행 시마다 서버에 새 콘텐츠를 요청하는 로직이 있다면, Braze의 내부 푸시가 불필요한 네트워크 트래픽을 유발하지 않도록 방지하는 것이 좋습니다. Braze는 특정 종류의 내부 푸시를 거의 동시에 모든 사용자에게 전송하기 때문에, 내부 푸시에 의한 실행 시 네트워크 호출이 게이트 처리되지 않으면 상당한 서버 부하가 발생할 수 있습니다.

1단계: 앱의 자동 작업 확인하기

애플리케이션에서 다음 위치의 자동 작업을 확인하고, Braze의 내부 푸시를 무시하도록 코드를 업데이트하세요:

1. 푸시 수신기. 백그라운드 푸시 알림은 UIApplicationDelegate의 application:didReceiveRemoteNotification:fetchCompletionHandler:를 호출합니다.
2. 애플리케이션 델리게이트. 백그라운드 푸시는 일시 중단된 앱을 백그라운드에서 실행시켜 UIApplicationDelegate의 application:willFinishLaunchingWithOptions: 및 application:didFinishLaunchingWithOptions: 메서드를 트리거할 수 있습니다. 이 메서드의 launchOptions를 확인하여 애플리케이션이 백그라운드 푸시에 의해 실행되었는지 판별하세요.

2단계: 내부 푸시 유틸리티 메서드 사용하기

Braze.Notifications의 정적 유틸리티 메서드를 사용하여 앱이 Braze 내부 푸시를 수신했거나 이에 의해 실행되었는지 확인할 수 있습니다. Braze.Notifications.isInternalNotification(_:)는 제거 추적 및 Feature flags 동기화 알림을 포함한 모든 Braze 내부 푸시 알림에 대해 true를 반환합니다.

예시:

• swift
• objective-c

1
2
3
4
5
6
7

func application(_ application: UIApplication,
                 didReceiveRemoteNotification userInfo: [AnyHashable : Any],
                 fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
  if (!Braze.Notifications.isInternalNotification(userInfo)) {
    // Gated logic here (for example pinging server for content)
  }
}

1
2
3
4
5

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler {
  if (![BRZNotifications isInternalNotification:userInfo]) {
    // Gated logic here (for example pinging server for content)
  }
}