푸시 알림

필수 조건

이 기능을 사용하려면 먼저 Android Braze SDK를 통합해야 합니다.

기본 제공 기능

다음 기능은 Braze Android SDK에 기본으로 포함되어 있습니다. 다른 푸시 알림 기능을 사용하려면 앱에 푸시 알림을 설정해야 합니다.

푸시 알림 수명 주기에 관하여

다음 플로우차트는 Braze가 푸시 알림 수명 주기(예: 권한 프롬프트, 토큰 생성, 메시지 전달)를 처리하는 방식을 보여줍니다.

• 권한 부여
• 푸시 토큰 생성
• 알림 표시

---
config:
  theme: neutral
---
flowchart TD

%% Permission flow
subgraph Permission[Push Permissions]
    B{Android version of the device?}
    B -->|Android 13+| C["requestPushPermissionPrompt() called"]
    B -->|Android 12 and earlier| D[No permissions required]

    %% Connect Android 12 path to Braze state
    D --> H3[Braze: user subscription state]
    H3 --> J3[Defaults to 'subscribed' when user profile created]

    C --> E{Did the user grant push permission?}
    E -->|Yes| F[POST_NOTIFICATIONS permission granted]
    E -->|No| G[POST_NOTIFICATIONS permission denied]

    %% Braze subscription state updates
    F --> H1[Braze: user subscription state]
    G --> H2[Braze: user subscription state]

    H1 --> I1{Automatically opt in after permission granted?}
    I1 -->|true| J1[Set to 'opted-in']
    I1 -->|false| J2[Remains 'subscribed']

    H2 --> K1[Remains 'subscribed'<br/>or 'unsubscribed']

    %% Subscription state legend
    subgraph BrazeStates[Braze subscription states]
        L1['Subscribed' - default state<br/>when user profile created]
        L2['Opted-in' - user explicitly<br/>wants push notifications]
        L3['Unsubscribed' - user explicitly<br/>opted out of push]
    end

    %% Note about user-level states
    note1[Note: These states are user-level<br/>and apply across all devices for the user]

    %% Connect states to legend
    J1 -.-> L2
    J2 -.-> L1
    J3 -.-> L1
    K1 -.-> L3
    note1 -.-> BrazeStates
end

%% Styling
classDef permissionClass fill:#e3f2fd,stroke:#1565c0,stroke-width:2px
classDef tokenClass fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px
classDef sdkClass fill:#fff3e0,stroke:#e65100,stroke-width:2px
classDef configClass fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
classDef displayClass fill:#ffebee,stroke:#c62828,stroke-width:2px
classDef deliveryClass fill:#fce4ec,stroke:#c2185b,stroke-width:2px
classDef brazeClass fill:#e8f5e9,stroke:#2e7d32,stroke-width:3px

class A,B,C,E,F,G permissionClass
class H,I tokenClass
class J,K sdkClass
class N,O,P configClass
class R,S,S1,T,U,V displayClass
class W,X,X1,X2,Y,Z deliveryClass
class H1,H2,H3,I1,J1,J2,J3,K1,L1,L2,L3,note1 brazeClass

---
config:
  theme: neutral
---
flowchart TD

%% Token generation flow
subgraph Token[Token Generation]
    H["Braze SDK initialized"] --> Q{Is FCM auto-registration enabled?}
    Q -->|Yes| L{Is required configuration present?}
    Q -->|No| M[No FCM token generated]
    L -->|Yes| I[Generate FCM token]
    L -->|No| M
    I --> K[Register token with Braze]

    %% Configuration requirements
    subgraph Config[Required configuration]
        N['google-services.json' file is present]
        O['com.google.firebase:firebase-messaging' in gradle]
        P['com.google.gms.google-services' plugin in gradle]
    end

    %% Connect config to check
    N -.-> L
    O -.-> L
    P -.-> L
end

%% Styling
classDef permissionClass fill:#e3f2fd,stroke:#1565c0,stroke-width:2px
classDef tokenClass fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px
classDef sdkClass fill:#fff3e0,stroke:#e65100,stroke-width:2px
classDef configClass fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
classDef displayClass fill:#ffebee,stroke:#c62828,stroke-width:2px
classDef deliveryClass fill:#fce4ec,stroke:#c2185b,stroke-width:2px
classDef brazeClass fill:#e8f5e9,stroke:#2e7d32,stroke-width:3px

