인앱 메시지 통합

이 참조 문서에서는 Android 또는 FireOS 애플리케이션에서 인앱 메시징을 통합하는 방법을 다룹니다.

인앱 메시지는 푸시 알림을 통해 사용자의 일과를 방해하지 않고 콘텐츠를 전달할 수 있도록 도와줍니다. 사용자 지정 및 맞춤 조정된 인앱 메시지는 사용자 경험을 향상시키고 오디언스가 앱에서 최대한의 가치를 얻을 수 있도록 도와줍니다. 다양한 레이아웃과 사용자 지정 툴을 선택하여 인앱 메시지를 통해 그 어느 때보다 높은 사용자 참여를 유도할 수 있습니다.

인앱 메시지의 예제를 보려면 사례 연구를 참조하세요.

인앱 메시지 유형

Braze는 메시지, 이미지, 폰트 어썸 아이콘, 클릭 액션, 분석, 편집 가능한 스타일링 및 색 구성표로 각각 사용자 지정할 수 있는 여러 가지 기본 인앱 메시지 유형을 제공합니다. 현재 사용 가능한 유형은 다음과 같습니다:

• Slideup
• Modal
• Full
• HTML

커스텀 인앱 메시지 보기를 정의할 수도 있습니다.

모든 인앱 메시지는 모든 인앱 메시지의 기본 동작과 특성을 정의하는 IInAppMessage 인터페이스를 구현합니다. InAppMessageBase에서는 IInAppMessage를 구현하고 기본 인앱 메시지 구현을 제공하는 추상 클래스입니다. 모든 인앱 메시지 클래스는 InAppMessageBase 의 하위 클래스입니다.

또한 IInAppMessageImmersive라고 하는 IInAppMessage의 서브인터페이스가 있습니다. 여기에서는 클릭 동작 및 분석 지원 버튼과 헤더 텍스트 및 닫기 버튼을 추가합니다.

InAppMessageImmersiveBase는 IInAppMessageImmersive를 구현하고 기본 immersive 인앱 메시지 구현을 제공하는 추상 클래스입니다. Modal 인앱 메시지는 InAppMessageImmersiveBase의 서브클래스입니다.

HTML 인앱 메시지는 InAppMessageHtml 인스턴스로 구현되며, 이는 IInAppMessageHtml의 또 다른 서브클래스인 IInAppMessage을 구현하는 인스턴스입니다.

메시지 유형별 예상 동작

다음은 사용자가 기본 인앱 메시지 유형 중 하나를 여는 상황입니다.

• 슬라이드업
• 모달
• 전체 화면
• 사용자 지정 html

사용자 지정 인앱 메시지 유형 정의

slideup 인앱 메시지 오브젝트는 InAppMessageBase를 확장합니다. full 및 modal 유형 메시지는 InAppMessageImmersiveBase를 확장합니다. 이러한 클래스 중 하나를 확장하면 로컬에서 생성된 인앱 메시지에 사용자 지정 기능을 추가할 수 있습니다.

통합

1단계: Braze 인앱 메시지 관리자 등록

인앱 메시지 표시는 BrazeInAppMessageManager 클래스에 의해 관리됩니다. 앱의 모든 활동을 BrazeInAppMessageManager에 등록해야 인앱 메시지 보기를 보기 계층 구조에 추가할 수 있습니다. 이를 달성하는 방법에는 두 가지가 있습니다:

활동 수명 주기 콜백 통합(권장)

활동 수명 주기 콜백 통합은 인앱 메시지 등록을 자동으로 처리하므로 추가 통합이 필요하지 않습니다. 인앱 메시지 등록을 처리하는 데 권장되는 통합입니다.

수동 인앱 메시지 등록

먼저 Application.onCreate()에서 ensureSubscribedToInAppMessageEvents()를 호출합니다.

• java
• kotlin

1
BrazeInAppMessageManager.getInstance().ensureSubscribedToInAppMessageEvents(context);

1
BrazeInAppMessageManager.getInstance().ensureSubscribedToInAppMessageEvents(context)

다음으로, 인앱 메시지를 표시할 수 있는 모든 활동에서 registerInAppMessageManager()를 해당 활동의 onResume()에서 호출해야 합니다.

• java
• kotlin

1
2
3
4
5
6
7
@Override
public void onResume() {
  super.onResume();
  // Registers the BrazeInAppMessageManager for the current Activity. This Activity will now listen for
  // in-app messages from Braze.
  BrazeInAppMessageManager.getInstance().registerInAppMessageManager(activity);
}

1
2
3
4
5
6
public override fun onResume() {
  super.onResume()
  // Registers the BrazeInAppMessageManager for the current Activity. This Activity will now listen for
  // in-app messages from Braze.
  BrazeInAppMessageManager.getInstance().registerInAppMessageManager(this)
}

마지막으로, registerInAppMessageManager()가 호출된 모든 활동에서 unregisterInAppMessageManager()는 해당 활동의 onPause()에서 호출해야 합니다.

• java
• kotlin

1
2
3
4
5
6
@Override
public void onPause() {
  super.onPause();
  // Unregisters the BrazeInAppMessageManager for the current Activity.
  BrazeInAppMessageManager.getInstance().unregisterInAppMessageManager(activity);
}

1
2
3
4
5
public override fun onPause() {
  super.onPause()
  // Unregisters the BrazeInAppMessageManager.
  BrazeInAppMessageManager.getInstance().unregisterInAppMessageManager(this)
}

2단계: 인앱 메시지 관리자 차단 목록(선택 사항)

통합 시 앱의 특정 활동이 인앱 메시지를 표시하지 않도록 요구할 수 있습니다. 활동 수명 주기 콜백 통합은 이를 쉽게 수행할 수 있는 방법을 제공합니다.

다음 샘플 코드에서는 인앱 메시지 등록 차단 목록에 두 가지 활동(SplashActivity 및 SettingsActivity)을 추가합니다.

• java
• kotlin

1
2
3
4
5
6
7
8
9
10
public class MyApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    Set<Class> inAppMessageBlocklist = new HashSet<>();
    inAppMessageBlocklist.add(SplashActivity.class);
    inAppMessageBlocklist.add(SettingsActivity.class);
    registerActivityLifecycleCallbacks(new BrazeActivityLifecycleCallbackListener(inAppMessageBlocklist));
  }
}

1
2
3
4
5
6
7
8
9
class MyApplication : Application() {
  override fun onCreate() {
    super.onCreate()
    val inAppMessageBlocklist = HashSet<Class<*>>()
    inAppMessageBlocklist.add(SplashActivity::class.java)
    inAppMessageBlocklist.add(SettingsActivity::class.java)
    registerActivityLifecycleCallbacks(BrazeActivityLifecycleCallbackListener(inAppMessageBlocklist))
  }
}