푸시 알림 사용자 지정

Prerequisites

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

푸시 이벤트에 콜백 사용

Braze는 푸시 알림을 수신하거나 열람하거나 해제하는 경우에 대한 subscribeToPushNotificationEvents() 콜백을 제공합니다. 애플리케이션이 실행되지 않는 동안 발생하는 이벤트를 놓치지 않도록 Application.onCreate()에 이 콜백을 배치하는 것이 좋습니다.

• 자바
• 코틀린

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
Braze.getInstance(context).subscribeToPushNotificationEvents(event -> {
  final BrazeNotificationPayload parsedData = event.getNotificationPayload();

  //
  // The type of notification itself
  //
  final boolean isPushOpenEvent = event.getEventType() == BrazePushEventType.NOTIFICATION_OPENED;
  final boolean isPushReceivedEvent = event.getEventType() == BrazePushEventType.NOTIFICATION_RECEIVED;
  // Sent when a user has dismissed a notification
  final boolean isPushDeletedEvent = event.getEventType() == BrazePushEventType.NOTIFICATION_DELETED;

  //
  // Notification data
  //
  final String pushTitle = parsedData.getTitleText();
  final Long pushArrivalTimeMs = parsedData.getNotificationReceivedTimestampMillis();
  final String deeplink = parsedData.getDeeplink();

  //
  // Custom KVP data
  //
  final String myCustomKvp1 = parsedData.getBrazeExtras().getString("my first kvp");
  final String myCustomKvp2 = parsedData.getBrazeExtras().getString("my second kvp");
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
Braze.getInstance(context).subscribeToPushNotificationEvents { event ->
    val parsedData = event.notificationPayload

    //
    // The type of notification itself
    //
    val isPushOpenEvent = event.eventType == BrazePushEventType.NOTIFICATION_OPENED
    val isPushReceivedEvent = event.eventType == BrazePushEventType.NOTIFICATION_RECEIVED
    // Sent when a user has dismissed a notification
    val isPushDeletedEvent = event.eventType == BrazePushEventType.NOTIFICATION_DELETED

    //
    // Notification data
    //
    val pushTitle = parsedData.titleText
    val pushArrivalTimeMs = parsedData.notificationReceivedTimestampMillis
    val deeplink = parsedData.deeplink

    //
    // Custom KVP data
    //
    val myCustomKvp1 = parsedData.brazeExtras.getString("my first kvp")
    val myCustomKvp2 = parsedData.brazeExtras.getString("my second kvp")
}

글꼴 사용자 지정

1단계: 글꼴 패밀리 만들기

다음은 글꼴 패밀리 가이드를 사용한 사용자 정의 글꼴 패밀리 정의 예시입니다. 이 예제에서는 Bungee Shade 글꼴을 사용합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<?xml version="1.0" encoding="utf-8"?>
<font-family xmlns:android="http://schemas.android.com/apk/res/android"
             xmlns:app="http://schemas.android.com/apk/res-auto">

  <!--Note: You must declare both sets of attributes
      so that your fonts load on devices running Android 8.0 (API level 26) or lower.
      See https://developer.android.com/guide/topics/ui/look-and-feel/fonts-in-xml.html -->

  <font android:fontStyle="normal"
        android:fontWeight="400"
        android:font="@font/bungeeshade"

        app:fontStyle="normal"
        app:fontWeight="400"
        app:font="@font/bungeeshade"/>
</font-family>

글꼴 패밀리 정의를 /res/font/bungee_font_family.xml에 저장한 후 XML에서 @font/bungee_font_family로 참조할 수 있습니다.

2단계: 글꼴 패밀리 참조

이제 글꼴 패밀리가 생성되었으므로 styles.xml 에서 Braze 스타일 기본값을 재정의하여 글꼴 패밀리에 대한 참조를 포함할 수 있습니다.

예를 들어, 다음 스타일 재정의는 모든 Braze 인앱 메시지에 대해 bungee 글꼴 패밀리를 사용합니다.

1
2
3
4
5
6
7
8
9
<style name="Braze.InAppMessage">
  <item name="android:fontFamily">@font/bungee_font_family</item>
  <item name="fontFamily">@font/bungee_font_family</item>
</style>

<style name="Braze.Cards">
  <item name="android:fontFamily">@font/another_custom_font_family</item>
  <item name="fontFamily">@font/another_custom_font_family</item>
</style>

알림 표시 사용자 지정하기

1단계: 사용자 지정 알림 팩토리 만들기

일부 시나리오에서는 서버 측에서 번거롭거나 사용할 수 없는 방식으로 푸시 알림을 사용자 지정하고 싶을 수 있습니다. 알림 표시를 완벽하게 제어할 수 있도록, 사용자가 IBrazeNotificationFactory를 정의하여 Braze에서 표시할 알림 개체를 생성하는 기능을 추가했습니다.

커스텀 IBrazeNotificationFactory를 설정한 경우, 사용자에게 알림이 표시되기 전에 푸시 수신 시 Braze가 팩토리의 createNotification() 메서드를 호출합니다. Braze는 Braze 푸시 데이터를 포함하는 Bundle 및 대시보드 또는 메시징 API를 통해 전송된 커스텀 키-값 페어를 포함하는 다른 Bundle을 전달합니다.

Braze 푸시 알림에 BrazeNotificationPayload 에 Braze 푸시 알림의 데이터가 포함된 파일을 전달합니다.

• 자바
• 코틀린

1
2
3
4
5
6
7
8
9
// Factory method implemented in your custom IBrazeNotificationFactory
@Override
public Notification createNotification(BrazeNotificationPayload brazeNotificationPayload) {
  // Example of getting notification title
  String title = brazeNotificationPayload.getTitleText();

  // Example of retrieving a custom KVP ("my_key" -> "my_value")
  String customKvp = brazeNotificationPayload.getBrazeExtras().getString("my_key");
}

1
2
3
4
5
6
7
8
// Factory method implemented in your custom IBrazeNotificationFactory
override fun createNotification(brazeNotificationPayload: BrazeNotificationPayload): Notification {
  // Example of getting notification title
  val title = brazeNotificationPayload.getTitleText()

  // Example of retrieving a custom KVP ("my_key" -> "my_value")
  val customKvp = brazeNotificationPayload.getBrazeExtras().getString("my_key")
}

알림을 전혀 표시하지 않도록 커스텀 createNotification() 메서드에서 null을 반환하거나 해당 데이터에 대한 기본 notification 오브젝트를 가져와서 표시하기 전에 수정하도록 BrazeNotificationFactory.getInstance().createNotification()을 사용하거나 표시하도록 완전히 분리된 notification 오브젝트를 생성할 수 있습니다.

2단계: 커스텀 알림 팩토리 설정

커스텀 알림 팩토리를 사용하도록 Braze에 지시하려면 setCustomBrazeNotificationFactory 메서드를 사용하여 IBrazeNotificationFactory를 설정합니다.

• 자바
• 코틀린

1
setCustomBrazeNotificationFactory(IBrazeNotificationFactory brazeNotificationFactory);

1
setCustomBrazeNotificationFactory(brazeNotificationFactory: IBrazeNotificationFactory)

커스텀 IBrazeNotificationFactory를 설정하는 권장 위치는 Application.onCreate() 애플리케이션 수명 주기 메서드(활동이 아님)입니다. 그러면 앱 프로세스가 활성화될 때마다 알림 팩토리를 올바르게 설정할 수 있습니다.

커스텀 IBrazeNotificationFactory를 해제하고 푸시에 대한 기본 Braze 처리로 돌아가려면 커스텀 알림 팩토리 설정자에게 null을 전달합니다.

• 자바
• 코틀린

1
setCustomBrazeNotificationFactory(null);

1
setCustomBrazeNotificationFactory(null)

승수 텍스트 렌더링

Braze SDK 버전 3.1.1에서 HTML을 기기로 보내 푸시 알림에서 승수 텍스트를 렌더링할 수 있습니다.

이 예제는 다음 HTML로 렌더링됩니다:

1
2
3
<p><span style="color: #99cc00;">M</span>u<span style="color: #008080;">lti</span>Colo<span style="color: #ff6600;">r</span> <span style="color: #000080;">P</span><span style="color: #00ccff;">u</span><span style="color: #ff0000;">s</span><span style="color: #808080;">h</span></p>

<p><em>test</em> <span style="text-decoration: underline; background-color: #ff6600;"><strong>message</strong></span></p>

Android는 푸시 알림에 유효한 HTML 요소와 태그를 제한한다는 점에 유의하세요. 예를 들어, marquee는 허용되지 않습니다.

푸시 알림에 여러 색상의 텍스트를 렌더링하려면 braze.xml 또는 BrazeConfig 을 업데이트하면 됩니다:

• braze.xml
• brazeconfig

1
<bool translatable="false" name="com_braze_push_notification_html_rendering_enabled">true</bool>

1
2
3
4
BrazeConfig brazeConfig = new BrazeConfig.Builder()
  .setPushHtmlRenderingEnabled(true)
  .build();
Braze.configure(this, brazeConfig);

1
2
3
4
val brazeConfig = BrazeConfig.Builder()
    .setPushHtmlRenderingEnabled(true)
    .build()
Braze.configure(this, brazeConfig)

지원되는 HTML 태그

현재 Google은 Android용 지원 HTML 태그를 문서에 직접 나열하지 않으며, 이 정보는 Git 저장소의 Html.java 파일에서만 확인할 수 있습니다. 이 정보는 이 파일에서 가져온 것이며 지원되는 HTML 태그는 변경될 수 있으므로 다음 표를 참조할 때 이 점을 염두에 두세요.

인라인 이미지 렌더링

How it works

인라인 이미지 푸시를 사용하여 Android 푸시 알림에 더 큰 이미지를 표시할 수 있습니다. 이 디자인을 사용하면 사용자가 이미지를 확대하기 위해 수동으로 푸시를 확장할 필요가 없습니다. 일반 Android 푸시 알림과 달리 인라인 이미지 푸시 이미지는 3:2 화면 비율로 제공됩니다.

호환성

모든 디바이스에 인라인 이미지를 보낼 수 있지만, 최소 버전을 충족하지 않는 디바이스 및 SDK에는 표준 이미지가 대신 표시됩니다. 인라인 이미지가 제대로 표시되려면 Android Braze SDK v10.0.0+와 Android M+를 실행하는 디바이스가 모두 필요합니다.

인라인 이미지 푸시 보내기

Android 푸시 메시지를 작성할 때 알림 유형 드롭다운에서 이 기능을 사용할 수 있습니다.

설정

Braze 대시보드를 통해 전송되는 Android 푸시 알림에는 다양한 고급 설정을 사용할 수 있습니다. 이 기사에서는 이러한 기능과 성공적으로 사용하는 방법에 대해 설명합니다.

알림 ID

알림 ID는 선택한 메시지 카테고리에 대한 고유 식별자로, 메시징 서비스에 해당 ID의 가장 최근 메시지만 고려하도록 알립니다. 알림 ID를 설정하면 오래되고 관련성이 없는 메시지 더미 대신 가장 최근의 관련성 있는 메시지만 보낼 수 있습니다.

Firebase 메시징 전송 우선순위

Firebase 메시징 전송 우선순위 필드를 통해 푸시 전송 우선순위를 ‘일반’ 또는 ‘높음’으로 설정하여 Firebase 클라우드 메시징에 전송할지 여부를 제어할 수 있습니다.

TTL

TTL( Time to Live ) 필드에서는 푸시 메시징 서비스에 메시지를 저장할 사용자 지정 기간을 설정할 수 있습니다. TTL의 기본값은 FCM의 경우 4주, ADM의 경우 31일입니다.

요약 텍스트

요약 텍스트를 사용하면 확장된 알림 보기에서 추가 텍스트를 설정할 수 있습니다. 이미지가 포함된 알림의 캡션 역할도 합니다.

요약 텍스트는 확장된 보기에서 메시지 본문 아래에 표시됩니다.

푸시 알림에 이미지가 포함된 경우, 메시지 텍스트는 축소된 보기에서 표시되며, 요약 텍스트는 알림이 확장될 때 이미지 캡션으로 표시됩니다.

사용자 지정 URI

사용자 지정 URI 기능을 사용하면 알림을 클릭할 때 이동할 웹 URL 또는 Android 리소스를 지정할 수 있습니다. 사용자 지정 URI가 지정되지 않은 경우 알림을 클릭하면 사용자가 앱으로 이동합니다. 커스텀 URI를 사용하여 앱 내부에 딥링킹하고 사용자를 앱 외부에 존재하는 리소스로 연결할 수 있습니다. 이는 그림과 같이 메시징 API 또는 푸시 작성기의 고급 설정 아래의 대시보드를 통해 지정할 수 있습니다:

알림 표시 우선순위

푸시 알림의 우선순위 수준은 다른 알림에 비해 알림 트레이에 표시되는 방식에 영향을 미칩니다. 또한 우선순위가 일반 이하인 메시지는 배터리 수명을 보존하기 위해 지연 시간이 약간 더 길어지거나 일괄 발송되는 반면, 우선순위가 높은 메시지는 항상 즉시 발송되므로 전송 속도와 방식에도 영향을 줄 수 있습니다.

Android O에서는 알림 우선 순위가 알림 채널의 속성이 되었습니다. 채널의 구성 중 우선순위를 정의하려면 개발자와 협력해야 하며, 알림 소리를 보낼 때 적절한 채널을 선택하려면 대시보드를 사용해야 합니다. Android O 이전 버전을 실행하는 디바이스의 경우, Braze 대시보드 및 메시징 API를 통해 Android 알림의 우선순위를 지정할 수 있습니다.

전체 사용자에게 특정 우선순위를 지정하여 메시지를 보내려면 알림 채널 구성을 통해 간접적으로 우선순위를 지정하고 (O+ 디바이스 대상) 대시보드에서 개별 우선순위를 전송하는 것이 좋습니다(<O 디바이스 대상).

Android 또는 Fire OS 푸시 알림에서 설정할 수 있는 우선 순위 수준은 다음과 같습니다:

자세한 내용은 Google의 Android 알림 문서를 참조하세요.

소리

Android O에서는 알림 소리가 알림 채널의 속성이 되었습니다. 개발자와 협력하여 채널을 구성하는 동안 채널의 사운드를 정의한 다음 대시보드를 사용하여 알림을 보낼 때 적절한 채널을 선택해야 합니다.

Android O 이전 버전을 실행하는 디바이스의 경우, Braze를 사용하면 대시보드 작성기를 통해 개별 푸시 메시지의 사운드를 설정할 수 있습니다. 기기에서 로컬 사운드 리소스를 지정하면 됩니다(예: android.resource://com.mycompany.myapp/raw/mysound). 이 필드에서 ‘기본값’을 지정하면 기기에서 기본 알림 사운드가 재생됩니다. 이는 메시징 API 또는 푸시 작성기의 고급 설정 아래의 대시보드를 통해 지정할 수 있습니다.

대시보드 프롬프트에 전체 사운드 리소스 URI(예: android.resource://com.mycompany.myapp/raw/mysound)를 입력합니다.

전체 사용자에게 특정 사운드로 메시지를 보내려면 알림 채널 구성을 통해 간접적으로 사운드를 지정하고 (O+ 디바이스 대상) 대시보드에서 개별 사운드를 전송하는 방법(<O 디바이스 대상)을 권장합니다.