class A,B,C,E,F,G permissionClass
class H,I tokenClass
class J,K sdkClass
class N,O,P configClass
class R,S,S1,T,U,V displayClass
class W,X,X1,X2,Y,Z deliveryClass
class H1,H2,H3,I1,J1,J2,J3,K1,L1,L2,L3,note1 brazeClass

---
config:
  theme: neutral
  fontSize: 10
---
flowchart TD

subgraph Display[Push Display]
    %% Push delivery flow
    W[Push sent to FCM servers] --> X{Did FCM receive push?}
    X -->|App is terminated| Y[FCM cannot deliver push to the app]
    X -->|Delivery conditions met| X1[App receives push from FCM]
    X1 --> X2[Braze SDK receives push]
    X2 --> R[Push type?]

    %% Push Display Flow
    R -->|Standard push| S{Is push permission required?}
    R -->|Silent push| T[Braze SDK processes silent push]
    S -->|Yes| S1{Did the user grant push permission?}
    S -->|No| V[Notification is shown to the user]
    S1 -->|Yes| V
    S1 -->|No| U[Notification is not shown to the user]
end

%% Styling
classDef permissionClass fill:#e3f2fd,stroke:#1565c0,stroke-width:2px
classDef tokenClass fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px
classDef sdkClass fill:#fff3e0,stroke:#e65100,stroke-width:2px
classDef configClass fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
classDef displayClass fill:#ffebee,stroke:#c62828,stroke-width:2px
classDef deliveryClass fill:#fce4ec,stroke:#c2185b,stroke-width:2px
classDef brazeClass fill:#e8f5e9,stroke:#2e7d32,stroke-width:3px

class A,B,C,E,F,G permissionClass
class H,I tokenClass
class J,K sdkClass
class N,O,P configClass
class R,S,S1,T,U,V displayClass
class W,X,X1,X2,Y,Z deliveryClass
class H1,H2,H3,I1,J1,J2,J3,K1,L1,L2,L3,note1 brazeClass

푸시 알림 설정하기

팁

Braze Android SDK와 FCM을 사용하는 샘플 앱을 확인하려면 Braze: Firebase Push 샘플 앱을 참조하세요.

사용량 제한

Firebase Cloud Messaging(FCM) API의 기본 사용량 제한은 분당 600,000건입니다. 이 제한에 도달하면 Braze가 몇 분 후에 자동으로 재시도합니다. 한도 증가를 요청하려면 Firebase 지원팀에 문의하세요.

1단계: 프로젝트에 Firebase 추가하기

먼저 Android 프로젝트에 Firebase를 추가합니다. 단계별 안내는 Google의 Firebase 설정 가이드를 참조하세요.

2단계: 의존성에 Cloud Messaging 추가하기

다음으로 프로젝트 의존성에 Cloud Messaging 라이브러리를 추가합니다. Android 프로젝트에서 build.gradle을 열고 dependencies 블록에 다음 줄을 추가합니다.

1

implementation "google.firebase:firebase-messaging:+"

의존성은 다음과 비슷하게 보여야 합니다:

1
2
3
4

dependencies {
  implementation project(':android-sdk-ui')
  implementation "com.google.firebase:firebase-messaging:+"
}

3단계: Firebase Cloud Messaging API 활성화하기

Google Cloud에서 Android 앱이 사용 중인 프로젝트를 선택한 다음, Firebase Cloud Messaging API를 활성화합니다.

4단계: 서비스 계정 만들기

다음으로, FCM 토큰 등록 시 Braze가 인증된 API 호출을 할 수 있도록 새 서비스 계정을 만듭니다. Google Cloud에서 Service Accounts로 이동한 다음 프로젝트를 선택합니다. Service Accounts 페이지에서 Create Service Account를 선택합니다.

서비스 계정 이름, ID 및 설명을 입력한 다음 Create and continue를 선택합니다.

Role 필드에서 역할 목록에서 Firebase Cloud Messaging API Admin을 찾아 선택합니다. 더 제한적인 액세스를 원하면 cloudmessaging.messages.create 권한이 있는 커스텀 역할을 만든 다음 목록에서 해당 역할을 선택합니다. 완료되면 Done을 선택합니다.

경고

Firebase Cloud Messaging Admin이 아닌 Firebase Cloud Messaging API Admin을 선택해야 합니다.

5단계: JSON 자격 증명 생성하기

다음으로 FCM 서비스 계정의 JSON 자격 증명을 생성합니다. Google Cloud IAM & Admin에서 Service Accounts로 이동한 다음 프로젝트를 선택합니다. 이전에 만든 FCM 서비스 계정을 찾은 다음  Actions > Manage Keys를 선택합니다.

Add Key > Create new key를 선택합니다.

JSON을 선택한 다음 Create를 선택합니다. 서비스 계정을 FCM 프로젝트 ID와 다른 Google Cloud 프로젝트 ID를 사용하여 만든 경우, JSON 파일에서 project_id에 할당된 값을 수동으로 업데이트해야 합니다.

키를 다운로드한 위치를 기억해 두세요—다음 단계에서 필요합니다.

경고

비공개 키는 유출될 경우 보안 위험이 될 수 있습니다. JSON 자격 증명을 안전한 장소에 보관하세요—Braze에 업로드한 후 키를 삭제할 예정입니다.

6단계: Braze에 JSON 자격 증명 업로드하기

다음으로 Braze 대시보드에 JSON 자격 증명을 업로드합니다. Braze에서  Settings > App Settings를 선택합니다.

Android 앱의 Push Notification Settings 아래에서 Firebase를 선택한 다음 Upload JSON File을 선택하고 이전에 생성한 자격 증명을 업로드합니다. 완료되면 Save를 선택합니다.

경고

비공개 키는 유출될 경우 보안 위험이 될 수 있습니다. 키가 Braze에 업로드되었으므로 이전에 생성한 파일을 삭제하세요.

7단계: 자동 토큰 등록 설정하기

사용자 중 한 명이 푸시 알림을 옵트인하면, 푸시 알림을 보내기 전에 해당 사용자의 기기에서 FCM 토큰을 생성해야 합니다. Braze SDK를 사용하면 프로젝트의 Braze 설정 파일에서 각 사용자 기기에 대한 자동 FCM 토큰 등록을 활성화할 수 있습니다.

먼저 Firebase Console로 이동하여 프로젝트를 연 다음  Settings > Project settings를 선택합니다.

Cloud Messaging을 선택한 다음 Firebase Cloud Messaging API (V1) 아래에서 Sender ID 필드의 번호를 복사합니다.

그런 다음 Android Studio 프로젝트를 열고 Firebase Sender ID를 사용하여 braze.xml 또는 BrazeConfig에서 자동 FCM 토큰 등록을 활성화합니다.

• braze.xml
• brazeconfig

1
2

<bool translatable="false" name="com_braze_firebase_cloud_messaging_registration_enabled">true</bool>
<string translatable="false" name="com_braze_firebase_cloud_messaging_sender_id">FIREBASE_SENDER_ID</string>

1
2
3
4
5
6

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <string translatable="false" name="com_braze_api_key">12345ABC-6789-DEFG-0123-HIJK456789LM</string>
  <bool translatable="false" name="com_braze_firebase_cloud_messaging_registration_enabled">true</bool>
<string translatable="false" name="com_braze_firebase_cloud_messaging_sender_id">603679405392</string>
</resources>

1
2

.setIsFirebaseCloudMessagingRegistrationEnabled(true)
.setFirebaseCloudMessagingSenderIdKey("FIREBASE_SENDER_ID")

1
2

.setIsFirebaseCloudMessagingRegistrationEnabled(true)
.setFirebaseCloudMessagingSenderIdKey("FIREBASE_SENDER_ID")

1
2
3
4
5
6
7
8
9
10

BrazeConfig brazeConfig = new BrazeConfig.Builder()
  .setApiKey("12345ABC-6789-DEFG-0123-HIJK456789LM")
  .setCustomEndpoint("sdk.iad-01.braze.com")
  .setSessionTimeout(60)
  .setHandlePushDeepLinksAutomatically(true)
  .setGreatNetworkDataFlushInterval(10)
  .setIsFirebaseCloudMessagingRegistrationEnabled(true)
  .setFirebaseCloudMessagingSenderIdKey("603679405392")
  .build();
Braze.configure(this, brazeConfig);

1
2
3
4
5
6
7
8
9
10

val brazeConfig = BrazeConfig.Builder()
  .setApiKey("12345ABC-6789-DEFG-0123-HIJK456789LM")
  .setCustomEndpoint("sdk.iad-01.braze.com")
  .setSessionTimeout(60)
  .setHandlePushDeepLinksAutomatically(true)
  .setGreatNetworkDataFlushInterval(10)
  .setIsFirebaseCloudMessagingRegistrationEnabled(true)
  .setFirebaseCloudMessagingSenderIdKey("603679405392")
  .build()
Braze.configure(this, brazeConfig)

팁

FCM 토큰을 수동으로 등록하려면, 앱의 onCreate() 메서드 내에서 Braze 인스턴스의 registeredPushToken 속성정보를 설정하세요.

1
2

// Kotlin
Braze.getInstance(context).registeredPushToken = "FCM_TOKEN"

1
2

// Java
Braze.getInstance(context).setRegisteredPushToken("FCM_TOKEN");

여러 Firebase 프로젝트 사용하기

앱에서 여러 Firebase 프로젝트를 사용하는 경우 다음 단계를 따르세요:

1. 앱의 google-services.json에서 초기화된 기본 Firebase 프로젝트에서 Braze 푸시를 유지합니다.
2. 커스텀 Firebase 메시징 서비스를 사용하는 경우, 커스텀 Firebase 메시징 서비스에서 설치 ID 등록하기를 완료합니다.
3. 앱이 다른 방식으로 푸시 토큰을 가져오는 경우, 이전 팁에 나온 대로 수동으로 registeredPushToken을 설정합니다.

중요

Firebase Cloud Messaging에는 수동으로 초기화한 FirebaseApp에서 토큰을 검색하는 지원 API가 없습니다. onNewToken 및 onRegistered와 같은 FirebaseMessagingService 콜백은 기본 프로젝트에 대해서만 실행됩니다. 자세한 내용은 Firebase 설명서의 여러 프로젝트 구성을 참조하세요.

버전 세부 정보는 SDK 체인지로그를 참조하세요.

8단계: 애플리케이션 클래스에서 자동 요청 제거하기

무음 푸시 알림을 보낼 때마다 Braze가 불필요한 네트워크 요청을 트리거하지 않도록, Application 클래스의 onCreate() 메서드에 구성된 자동 네트워크 요청을 제거합니다. 자세한 내용은 Android 개발자 레퍼런스: Application을 참조하세요.

알림 표시하기

1단계: Braze Firebase Messaging Service 등록하기

새로운 Firebase Messaging Service, 기존 서비스 또는 Braze가 아닌 Firebase Messaging Service를 생성할 수 있습니다. 특정 요구 사항에 가장 적합한 것을 선택하세요.

• new
• existing
• non-braze

Braze에는 푸시 수신 및 열기 인텐트를 처리하는 서비스가 포함되어 있습니다. BrazeFirebaseMessagingService 클래스를 AndroidManifest.xml에 등록해야 합니다.

1
2
3
4
5
6

<service android:name="com.braze.push.BrazeFirebaseMessagingService"
  android:exported="false">
  <intent-filter>
    <action android:name="com.google.firebase.MESSAGING_EVENT" />
  </intent-filter>
</service>

알림 코드도 BrazeFirebaseMessagingService를 사용하여 열기 및 클릭 동작 추적을 처리합니다. 이 서비스가 올바르게 작동하려면 AndroidManifest.xml에 등록해야 합니다. 또한 Braze는 시스템에서 보낸 알림에 고유 키를 접두사로 추가하여 Braze 시스템에서 보낸 알림만 렌더링합니다. 다른 FCM 서비스에서 보낸 알림을 렌더링하려면 추가 서비스를 별도로 등록할 수 있습니다. Firebase 푸시 샘플 앱의 AndroidManifest.xml을 참조하세요.

중요

Braze SDK 3.1.1 이전에는 AppboyFcmReceiver가 FCM 푸시를 처리하는 데 사용되었습니다. AppboyFcmReceiver 클래스는 매니페스트에서 제거하고 위의 통합으로 교체해야 합니다.

이미 Firebase Messaging Service가 등록되어 있는 경우, BrazeFirebaseMessagingService.handleBrazeRemoteMessage()를 통해 RemoteMessage 객체를 Braze에 전달할 수 있습니다. 이 메서드는 RemoteMessage 객체가 Braze에서 발신된 경우에만 알림을 표시하며, 그렇지 않은 경우 안전하게 무시합니다.

커스텀 Firebase Messaging Service에서 설치 ID 등록하기

firebase-messaging v25.1.0 이상을 사용하는 경우, Firebase 등록에 Firebase Installation ID가 사용됩니다. 커스텀 Firebase Messaging Service에서 onRegistered를 오버라이드하고 registeredPushToken을 설정하세요.

• java
• kotlin

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

public class MyFirebaseMessagingService extends FirebaseMessagingService {
  @Override
  public void onRegistered(String installationId) {
    super.onRegistered(installationId);
    Braze.getInstance(this).setRegisteredPushToken(installationId);
  }

  @Override
  public void onMessageReceived(RemoteMessage remoteMessage) {
    super.onMessageReceived(remoteMessage);
    if (BrazeFirebaseMessagingService.handleBrazeRemoteMessage(this, remoteMessage)) {
      // This Remote Message originated from Braze and a push notification was displayed.
      // No further action is needed.
    } else {
      // This Remote Message did not originate from Braze.
      // No action was taken and you can safely pass this Remote Message to other handlers.
    }
  }
}

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

class MyFirebaseMessagingService : FirebaseMessagingService() {
  override fun onRegistered(installationId: String) {
    super.onRegistered(installationId)
    Braze.getInstance(this).registeredPushToken = installationId
  }

  override fun onMessageReceived(remoteMessage: RemoteMessage?) {
    super.onMessageReceived(remoteMessage)
    if (BrazeFirebaseMessagingService.handleBrazeRemoteMessage(this, remoteMessage)) {
      // This Remote Message originated from Braze and a push notification was displayed.
      // No further action is needed.
    } else {
      // This Remote Message did not originate from Braze.
      // No action was taken and you can safely pass this Remote Message to other handlers.
    }
  }
}

사용하려는 다른 Firebase Messaging Service가 있는 경우, 앱이 Braze가 아닌 푸시를 수신할 때 호출할 대체(fallback) Firebase Messaging Service를 지정할 수도 있습니다.

braze.xml에서 다음을 지정하세요.

1
2

<bool name="com_braze_fallback_firebase_cloud_messaging_service_enabled">true</bool>
<string name="com_braze_fallback_firebase_cloud_messaging_service_classpath">com.company.OurFirebaseMessagingService</string>

또는 런타임 구성을 통해 설정할 수 있습니다.

• java
• kotlin

1
2
3
4
5

BrazeConfig brazeConfig = new BrazeConfig.Builder()
        .setFallbackFirebaseMessagingServiceEnabled(true)
        .setFallbackFirebaseMessagingServiceClasspath("com.company.OurFirebaseMessagingService")
        .build();
Braze.configure(this, brazeConfig);

1
2
3
4
5

val brazeConfig = BrazeConfig.Builder()
        .setFallbackFirebaseMessagingServiceEnabled(true)
        .setFallbackFirebaseMessagingServiceClasspath("com.company.OurFirebaseMessagingService")
        .build()
Braze.configure(this, brazeConfig)

2단계: 디자인 가이드라인에 맞게 작은 아이콘 설정하기

Android 알림 아이콘에 대한 일반 정보는 알림 개요를 참조하세요.

Android N부터 색상이 포함된 작은 알림 아이콘 에셋을 업데이트하거나 제거해야 합니다. Android 시스템(Braze SDK가 아님)은 액션 아이콘과 알림 작은 아이콘에서 알파 및 투명도 채널이 아닌 모든 채널을 무시합니다. 즉, Android는 투명 영역을 제외한 알림 작은 아이콘의 모든 부분을 단색으로 변환합니다.

올바르게 표시되는 알림 작은 아이콘 에셋을 만들려면 다음을 따르세요.

• 흰색을 제외한 모든 색상을 이미지에서 제거합니다.
• 에셋의 흰색이 아닌 모든 영역은 투명해야 합니다.

참고

부적절한 에셋의 일반적인 증상은 작은 알림 아이콘이 단색 사각형으로 렌더링되는 것입니다. 이는 Android 시스템이 알림 작은 아이콘 에셋에서 투명 영역을 찾지 못하기 때문입니다.

아래 그림의 큰 아이콘과 작은 아이콘은 올바르게 디자인된 아이콘의 예시입니다.

3단계: 알림 아이콘 구성하기

braze.xml에서 아이콘 지정하기

Braze에서는 braze.xml에 드로어블 리소스를 지정하여 알림 아이콘을 구성할 수 있습니다.

1
2

<drawable name="com_braze_push_small_notification_icon">REPLACE_WITH_YOUR_ICON</drawable>
<drawable name="com_braze_push_large_notification_icon">REPLACE_WITH_YOUR_ICON</drawable>

작은 알림 아이콘 설정은 필수입니다. 설정하지 않으면 Braze는 앱 아이콘을 작은 알림 아이콘으로 기본 사용하며, 이는 최적의 표시가 아닐 수 있습니다.

큰 알림 아이콘 설정은 선택 사항이지만 권장됩니다.

아이콘 강조 색상 지정하기

알림 아이콘 강조 색상은 braze.xml에서 오버라이드할 수 있습니다. 색상이 지정되지 않은 경우, 기본 색상은 Lollipop에서 시스템 알림에 사용하는 것과 동일한 회색입니다.

1

<integer name="com_braze_default_notification_accent_color">0xFFf33e3e</integer>

색상 참조를 선택적으로 사용할 수도 있습니다.

1

<color name="com_braze_default_notification_accent_color">@color/my_color_here</color>

4단계: 딥링크 추가하기

자동 딥링크 열기 활성화하기

푸시 알림 클릭 시 Braze가 자동으로 앱 및 딥링크를 열도록 하려면 braze.xml에서 com_braze_handle_push_deep_links_automatically를 true로 설정하세요.

1

<bool name="com_braze_handle_push_deep_links_automatically">true</bool>

이 플래그는 런타임 구성을 통해서도 설정할 수 있습니다.

• java
• kotlin

1
2
3
4

BrazeConfig brazeConfig = new BrazeConfig.Builder()
        .setHandlePushDeepLinksAutomatically(true)
        .build();
Braze.configure(this, brazeConfig);

1
2
3
4

val brazeConfig = BrazeConfig.Builder()
        .setHandlePushDeepLinksAutomatically(true)
        .build()
Braze.configure(this, brazeConfig)

딥링크를 커스텀 처리하려면 Braze의 푸시 수신 및 열기 인텐트를 수신하는 푸시 콜백을 만들어야 합니다. 자세한 내용은 푸시 이벤트에 콜백 사용하기를 참조하세요.

포그라운드 알림 처리

기본적으로 Android에서 앱이 포그라운드 상태일 때 푸시 알림이 도착하면 시스템이 자동으로 이를 표시합니다. Braze가 푸시 알림 페이로드를 처리하도록(분석 추적, 딥링크 처리 및 커스텀 처리) 하려면, FirebaseMessagingService.onMessageReceived 메서드 내에서 수신된 푸시 데이터를 Braze로 전달하세요.

작동 방식

BrazeFirebaseMessagingService.handleBrazeRemoteMessage를 호출하면, Braze는 페이로드가 Braze 푸시 알림인지 판별하고, 맞다면 NotificationManagerCompat 메서드를 사용하여 알림을 생성하고 표시합니다. iOS와 달리 Android는 앱이 포그라운드에 있든 백그라운드에 있든 관계없이 알림을 표시합니다.

• java
• kotlin

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

package com.example.push;

import com.braze.push.BrazeFirebaseMessagingService;
import com.google.firebase.messaging.FirebaseMessagingService;
import com.google.firebase.messaging.RemoteMessage;

public class MyFirebaseMessagingService extends FirebaseMessagingService {
    @Override
    public void onMessageReceived(RemoteMessage remoteMessage) {
        super.onMessageReceived(remoteMessage);

        // Let Braze process the payload and display the notification
        if (BrazeFirebaseMessagingService.handleBrazeRemoteMessage(this, remoteMessage)) {
            // Braze successfully handled the push notification
        } else {
            // Handle non-Braze messages
        }
    }
}

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

package com.example.push

import com.braze.push.BrazeFirebaseMessagingService
import com.google.firebase.messaging.FirebaseMessagingService
import com.google.firebase.messaging.RemoteMessage

class MyFirebaseMessagingService : FirebaseMessagingService() {
    override fun onMessageReceived(remoteMessage: RemoteMessage) {
        super.onMessageReceived(remoteMessage)

        // Let Braze process the payload and display the notification
        if (BrazeFirebaseMessagingService.handleBrazeRemoteMessage(this, remoteMessage)) {
            // Braze successfully handled the push notification
        } else {
            // Handle non-Braze messages
        }
    }
}

자세한 내용은 Braze Android SDK 리포지토리의 Firebase 통합 샘플을 참조하세요.

포그라운드 동작 커스텀 설정

시스템 알림을 억제하거나 인앱 UI를 대신 표시하는 등 커스텀 포그라운드 동작을 원하는 경우 다음과 같이 할 수 있습니다.

• subscribeToPushNotificationEvents를 사용하여 푸시 이벤트에 반응하고, BrazeNotificationUtils.routeUserWithNotificationOpenedIntent 메서드로 딥링크를 처리합니다. 자세한 내용은 Firebase 푸시 샘플을 참조하세요.
• 커스텀 IBrazeNotificationFactory를 사용하여 직접 알림을 빌드하고 게시하거나, 처리 경로에서 notificationManager.notify를 호출하지 않아 알림을 억제합니다.

알림 커스텀 설정에 대한 자세한 내용은 커스텀 알림 팩토리를 참조하세요.

커스텀 딥링크 만들기

아직 앱에 딥링크를 추가하지 않았다면, 딥링킹에 대한 Android 개발자 문서의 안내를 따르세요. 딥링크가 무엇인지 자세히 알아보려면 FAQ 문서를 참조하세요.

딥링크 추가

Braze 대시보드에서는 푸시 알림 Campaigns 및 Canvases에 딥링크 또는 웹 URL을 설정할 수 있으며, 알림을 클릭하면 해당 링크가 열립니다.

백 스택 동작 커스텀 설정

Android SDK는 기본적으로 푸시 딥링크를 따라갈 때 호스트 앱의 메인 런처 액티비티를 백 스택에 배치합니다. Braze를 사용하면 메인 런처 액티비티 대신 백 스택에서 열릴 커스텀 액티비티를 설정하거나 백 스택을 완전히 비활성화할 수 있습니다.

예를 들어, 런타임 구성을 사용하여 YourMainActivity라는 액티비티를 백 스택 액티비티로 설정하려면 다음과 같이 합니다.

• java
• kotlin

1
2
3
4
5

BrazeConfig brazeConfig = new BrazeConfig.Builder()
        .setPushDeepLinkBackStackActivityEnabled(true)
        .setPushDeepLinkBackStackActivityClass(YourMainActivity.class)
        .build();
Braze.configure(this, brazeConfig);

1
2
3
4
5

val brazeConfig = BrazeConfig.Builder()
        .setPushDeepLinkBackStackActivityEnabled(true)
        .setPushDeepLinkBackStackActivityClass(YourMainActivity.class)
        .build()
Braze.configure(this, brazeConfig)

braze.xml에 대한 동등한 구성은 다음을 참조하세요. 클래스 이름은 Class.forName()이 반환하는 것과 동일해야 합니다.

1
2

<bool name="com_braze_push_deep_link_back_stack_activity_enabled">true</bool>
<string name="com_braze_push_deep_link_back_stack_activity_class_name">your.package.name.YourMainActivity</string>

5단계: 알림 채널 정의

Braze Android SDK는 Android 알림 채널을 지원합니다. Braze 알림에 알림 채널 ID가 포함되어 있지 않거나 잘못된 채널 ID가 포함된 경우, Braze는 SDK에 정의된 기본 알림 채널로 알림을 표시합니다. 회사 사용자는 플랫폼 내에서 Android 알림 채널을 사용하여 알림을 그룹화합니다.

기본 Braze 알림 채널의 사용자 표시 이름을 설정하려면 BrazeConfig.setDefaultNotificationChannelName()을 사용하세요.

기본 Braze 알림 채널의 사용자 표시 설명을 설정하려면 BrazeConfig.setDefaultNotificationChannelDescription()을 사용하세요.

API Campaigns에 Android 푸시 오브젝트 매개변수를 업데이트하여 notification_channel 필드를 포함하세요. 이 필드를 지정하지 않으면, Braze는 대시보드 대체 채널 ID로 알림 페이로드를 전송합니다.

기본 알림 채널 외에 Braze는 어떤 채널도 생성하지 않습니다. 다른 모든 채널은 호스트 앱에서 프로그래밍 방식으로 정의한 후 Braze 대시보드에 입력해야 합니다.

기본 채널 이름과 설명은 braze.xml에서도 구성할 수 있습니다.

1
2

<string name="com_braze_default_notification_channel_name">Your channel name</string>
<string name="com_braze_default_notification_channel_description">Your channel description</string>

6단계: 알림 표시 및 분석 테스트

표시 테스트

이 시점에서 Braze에서 보낸 알림을 확인할 수 있어야 합니다. 테스트하려면 Braze 대시보드의 Campaigns 페이지로 이동하여 푸시 알림 Campaign을 만드세요. Android Push를 선택하고 메시지를 디자인합니다. 그런 다음 작성기에서 눈 모양 아이콘을 클릭하여 테스트 발신자를 띄우세요. 현재 사용자의 사용자 ID 또는 이메일 주소를 입력하고 테스트 전송을 클릭합니다. 기기에 푸시가 표시되어야 합니다.

푸시 표시 관련 문제는 문제 해결 가이드를 참조하세요.

분석 테스트

이 시점에서 푸시 알림 열람에 대한 분석 로깅도 작동해야 합니다. 알림이 도착했을 때 클릭하면 Campaign 결과 페이지에서 직접 열람 수가 1 증가해야 합니다. 푸시 분석에 대한 자세한 내용은 푸시 리포팅 문서를 참조하세요.

푸시 분석 관련 문제는 문제 해결 가이드를 참조하세요.

커맨드 라인에서 테스트

커맨드 라인 인터페이스를 통해 인앱 및 푸시 알림을 테스트하려면, cURL과 메시징 API를 사용하여 터미널에서 단일 알림을 전송할 수 있습니다. 테스트 케이스에 맞는 올바른 값으로 다음 필드를 교체해야 합니다.

• YOUR_API_KEY (설정 > API 키로 이동합니다.)
• YOUR_EXTERNAL_USER_ID (사용자 검색 페이지에서 프로필을 검색합니다.)
• YOUR_KEY1 (선택 사항)
• YOUR_VALUE1 (선택 사항)

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

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {YOUR_API_KEY}" -d '{
  "external_user_ids":["YOUR_EXTERNAL_USER_ID"],
  "messages": {
    "android_push": {
      "title":"Test push title",
      "alert":"Test push",
      "extra": {
        "YOUR_KEY1":"YOUR_VALUE1"
      }
    }
  }
}' https://rest.iad-01.braze.com/messages/send

이 예시는 US-01 인스턴스를 사용합니다. 이 인스턴스에 해당하지 않는 경우 US-01 엔드포인트를 사용 중인 엔드포인트로 교체하세요.

대화형 푸시 알림

사람 및 대화 이니셔티브는 휴대폰의 시스템 표면에서 사람과 대화를 더 돋보이게 하기 위한 Android의 다년간 이니셔티브입니다. 이 우선순위는 다른 사람들과의 커뮤니케이션 및 상호작용이 모든 인구 통계에 걸쳐 대다수 Android 사용자에게 여전히 가장 가치 있고 중요한 기능 영역이라는 사실에 기반합니다.

사용 요건

• 이 알림 유형은 Braze Android SDK v15.0.0 이상 및 Android 11 이상 기기가 필요합니다.
• 지원되지 않는 기기 또는 SDK는 표준 푸시 알림으로 대체됩니다.

이 기능은 Braze REST API를 통해서만 사용할 수 있습니다. 자세한 내용은 Android 푸시 오브젝트를 참조하세요.

FCM 할당량 초과 오류

Firebase Cloud Messaging(FCM) 할당량이 초과되면 Google은 “할당량 초과” 오류를 반환합니다. FCM의 기본 제한은 분당 600,000건의 요청입니다. Braze는 Google의 권장 모범 사례에 따라 전송을 재시도합니다. 그러나 이러한 오류가 대량으로 발생하면 전송 시간이 몇 분 더 길어질 수 있습니다. 잠재적인 영향을 완화하기 위해, Braze는 사용량 제한이 초과되고 있다는 알림과 오류를 방지하기 위해 취할 수 있는 조치를 안내합니다.

현재 제한을 확인하려면 Google Cloud Console > APIs & Services > Firebase Cloud Messaging API > Quotas & System Limits로 이동하거나 FCM API 할당량 페이지를 방문하세요.

모범 사례

이러한 오류 발생량을 낮게 유지하기 위해 다음 모범 사례를 권장합니다.

FCM에 사용량 제한 증가 요청하기

FCM에 사용량 제한 증가를 요청하려면 Firebase 지원팀에 직접 문의하거나 다음을 수행하세요.

1. FCM API 할당량 페이지로 이동합니다.
2. Send requests per minute 할당량을 찾습니다.
3. Edit Quota를 선택합니다.
4. 새 값을 입력하고 요청을 제출합니다.

워크스페이스 사용량 제한 적용하기

Android 푸시 알림에 워크스페이스 사용량 제한을 적용할 수 있습니다. 이를 통해 발신 메시지의 전송 속도를 조절할 수 있습니다. 자세한 내용은 워크스페이스 메시징 사용량 제한을 참조하세요.