인앱 메시지
인앱 메시지와 Braze SDK에 대한 설정 방법에 대해 알아보세요.
필수 조건
이 기능을 사용하려면 먼저 Web Braze SDK를 통합해야 합니다. 그러나 추가 설정은 필요하지 않습니다.
메시지 유형
모든 인앱 메시지는 모든 인앱 메시지의 기본 동작과 특성을 정의하는 InAppMessage에서 프로토타입을 상속하며, 이는 모든 인앱 메시지의 기본 동작과 특성을 정의합니다. 대표적인 서브클래스는 SlideUpMessage, ModalMessage, FullScreenMessage와 HtmlMessage.
각 인앱 메시지 유형은 콘텐츠, 이미지, 아이콘, 클릭 동작, 분석, 표시 및 전달 전반에 걸쳐 사용자 지정 가능합니다.
SlideUp 인앱 메시지는 전통적으로 모바일 플랫폼에서 화면 위나 아래에서 ‘슬라이드 업’ 또는 ‘슬라이드 다운’되기 때문에 그렇게 명명되었습니다. Braze 웹 SDK에서 이러한 메시지가 웹의 주요 패러다임에 맞춰 Growl 또는 Toast 스타일의 알림으로 표시됩니다. 화면의 작은 부분을 차지하며 효과적이고 방해가 되지 않는 메시징 기능을 제공합니다.
Modal 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 보다 중요한 메시징에 유용하며, 최대 두 개의 클릭 동작과 분석 지원 버튼을 제공할 수 있습니다.
Full 인앱 메시지는 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. 좁은 브라우저 창(예: 모바일 웹)에서는 full 인앱 메시지는 전체 브라우저 창을 차지합니다. 더 큰 브라우저 창에서는 full 인앱 메시지가 modal 인앱 메시지와 비슷하게 표시됩니다. full 인앱 메시지의 상단에는 이미지가 있고, 하단에는 최대 8줄의 텍스트와 최대 2개의 클릭 동작 및 분석 지원 버튼이 표시됩니다.
HTML 인앱 메시지는 완전히 맞춤화된 사용자 콘텐츠를 만드는 데 유용합니다. 사용자 정의 HTML은 iFrame에 표시되며, 이미지, 글꼴, 비디오와 같은 다양한 형식의 콘텐츠를 포함할 수 있으므로 메시지 모양과 기능을 완벽하게 제어할 수 있습니다. 이 기능은 HTML 내에서 Braze 웹 SDK의 메서드를 호출하기 위해 JavaScript brazeBridge 인터페이스를 지원합니다. 자세한 내용은 모범 사례를 참조하세요.
웹 SDK를 통해 HTML 인앱 메시지를 활성화하려면 Braze에 allowUserSuppliedJavascript 초기화 옵션을 제공해야 합니다(예: braze.initialize('YOUR-API_KEY', {allowUserSuppliedJavascript: true})). 이는 보안상의 이유 때문입니다. HTML 인앱 메시지는 JavaScript를 실행할 수 있으므로 사이트 관리자가 이를 활성화해야 합니다.
다음 예는 페이지가 지정된 HTML 인앱 메시지를 보여줍니다:
필수 조건
이 기능을 사용하려면 먼저 Android Braze SDK를 통합해야 합니다. 인앱 메시지를 활성화해야 합니다.
메시지 유형
Braze는 각기 다른 기본 인앱 메시지 유형을 제공하며, 메시지, 이미지, Font Awesome 아이콘, 클릭 액션, 분석, 색상 구성표 등을 사용하여 사용자 정의할 수 있습니다.
그들의 기본 동작과 특성은 IInAppMessage 인터페이스에 의해 정의되며, InAppMessageBase라는 하위 클래스에 있습니다. IInAppMessage는 또한 닫기, 클릭 액션 및 분석 버튼을 앱에 추가할 수 있는 하위 인터페이스 IInAppMessageImmersive를 포함합니다.
버튼이 포함된 인앱 메시지는 클릭 액션이 버튼 텍스트를 추가하기 전에 추가된 경우 최종 페이로드에 clickAction 메시지를 포함합니다.
slideup 인앱 메시지는 화면 상단 또는 하단에서 ‘슬라이드 업’ 또는 ‘슬라이드 다운’되기 때문에 그렇게 이름이 붙여졌습니다. 화면의 작은 부분을 차지하며 효과적이고 방해가 되지 않는 메시징 기능을 제공합니다.
slideup 인앱 메시지 오브젝트는 InAppMessageBase를 확장합니다.
modal 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 보다 중요한 메시징에 유용하며, 두 개의 클릭 동작과 분석 지원 버튼을 제공할 수 있습니다.
이 메시지 유형은 InAppMessageImmersiveBase의 하위 클래스이며, IInAppMessageImmersive을 구현하는 추상 클래스입니다. 이를 통해 로컬에서 생성된 인앱 메시지에 사용자 정의 기능을 추가할 수 있는 옵션을 제공합니다.
full 인앱 메시지는 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. full 인앱 메시지의 상단에는 이미지가, 하단에는 텍스트와 최대 2개의 클릭 동작 및 분석 지원 버튼이 표시됩니다.
이 메시지 유형은 InAppMessageImmersiveBase을 확장하여 로컬에서 생성된 인앱 메시지에 사용자 정의 기능을 추가할 수 있는 옵션을 제공합니다.
HTML 인앱 메시지는 완전히 맞춤화된 사용자 콘텐츠를 만드는 데 유용합니다. 사용자 정의 HTML 인앱 메시지 콘텐츠는 WebView에 표시되며, 선택적으로 이미지 및 글꼴과 같은 다양한 형식의 기타 콘텐츠를 포함할 수 있으므로 메시지 모양과 기능을 완벽하게 제어할 수 있습니다.
이 메시지 유형은 IInAppMessageHtml을 구현하며, 이는 IInAppMessage의 하위 클래스입니다.
Android에서는 사용자 정의 HTML 인앱 메시지에서 target="_blank"로 구성된 링크가 기기의 기본 웹 브라우저에서 열립니다.
Android 인앱 메시지는 HTML 내에서 Braze Android SDK의 메서드를 호출하기 위한 JavaScript brazeBridge 인터페이스를 지원합니다. 자세한 내용은 JavaScript bridge 페이지를 참조하세요.
현재 iOS 및 Android 플랫폼에서는 iFrame에 커스텀 HTML 인앱 메시지를 표시하는 기능을 지원하지 않습니다.
앱에 대한 사용자 정의 인앱 메시지 뷰를 정의할 수도 있습니다. 전체 안내를 보려면 Setting custom factories를 참조하세요.
인앱 메시지 활성화
1단계: BrazeInAppMessageManager 등록하기
인앱 메시지 표시는 BrazeInAppMessageManager 클래스에 의해 관리됩니다. 앱의 모든 활동을 BrazeInAppMessageManager에 등록해야 인앱 메시지 보기를 보기 계층 구조에 추가할 수 있습니다. 이를 달성하는 방법에는 두 가지가 있습니다:
활동 수명 주기 콜백 통합은 인앱 메시지 등록을 자동으로 처리하므로 추가 통합이 필요하지 않습니다. 이것은 인앱 메시지 등록을 처리하는 권장 방법입니다.
자동 등록을 위한 활동 생명주기 콜백을 사용하는 경우, 이 단계를 완료하지 마십시오.
당신의 Application.onCreate()에서 ensureSubscribedToInAppMessageEvents()을 호출하십시오:
1
BrazeInAppMessageManager.getInstance().ensureSubscribedToInAppMessageEvents(context);
1
BrazeInAppMessageManager.getInstance().ensureSubscribedToInAppMessageEvents(context)
인앱 메시지를 표시할 수 있는 모든 활동에서 해당 활동의 onResume()에서 registerInAppMessageManager()을 호출하십시오:
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()이 호출된 모든 활동에서 해당 활동의 onPause()에서 unregisterInAppMessageManager()을 호출하십시오:
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)을 추가합니다.
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))
}
}
필수 조건
이 기능을 사용하려면 먼저 Swift Braze SDK를 통합해야 합니다. 또한 인앱 메시지를 인에이블먼트해야 합니다.
메시지 유형
각 인앱 메시지 유형은 콘텐츠, 이미지, 아이콘, 클릭 동작, 분석, 표시 및 전달 전반에 걸쳐 고도로 사용자 지정 가능합니다. 모든 인앱 메시지의 기본 동작과 특성을 정의하는 Braze.InAppMessage 의 열거된 유형입니다. 인앱 메시지 속성 및 사용법에 대한 전체 목록은 InAppMessage 클래스를 참조하세요.
다음은 Braze에서 사용할 수 있는 인앱 메시지 유형과 최종 사용자에게 표시되는 방식입니다.
Slideup 인앱 메시지는 화면 상단 또는 하단에서 “슬라이드 업” 또는 “슬라이드 다운”되기 때문에 이 이름이 붙여졌습니다. 화면의 작은 부분을 차지하며 효과적이고 방해가 되지 않는 메시징 기능을 제공합니다.
Modal 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 보다 중요한 메시징에 유용하며, 최대 두 개의 분석 지원 버튼을 제공할 수 있습니다.
Modal Image 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 이러한 메시지는 헤더나 메시지 텍스트가 없다는 점을 제외하면 Modal 유형과 유사합니다. 보다 중요한 메시징에 유용하며, 최대 두 개의 분석 지원 버튼을 제공할 수 있습니다.
Full 인앱 메시지는 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. Full 인앱 메시지의 상단에는 이미지가, 하단에는 텍스트와 최대 2개의 분석 지원 버튼이 표시됩니다.
Full Image 인앱 메시지는 헤더나 메시지 텍스트가 없다는 점을 제외하면 Full 인앱 메시지와 유사합니다. 이 메시지 유형은 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. Full Image 인앱 메시지에는 전체 화면에 걸친 이미지와 함께 최대 2개의 분석 지원 버튼을 표시하는 옵션이 포함되어 있습니다.
HTML 인앱 메시지는 완전히 맞춤화된 사용자 콘텐츠를 만드는 데 유용합니다. 사용자 정의 HTML 전체 인앱 메시지 콘텐츠는 WKWebView에 표시되며, 선택적으로 이미지 및 글꼴과 같이 다양한 형식의 기타 콘텐츠를 포함할 수 있으므로 메시지 모양과 기능을 완벽하게 제어할 수 있습니다.
iOS 인앱 메시지는 HTML 내에서 Braze 웹 SDK의 메서드를 호출하기 위해 JavaScript brazeBridge 인터페이스를 지원합니다. 자세한 내용은 모범 사례를 참조하세요.
다음 예는 페이지가 지정된 HTML 전체 인앱 메시지를 보여줍니다:
현재 iOS 및 Android 플랫폼에서는 iFrame에 커스텀 HTML 인앱 메시지를 표시하는 기능을 지원하지 않습니다.
인앱 메시지 활성화
1단계: 의 구현을 만듭니다. BrazeInAppMessagePresenter
Braze가 인앱 메시지를 표시하도록 하려면 BrazeInAppMessagePresenter 프로토콜의 구현을 생성하고 이를 Braze 인스턴스의 선택적 inAppMessagePresenter 에 할당하세요. BrazeInAppMessageUI 오브젝트를 인스턴스화하여 기본 Braze UI 프리젠터를 사용할 수도 있습니다.
BrazeInAppMessageUI 클래스에 액세스하려면 BrazeUI 라이브러리를 가져와야 합니다.
1
AppDelegate.braze?.inAppMessagePresenter = BrazeInAppMessageUI()
1
AppDelegate.braze.inAppMessagePresenter = [[BrazeInAppMessageUI alloc] init];
2단계: 일치하는 트리거 처리 안 함
구현 BrazeDelegate.(_:noMatchingTriggerForEvent) 를 관련 BrazeDelegate 클래스 내에서 구현합니다. 특정 이벤트에 대해 일치하는 트리거를 찾지 못하면 Braze는 이 메서드를 자동으로 호출합니다.
필수 조건
이 기능을 사용하려면 먼저 Android Braze SDK를 통합해야 합니다.
TV 및 OTT 지원 정보
Android Braze 소프트웨어 개발 키트는 기본적으로 Android TV 또는 Fire Stick과 같은 OTT 기기에서 인앱 메시지 표시를 지원합니다. 그러나 네이티브 Android와 OTT 인앱 메시지에는 몇 가지 주요 차이점이 있습니다. OTT 디바이스용:
- 슬라이드업과 같이 터치 모드가 필요한 인앱 메시지는 OTT에서 비활성화됩니다.
- 버튼이나 닫기 버튼과 같이 현재 선택되어 있거나 초점이 맞춰진 항목이 강조 표시됩니다.
- 버튼이 아닌 인앱 메시지 자체에서 본문 클릭은 지원되지 않습니다.
필수 조건
이 기능을 사용하려면 먼저 Cordova Braze SDK를 통합해야 합니다.
메시지 유형
Braze는 각기 다른 기본 인앱 메시지 유형을 제공하며, 메시지, 이미지, Font Awesome 아이콘, 클릭 액션, 분석, 색상 구성표 등을 사용하여 사용자 정의할 수 있습니다.
그들의 기본 동작과 특성은 IInAppMessage 인터페이스에 의해 정의되며, InAppMessageBase라는 하위 클래스에 있습니다. IInAppMessage는 또한 닫기, 클릭 액션 및 분석 버튼을 앱에 추가할 수 있는 하위 인터페이스 IInAppMessageImmersive를 포함합니다.
버튼이 포함된 인앱 메시지는 클릭 액션이 버튼 텍스트를 추가하기 전에 추가된 경우 최종 페이로드에 clickAction 메시지를 포함합니다.
slideup 인앱 메시지는 화면 상단 또는 하단에서 ‘슬라이드 업’ 또는 ‘슬라이드 다운’되기 때문에 그렇게 이름이 붙여졌습니다. 화면의 작은 부분을 차지하며 효과적이고 방해가 되지 않는 메시징 기능을 제공합니다.
slideup 인앱 메시지 오브젝트는 InAppMessageBase를 확장합니다.
modal 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 보다 중요한 메시징에 유용하며, 두 개의 클릭 동작과 분석 지원 버튼을 제공할 수 있습니다.
이 메시지 유형은 InAppMessageImmersiveBase의 하위 클래스이며, IInAppMessageImmersive을 구현하는 추상 클래스입니다. 이를 통해 로컬에서 생성된 인앱 메시지에 사용자 정의 기능을 추가할 수 있는 옵션을 제공합니다.
full 인앱 메시지는 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. full 인앱 메시지의 상단에는 이미지가, 하단에는 텍스트와 최대 2개의 클릭 동작 및 분석 지원 버튼이 표시됩니다.
이 메시지 유형은 InAppMessageImmersiveBase을 확장하여 로컬에서 생성된 인앱 메시지에 사용자 정의 기능을 추가할 수 있는 옵션을 제공합니다.
HTML 인앱 메시지는 완전히 맞춤화된 사용자 콘텐츠를 만드는 데 유용합니다. 사용자 정의 HTML 인앱 메시지 콘텐츠는 WebView에 표시되며, 선택적으로 이미지 및 글꼴과 같은 다양한 형식의 기타 콘텐츠를 포함할 수 있으므로 메시지 모양과 기능을 완벽하게 제어할 수 있습니다.
이 메시지 유형은 IInAppMessageHtml을 구현하며, 이는 IInAppMessage의 하위 클래스입니다.
Android에서는 사용자 정의 HTML 인앱 메시지에서 target="_blank"로 구성된 링크가 기기의 기본 웹 브라우저에서 열립니다.
Android 인앱 메시지는 HTML 내에서 Braze Android SDK의 메서드를 호출하기 위한 JavaScript brazeBridge 인터페이스를 지원합니다. 자세한 내용은 JavaScript bridge 페이지를 참조하세요.
현재 iOS 및 Android 플랫폼에서는 iFrame에 커스텀 HTML 인앱 메시지를 표시하는 기능을 지원하지 않습니다.
앱에 대한 사용자 정의 인앱 메시지 뷰를 정의할 수도 있습니다. 전체 안내를 보려면 Setting custom factories를 참조하세요.
각 인앱 메시지 유형은 콘텐츠, 이미지, 아이콘, 클릭 동작, 분석, 표시 및 전달 전반에 걸쳐 고도로 사용자 지정 가능합니다. 모든 인앱 메시지의 기본 동작과 특성을 정의하는 Braze.InAppMessage 의 열거된 유형입니다. 인앱 메시지 속성 및 사용법에 대한 전체 목록은 InAppMessage 클래스를 참조하세요.
다음은 Braze에서 사용할 수 있는 인앱 메시지 유형과 최종 사용자에게 표시되는 방식입니다.
Slideup 인앱 메시지는 화면 상단 또는 하단에서 “슬라이드 업” 또는 “슬라이드 다운”되기 때문에 이 이름이 붙여졌습니다. 화면의 작은 부분을 차지하며 효과적이고 방해가 되지 않는 메시징 기능을 제공합니다.
Modal 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 보다 중요한 메시징에 유용하며, 최대 두 개의 분석 지원 버튼을 제공할 수 있습니다.
Modal Image 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 이러한 메시지는 헤더나 메시지 텍스트가 없다는 점을 제외하면 Modal 유형과 유사합니다. 보다 중요한 메시징에 유용하며, 최대 두 개의 분석 지원 버튼을 제공할 수 있습니다.
Full 인앱 메시지는 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. Full 인앱 메시지의 상단에는 이미지가, 하단에는 텍스트와 최대 2개의 분석 지원 버튼이 표시됩니다.
Full Image 인앱 메시지는 헤더나 메시지 텍스트가 없다는 점을 제외하면 Full 인앱 메시지와 유사합니다. 이 메시지 유형은 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. Full Image 인앱 메시지에는 전체 화면에 걸친 이미지와 함께 최대 2개의 분석 지원 버튼을 표시하는 옵션이 포함되어 있습니다.
HTML 인앱 메시지는 완전히 맞춤화된 사용자 콘텐츠를 만드는 데 유용합니다. 사용자 정의 HTML 전체 인앱 메시지 콘텐츠는 WKWebView에 표시되며, 선택적으로 이미지 및 글꼴과 같이 다양한 형식의 기타 콘텐츠를 포함할 수 있으므로 메시지 모양과 기능을 완벽하게 제어할 수 있습니다.
iOS 인앱 메시지는 HTML 내에서 Braze 웹 SDK의 메서드를 호출하기 위해 JavaScript brazeBridge 인터페이스를 지원합니다. 자세한 내용은 모범 사례를 참조하세요.
다음 예는 페이지가 지정된 HTML 전체 인앱 메시지를 보여줍니다:
현재 iOS 및 Android 플랫폼에서는 iFrame에 커스텀 HTML 인앱 메시지를 표시하는 기능을 지원하지 않습니다.
필수 조건
이 기능을 사용하려면 먼저 Flutter Braze SDK를 통합해야 합니다.
메시지 유형
Braze는 각기 다른 기본 인앱 메시지 유형을 제공하며, 메시지, 이미지, Font Awesome 아이콘, 클릭 액션, 분석, 색상 구성표 등을 사용하여 사용자 정의할 수 있습니다.
그들의 기본 동작과 특성은 IInAppMessage 인터페이스에 의해 정의되며, InAppMessageBase라는 하위 클래스에 있습니다. IInAppMessage는 또한 닫기, 클릭 액션 및 분석 버튼을 앱에 추가할 수 있는 하위 인터페이스 IInAppMessageImmersive를 포함합니다.
버튼이 포함된 인앱 메시지는 클릭 액션이 버튼 텍스트를 추가하기 전에 추가된 경우 최종 페이로드에 clickAction 메시지를 포함합니다.
slideup 인앱 메시지는 화면 상단 또는 하단에서 ‘슬라이드 업’ 또는 ‘슬라이드 다운’되기 때문에 그렇게 이름이 붙여졌습니다. 화면의 작은 부분을 차지하며 효과적이고 방해가 되지 않는 메시징 기능을 제공합니다.
slideup 인앱 메시지 오브젝트는 InAppMessageBase를 확장합니다.
modal 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 보다 중요한 메시징에 유용하며, 두 개의 클릭 동작과 분석 지원 버튼을 제공할 수 있습니다.
이 메시지 유형은 InAppMessageImmersiveBase의 하위 클래스이며, IInAppMessageImmersive을 구현하는 추상 클래스입니다. 이를 통해 로컬에서 생성된 인앱 메시지에 사용자 정의 기능을 추가할 수 있는 옵션을 제공합니다.
full 인앱 메시지는 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. full 인앱 메시지의 상단에는 이미지가, 하단에는 텍스트와 최대 2개의 클릭 동작 및 분석 지원 버튼이 표시됩니다.
이 메시지 유형은 InAppMessageImmersiveBase을 확장하여 로컬에서 생성된 인앱 메시지에 사용자 정의 기능을 추가할 수 있는 옵션을 제공합니다.
HTML 인앱 메시지는 완전히 맞춤화된 사용자 콘텐츠를 만드는 데 유용합니다. 사용자 정의 HTML 인앱 메시지 콘텐츠는 WebView에 표시되며, 선택적으로 이미지 및 글꼴과 같은 다양한 형식의 기타 콘텐츠를 포함할 수 있으므로 메시지 모양과 기능을 완벽하게 제어할 수 있습니다.
이 메시지 유형은 IInAppMessageHtml을 구현하며, 이는 IInAppMessage의 하위 클래스입니다.
Android에서는 사용자 정의 HTML 인앱 메시지에서 target="_blank"로 구성된 링크가 기기의 기본 웹 브라우저에서 열립니다.
Android 인앱 메시지는 HTML 내에서 Braze Android SDK의 메서드를 호출하기 위한 JavaScript brazeBridge 인터페이스를 지원합니다. 자세한 내용은 JavaScript bridge 페이지를 참조하세요.
현재 iOS 및 Android 플랫폼에서는 iFrame에 커스텀 HTML 인앱 메시지를 표시하는 기능을 지원하지 않습니다.
앱에 대한 사용자 정의 인앱 메시지 뷰를 정의할 수도 있습니다. 전체 안내를 보려면 Setting custom factories를 참조하세요.
각 인앱 메시지 유형은 콘텐츠, 이미지, 아이콘, 클릭 동작, 분석, 표시 및 전달 전반에 걸쳐 고도로 사용자 지정 가능합니다. 모든 인앱 메시지의 기본 동작과 특성을 정의하는 Braze.InAppMessage 의 열거된 유형입니다. 인앱 메시지 속성 및 사용법에 대한 전체 목록은 InAppMessage 클래스를 참조하세요.
다음은 Braze에서 사용할 수 있는 인앱 메시지 유형과 최종 사용자에게 표시되는 방식입니다.
Slideup 인앱 메시지는 화면 상단 또는 하단에서 “슬라이드 업” 또는 “슬라이드 다운”되기 때문에 이 이름이 붙여졌습니다. 화면의 작은 부분을 차지하며 효과적이고 방해가 되지 않는 메시징 기능을 제공합니다.
Modal 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 보다 중요한 메시징에 유용하며, 최대 두 개의 분석 지원 버튼을 제공할 수 있습니다.
Modal Image 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 이러한 메시지는 헤더나 메시지 텍스트가 없다는 점을 제외하면 Modal 유형과 유사합니다. 보다 중요한 메시징에 유용하며, 최대 두 개의 분석 지원 버튼을 제공할 수 있습니다.
Full 인앱 메시지는 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. Full 인앱 메시지의 상단에는 이미지가, 하단에는 텍스트와 최대 2개의 분석 지원 버튼이 표시됩니다.
Full Image 인앱 메시지는 헤더나 메시지 텍스트가 없다는 점을 제외하면 Full 인앱 메시지와 유사합니다. 이 메시지 유형은 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. Full Image 인앱 메시지에는 전체 화면에 걸친 이미지와 함께 최대 2개의 분석 지원 버튼을 표시하는 옵션이 포함되어 있습니다.
HTML 인앱 메시지는 완전히 맞춤화된 사용자 콘텐츠를 만드는 데 유용합니다. 사용자 정의 HTML 전체 인앱 메시지 콘텐츠는 WKWebView에 표시되며, 선택적으로 이미지 및 글꼴과 같이 다양한 형식의 기타 콘텐츠를 포함할 수 있으므로 메시지 모양과 기능을 완벽하게 제어할 수 있습니다.
iOS 인앱 메시지는 HTML 내에서 Braze 웹 SDK의 메서드를 호출하기 위해 JavaScript brazeBridge 인터페이스를 지원합니다. 자세한 내용은 모범 사례를 참조하세요.
다음 예는 페이지가 지정된 HTML 전체 인앱 메시지를 보여줍니다:
현재 iOS 및 Android 플랫폼에서는 iFrame에 커스텀 HTML 인앱 메시지를 표시하는 기능을 지원하지 않습니다.
인앱 메시지 활성화
Braze Flutter SDK는 Android와 iOS 모두에서 기본 인앱 메시지 프레젠터를 자동으로 설정합니다. 인앱 메시지는 추가 설정 없이 표시되고 Dart 레이어로 전달됩니다.
iOS에서 인앱 메시지 프레젠터 커스터마이징하기
iOS에서 기본 인앱 메시지 프레젠터를 재정의하려면 BrazePlugin.configure(_:postInitialization:)의 postInitialization 클로저를 사용하세요. 커스텀 프레젠터는 인앱 메시지 데이터를 Dart 레이어로 전달하기 위해 BrazePlugin.processInAppMessage(message)를 호출해야 합니다.
1
2
3
4
5
6
7
8
9
10
11
import BrazeUI
BrazePlugin.configure(
{ configuration in
// Set non-API-key configurations here.
},
postInitialization: { braze in
let customPresenter = CustomInAppMessagePresenter()
braze.inAppMessagePresenter = customPresenter
}
)
커스텀 프레젠터 클래스에서 BrazePlugin.processInAppMessage(message)와 super.present(message: message)를 호출하여 데이터를 Dart로 전달하고 기본 UI를 표시합니다.
1
2
3
4
5
6
class CustomInAppMessagePresenter: BrazeInAppMessageUI {
override func present(message: Braze.InAppMessage) {
BrazePlugin.processInAppMessage(message)
super.present(message: message)
}
}
이 단계는 iOS 전용입니다. 인앱 메시지의 기본 구현은 이미 Android에 설정되어 있습니다.
iOS에서 인앱 메시지의 기본 프레젠터를 설정하려면 BrazeInAppMessagePresenter 프로토콜의 구현체를 생성하고 Braze 인스턴스의 선택 사항인 inAppMessagePresenter 속성에 할당하세요. BrazeInAppMessageUI 오브젝트를 인스턴스화하여 기본 Braze UI 프레젠터를 사용할 수도 있습니다.
BrazeInAppMessageUI 클래스에 접근하려면 BrazeUI 라이브러리를 반드시 가져와야 합니다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
import BrazeUI
override func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil
) -> Bool {
...
let braze = BrazePlugin.initBraze(configuration)
braze.inAppMessagePresenter = BrazeInAppMessageUI()
AppDelegate.braze = braze
return true
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
@import BrazeUI;
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
...
Braze *braze = [BrazePlugin initBraze:configuration];
braze.inAppMessagePresenter = [[BrazeInAppMessageUI alloc] init];
AppDelegate.braze = braze;
[self.window makeKeyAndVisible];
return YES;
}
인앱 메시지 데이터에 접근하는 방법에 대한 자세한 내용은 인앱 메시지 데이터 로깅을 참조하세요.
필수 조건
이 기능을 사용하려면 먼저 React Native Braze SDK를 통합해야 합니다.
메시지 유형
Braze는 각기 다른 기본 인앱 메시지 유형을 제공하며, 메시지, 이미지, Font Awesome 아이콘, 클릭 액션, 분석, 색상 구성표 등을 사용하여 사용자 정의할 수 있습니다.
그들의 기본 동작과 특성은 IInAppMessage 인터페이스에 의해 정의되며, InAppMessageBase라는 하위 클래스에 있습니다. IInAppMessage는 또한 닫기, 클릭 액션 및 분석 버튼을 앱에 추가할 수 있는 하위 인터페이스 IInAppMessageImmersive를 포함합니다.
버튼이 포함된 인앱 메시지는 클릭 액션이 버튼 텍스트를 추가하기 전에 추가된 경우 최종 페이로드에 clickAction 메시지를 포함합니다.
slideup 인앱 메시지는 화면 상단 또는 하단에서 ‘슬라이드 업’ 또는 ‘슬라이드 다운’되기 때문에 그렇게 이름이 붙여졌습니다. 화면의 작은 부분을 차지하며 효과적이고 방해가 되지 않는 메시징 기능을 제공합니다.
slideup 인앱 메시지 오브젝트는 InAppMessageBase를 확장합니다.
modal 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 보다 중요한 메시징에 유용하며, 두 개의 클릭 동작과 분석 지원 버튼을 제공할 수 있습니다.
이 메시지 유형은 InAppMessageImmersiveBase의 하위 클래스이며, IInAppMessageImmersive을 구현하는 추상 클래스입니다. 이를 통해 로컬에서 생성된 인앱 메시지에 사용자 정의 기능을 추가할 수 있는 옵션을 제공합니다.
full 인앱 메시지는 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. full 인앱 메시지의 상단에는 이미지가, 하단에는 텍스트와 최대 2개의 클릭 동작 및 분석 지원 버튼이 표시됩니다.
이 메시지 유형은 InAppMessageImmersiveBase을 확장하여 로컬에서 생성된 인앱 메시지에 사용자 정의 기능을 추가할 수 있는 옵션을 제공합니다.
HTML 인앱 메시지는 완전히 맞춤화된 사용자 콘텐츠를 만드는 데 유용합니다. 사용자 정의 HTML 인앱 메시지 콘텐츠는 WebView에 표시되며, 선택적으로 이미지 및 글꼴과 같은 다양한 형식의 기타 콘텐츠를 포함할 수 있으므로 메시지 모양과 기능을 완벽하게 제어할 수 있습니다.
이 메시지 유형은 IInAppMessageHtml을 구현하며, 이는 IInAppMessage의 하위 클래스입니다.
Android에서는 사용자 정의 HTML 인앱 메시지에서 target="_blank"로 구성된 링크가 기기의 기본 웹 브라우저에서 열립니다.
Android 인앱 메시지는 HTML 내에서 Braze Android SDK의 메서드를 호출하기 위한 JavaScript brazeBridge 인터페이스를 지원합니다. 자세한 내용은 JavaScript bridge 페이지를 참조하세요.
현재 iOS 및 Android 플랫폼에서는 iFrame에 커스텀 HTML 인앱 메시지를 표시하는 기능을 지원하지 않습니다.
앱에 대한 사용자 정의 인앱 메시지 뷰를 정의할 수도 있습니다. 전체 안내를 보려면 Setting custom factories를 참조하세요.
각 인앱 메시지 유형은 콘텐츠, 이미지, 아이콘, 클릭 동작, 분석, 표시 및 전달 전반에 걸쳐 고도로 사용자 지정 가능합니다. 모든 인앱 메시지의 기본 동작과 특성을 정의하는 Braze.InAppMessage 의 열거된 유형입니다. 인앱 메시지 속성 및 사용법에 대한 전체 목록은 InAppMessage 클래스를 참조하세요.
다음은 Braze에서 사용할 수 있는 인앱 메시지 유형과 최종 사용자에게 표시되는 방식입니다.
Slideup 인앱 메시지는 화면 상단 또는 하단에서 “슬라이드 업” 또는 “슬라이드 다운”되기 때문에 이 이름이 붙여졌습니다. 화면의 작은 부분을 차지하며 효과적이고 방해가 되지 않는 메시징 기능을 제공합니다.
Modal 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 보다 중요한 메시징에 유용하며, 최대 두 개의 분석 지원 버튼을 제공할 수 있습니다.
Modal Image 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 이러한 메시지는 헤더나 메시지 텍스트가 없다는 점을 제외하면 Modal 유형과 유사합니다. 보다 중요한 메시징에 유용하며, 최대 두 개의 분석 지원 버튼을 제공할 수 있습니다.
Full 인앱 메시지는 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. Full 인앱 메시지의 상단에는 이미지가, 하단에는 텍스트와 최대 2개의 분석 지원 버튼이 표시됩니다.
Full Image 인앱 메시지는 헤더나 메시지 텍스트가 없다는 점을 제외하면 Full 인앱 메시지와 유사합니다. 이 메시지 유형은 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. Full Image 인앱 메시지에는 전체 화면에 걸친 이미지와 함께 최대 2개의 분석 지원 버튼을 표시하는 옵션이 포함되어 있습니다.
HTML 인앱 메시지는 완전히 맞춤화된 사용자 콘텐츠를 만드는 데 유용합니다. 사용자 정의 HTML 전체 인앱 메시지 콘텐츠는 WKWebView에 표시되며, 선택적으로 이미지 및 글꼴과 같이 다양한 형식의 기타 콘텐츠를 포함할 수 있으므로 메시지 모양과 기능을 완벽하게 제어할 수 있습니다.
iOS 인앱 메시지는 HTML 내에서 Braze 웹 SDK의 메서드를 호출하기 위해 JavaScript brazeBridge 인터페이스를 지원합니다. 자세한 내용은 모범 사례를 참조하세요.
다음 예는 페이지가 지정된 HTML 전체 인앱 메시지를 보여줍니다:
현재 iOS 및 Android 플랫폼에서는 iFrame에 커스텀 HTML 인앱 메시지를 표시하는 기능을 지원하지 않습니다.
데이터 모델
인앱 메시지 모델은 React Native SDK에서 사용할 수 있습니다. Braze에는 동일한 데이터 모델을 공유하는 네 가지 인앱 메시지 유형(슬라이드업, 모달, 전체 및 HTML 전체)이 있습니다.
메시지
인앱 메시지 모델은 모든 인앱 메시지의 기본을 제공합니다.
| 등록정보 | 설명 |
|---|---|
inAppMessageJsonString |
메시지 JSON 표현입니다. |
message |
메시지 텍스트입니다. |
header |
메시지 헤더입니다. |
uri |
버튼 클릭 동작과 연결된 URI입니다. |
imageUrl |
메시지 이미지 URL입니다. |
zippedAssetsUrl |
HTML 콘텐츠를 표시하도록 준비된 압축된 자산입니다. |
useWebView |
버튼 클릭 동작이 웹 뷰를 사용하여 리디렉션할지 여부를 나타냅니다. |
duration |
메시지 표시 기간입니다. |
clickAction |
버튼 클릭 동작 유형입니다. 유형은 URI 및 NONE입니다. |
dismissType |
메시지 닫기 유형입니다. 두 가지 유형은 SWIPE 및 AUTO_DISMISS입니다. |
messageType |
SDK에서 지원하는 인앱 메시지 유형입니다. 네 가지 유형은 SLIDEUP, MODAL, FULL 및 HTML_FULL입니다. |
extras |
메시지 extras 사전입니다. 기본값: [:]. |
buttons |
인앱 메시지의 버튼 목록입니다. |
toString() |
문자열 표현으로서의 메시지입니다. |
인앱 메시지 모델에 대한 전체 참조는 Android 및 iOS 설명서를 참조하세요.
버튼
인앱 메시지에 버튼을 추가하여 동작을 수행하고 분석을 기록할 수 있습니다. 버튼 모델은 모든 인앱 메시지 버튼의 기본을 제공합니다.
| 등록정보 | 설명 |
|---|---|
text |
버튼의 텍스트입니다. |
uri |
버튼 클릭 동작과 연결된 URI입니다. |
useWebView |
버튼 클릭 동작이 웹 뷰를 사용하여 리디렉션할지 여부를 나타냅니다. |
clickAction |
사용자가 버튼을 클릭할 때 처리되는 클릭 동작 유형입니다. 유형은 URI 및 NONE입니다. |
id |
메시지의 버튼 ID입니다. |
toString() |
문자열 표현으로서의 버튼입니다. |
필수 조건
이 기능을 사용하려면 먼저 Roku SDK를 통합해야 합니다. 또한 인앱 메시지는 지원되는 최소 SDK 버전을 실행하는 Roku 기기로만 전송됩니다:
메시지 유형
Braze는 각기 다른 기본 인앱 메시지 유형을 제공하며, 메시지, 이미지, Font Awesome 아이콘, 클릭 액션, 분석, 색상 구성표 등을 사용하여 사용자 정의할 수 있습니다.
그들의 기본 동작과 특성은 IInAppMessage 인터페이스에 의해 정의되며, InAppMessageBase라는 하위 클래스에 있습니다. IInAppMessage는 또한 닫기, 클릭 액션 및 분석 버튼을 앱에 추가할 수 있는 하위 인터페이스 IInAppMessageImmersive를 포함합니다.
버튼이 포함된 인앱 메시지는 클릭 액션이 버튼 텍스트를 추가하기 전에 추가된 경우 최종 페이로드에 clickAction 메시지를 포함합니다.
slideup 인앱 메시지는 화면 상단 또는 하단에서 ‘슬라이드 업’ 또는 ‘슬라이드 다운’되기 때문에 그렇게 이름이 붙여졌습니다. 화면의 작은 부분을 차지하며 효과적이고 방해가 되지 않는 메시징 기능을 제공합니다.
slideup 인앱 메시지 오브젝트는 InAppMessageBase를 확장합니다.
modal 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 보다 중요한 메시징에 유용하며, 두 개의 클릭 동작과 분석 지원 버튼을 제공할 수 있습니다.
이 메시지 유형은 InAppMessageImmersiveBase의 하위 클래스이며, IInAppMessageImmersive을 구현하는 추상 클래스입니다. 이를 통해 로컬에서 생성된 인앱 메시지에 사용자 정의 기능을 추가할 수 있는 옵션을 제공합니다.
full 인앱 메시지는 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. full 인앱 메시지의 상단에는 이미지가, 하단에는 텍스트와 최대 2개의 클릭 동작 및 분석 지원 버튼이 표시됩니다.
이 메시지 유형은 InAppMessageImmersiveBase을 확장하여 로컬에서 생성된 인앱 메시지에 사용자 정의 기능을 추가할 수 있는 옵션을 제공합니다.
HTML 인앱 메시지는 완전히 맞춤화된 사용자 콘텐츠를 만드는 데 유용합니다. 사용자 정의 HTML 인앱 메시지 콘텐츠는 WebView에 표시되며, 선택적으로 이미지 및 글꼴과 같은 다양한 형식의 기타 콘텐츠를 포함할 수 있으므로 메시지 모양과 기능을 완벽하게 제어할 수 있습니다.
이 메시지 유형은 IInAppMessageHtml을 구현하며, 이는 IInAppMessage의 하위 클래스입니다.
Android에서는 사용자 정의 HTML 인앱 메시지에서 target="_blank"로 구성된 링크가 기기의 기본 웹 브라우저에서 열립니다.
Android 인앱 메시지는 HTML 내에서 Braze Android SDK의 메서드를 호출하기 위한 JavaScript brazeBridge 인터페이스를 지원합니다. 자세한 내용은 JavaScript bridge 페이지를 참조하세요.
현재 iOS 및 Android 플랫폼에서는 iFrame에 커스텀 HTML 인앱 메시지를 표시하는 기능을 지원하지 않습니다.
앱에 대한 사용자 정의 인앱 메시지 뷰를 정의할 수도 있습니다. 전체 안내를 보려면 Setting custom factories를 참조하세요.
각 인앱 메시지 유형은 콘텐츠, 이미지, 아이콘, 클릭 동작, 분석, 표시 및 전달 전반에 걸쳐 고도로 사용자 지정 가능합니다. 모든 인앱 메시지의 기본 동작과 특성을 정의하는 Braze.InAppMessage 의 열거된 유형입니다. 인앱 메시지 속성 및 사용법에 대한 전체 목록은 InAppMessage 클래스를 참조하세요.
다음은 Braze에서 사용할 수 있는 인앱 메시지 유형과 최종 사용자에게 표시되는 방식입니다.
Slideup 인앱 메시지는 화면 상단 또는 하단에서 “슬라이드 업” 또는 “슬라이드 다운”되기 때문에 이 이름이 붙여졌습니다. 화면의 작은 부분을 차지하며 효과적이고 방해가 되지 않는 메시징 기능을 제공합니다.
Modal 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 보다 중요한 메시징에 유용하며, 최대 두 개의 분석 지원 버튼을 제공할 수 있습니다.
Modal Image 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 이러한 메시지는 헤더나 메시지 텍스트가 없다는 점을 제외하면 Modal 유형과 유사합니다. 보다 중요한 메시징에 유용하며, 최대 두 개의 분석 지원 버튼을 제공할 수 있습니다.
Full 인앱 메시지는 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. Full 인앱 메시지의 상단에는 이미지가, 하단에는 텍스트와 최대 2개의 분석 지원 버튼이 표시됩니다.
Full Image 인앱 메시지는 헤더나 메시지 텍스트가 없다는 점을 제외하면 Full 인앱 메시지와 유사합니다. 이 메시지 유형은 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. Full Image 인앱 메시지에는 전체 화면에 걸친 이미지와 함께 최대 2개의 분석 지원 버튼을 표시하는 옵션이 포함되어 있습니다.
HTML 인앱 메시지는 완전히 맞춤화된 사용자 콘텐츠를 만드는 데 유용합니다. 사용자 정의 HTML 전체 인앱 메시지 콘텐츠는 WKWebView에 표시되며, 선택적으로 이미지 및 글꼴과 같이 다양한 형식의 기타 콘텐츠를 포함할 수 있으므로 메시지 모양과 기능을 완벽하게 제어할 수 있습니다.
iOS 인앱 메시지는 HTML 내에서 Braze 웹 SDK의 메서드를 호출하기 위해 JavaScript brazeBridge 인터페이스를 지원합니다. 자세한 내용은 모범 사례를 참조하세요.
다음 예는 페이지가 지정된 HTML 전체 인앱 메시지를 보여줍니다:
현재 iOS 및 Android 플랫폼에서는 iFrame에 커스텀 HTML 인앱 메시지를 표시하는 기능을 지원하지 않습니다.
인앱 메시지 활성화
1단계: 옵저버 추가
인앱 메시지를 처리하려면 BrazeTask.BrazeInAppMessage에 옵저버를 추가할 수 있습니다:
1
m.BrazeTask.observeField("BrazeInAppMessage", "onInAppMessageReceived")
2단계: 트리거된 메시지에 액세스하기
그런 다음, 핸들러 내에서 Campaign이 트리거한 최상위 인앱 메시지에 액세스할 수 있습니다:
1
2
3
4
sub onInAppMessageReceived()
in_app_message = m.BrazeTask.BrazeInAppMessage
...
end sub
메시지 필드
처리
다음은 인앱 메시지를 처리하는 데 필요한 필드 목록입니다:
| 필드 | 설명 |
|---|---|
buttons |
버튼 목록(빈 목록일 수 있음). |
click_action |
"URI" 또는 "NONE". 이 필드를 사용하여 인앱 메시지를 클릭할 때 URI 링크로 열 것인지 아니면 메시지를 닫을 것인지 나타냅니다. 버튼이 없는 경우, 인앱 메시지가 표시될 때 사용자가 “확인”을 클릭하면 이 동작이 수행됩니다. |
dismiss_type |
"AUTO_DISMISS" 또는 "SWIPE". 이 필드를 사용하여 인앱 메시지를 자동으로 닫을지 아니면 스와이프하여 닫을지 나타냅니다. |
display_delay |
인앱 메시지를 표시할 때까지 대기하는 시간(초). |
duration |
dismiss_type이 "AUTO_DISMISS"로 설정된 경우 메시지가 표시되는 시간(밀리초). |
extras |
키-값 페어. |
header |
헤더 텍스트. |
id |
노출 횟수 또는 클릭을 기록하는 데 사용되는 ID. |
image_url |
인앱 메시지 이미지 URL. |
message |
메시지 본문 텍스트. |
uri |
click_action에 따라 사용자가 이동하게 되는 URI입니다. 이 필드는 click_action이 "URI"일 때 반드시 포함되어야 합니다. |
버튼이 포함된 인앱 메시지의 경우, 버튼 텍스트를 추가하기 전에 클릭 동작이 추가되면 메시지 click_action도 최종 페이로드에 포함됩니다.
스타일링
대시보드에서 사용할 수 있는 다양한 스타일 필드도 있습니다:
| 필드 | 설명 |
|---|---|
bg_color |
배경색. |
close_button_color |
닫기 버튼 색상. |
frame_color |
배경 화면 오버레이의 색상. |
header_text_color |
헤더 텍스트 색상. |
message_text_color |
메시지 텍스트 색상. |
text_align |
“START”, “CENTER” 또는 “END”. 선택한 텍스트 정렬. |
또는 인앱 메시지를 구현하고 표준 팔레트를 사용하여 Roku 애플리케이션 내에서 스타일을 지정할 수 있습니다:
버튼
| 필드 | 설명 |
|---|---|
click_action |
"URI" 또는 "NONE". 이 필드를 사용하여 인앱 메시지를 클릭할 때 URI 링크로 열 것인지 아니면 메시지를 닫을 것인지 나타냅니다. |
id |
버튼 자체의 ID 값. |
text |
버튼에 표시할 텍스트. |
uri |
click_action에 따라 사용자가 이동하게 되는 URI입니다. 이 필드는 click_action이 "URI"일 때 반드시 포함되어야 합니다. |
인앱 메시징은 tvOS용 기본 UI나 보기가 포함되지 않은 Swift SDK를 사용하는 헤드리스 UI를 통해 지원되므로 자체 커스텀 UI를 구현해야 합니다.
필수 조건
이 기능을 사용하려면 먼저 Swift Braze SDK를 통합해야 합니다.
인앱 메시지 활성화
1단계: 새 iOS 앱 만들기
Braze에서 설정 > 앱 설정을 선택한 다음, 앱 추가를 선택합니다. tvOS 앱 이름을 입력하고 tvOS가 아닌 iOS를 선택한 다음, 앱 추가를 선택합니다.
tvOS 체크박스를 선택하면 tvOS용 {앱} 내 메시지를 사용자 지정할 수 없습니다.
2단계: 앱의 API 키 가져오기
앱 설정에서 새 tvOS 앱을 선택한 다음, 앱의 API 키를 기록합니다. 이 키를 사용하여 Xcode에서 앱을 구성할 수 있습니다.
3단계: BrazeKit 통합
앱의 API 키를 사용하여 Braze Swift SDK를 Xcode의 tvOS 프로젝트에 통합합니다. Braze Swift SDK에서 BrazeKit를 통합하기만 하면 됩니다.
4단계: 사용자 지정 UI 만들기
Braze는 tvOS에서 인앱 메시지에 대한 기본 UI를 제공하지 않으므로 직접 사용자 지정해야 합니다. 전체 안내는 단계별 튜토리얼을 참조하세요. tvOS용 앱 내 메시지 사용자 지정. 샘플 프로젝트는 Braze Swift SDK 샘플을 참조하세요.
필수 조건
이 기능을 사용하려면 먼저 Unity Braze SDK를 통합해야 합니다.
메시지 유형
Braze는 각기 다른 기본 인앱 메시지 유형을 제공하며, 메시지, 이미지, Font Awesome 아이콘, 클릭 액션, 분석, 색상 구성표 등을 사용하여 사용자 정의할 수 있습니다.
그들의 기본 동작과 특성은 IInAppMessage 인터페이스에 의해 정의되며, InAppMessageBase라는 하위 클래스에 있습니다. IInAppMessage는 또한 닫기, 클릭 액션 및 분석 버튼을 앱에 추가할 수 있는 하위 인터페이스 IInAppMessageImmersive를 포함합니다.
버튼이 포함된 인앱 메시지는 클릭 액션이 버튼 텍스트를 추가하기 전에 추가된 경우 최종 페이로드에 clickAction 메시지를 포함합니다.
slideup 인앱 메시지는 화면 상단 또는 하단에서 ‘슬라이드 업’ 또는 ‘슬라이드 다운’되기 때문에 그렇게 이름이 붙여졌습니다. 화면의 작은 부분을 차지하며 효과적이고 방해가 되지 않는 메시징 기능을 제공합니다.
slideup 인앱 메시지 오브젝트는 InAppMessageBase를 확장합니다.
modal 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 보다 중요한 메시징에 유용하며, 두 개의 클릭 동작과 분석 지원 버튼을 제공할 수 있습니다.
이 메시지 유형은 InAppMessageImmersiveBase의 하위 클래스이며, IInAppMessageImmersive을 구현하는 추상 클래스입니다. 이를 통해 로컬에서 생성된 인앱 메시지에 사용자 정의 기능을 추가할 수 있는 옵션을 제공합니다.
full 인앱 메시지는 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. full 인앱 메시지의 상단에는 이미지가, 하단에는 텍스트와 최대 2개의 클릭 동작 및 분석 지원 버튼이 표시됩니다.
이 메시지 유형은 InAppMessageImmersiveBase을 확장하여 로컬에서 생성된 인앱 메시지에 사용자 정의 기능을 추가할 수 있는 옵션을 제공합니다.
HTML 인앱 메시지는 완전히 맞춤화된 사용자 콘텐츠를 만드는 데 유용합니다. 사용자 정의 HTML 인앱 메시지 콘텐츠는 WebView에 표시되며, 선택적으로 이미지 및 글꼴과 같은 다양한 형식의 기타 콘텐츠를 포함할 수 있으므로 메시지 모양과 기능을 완벽하게 제어할 수 있습니다.
이 메시지 유형은 IInAppMessageHtml을 구현하며, 이는 IInAppMessage의 하위 클래스입니다.
Android에서는 사용자 정의 HTML 인앱 메시지에서 target="_blank"로 구성된 링크가 기기의 기본 웹 브라우저에서 열립니다.
Android 인앱 메시지는 HTML 내에서 Braze Android SDK의 메서드를 호출하기 위한 JavaScript brazeBridge 인터페이스를 지원합니다. 자세한 내용은 JavaScript bridge 페이지를 참조하세요.
현재 iOS 및 Android 플랫폼에서는 iFrame에 커스텀 HTML 인앱 메시지를 표시하는 기능을 지원하지 않습니다.
앱에 대한 사용자 정의 인앱 메시지 뷰를 정의할 수도 있습니다. 전체 안내를 보려면 Setting custom factories를 참조하세요.
각 인앱 메시지 유형은 콘텐츠, 이미지, 아이콘, 클릭 동작, 분석, 표시 및 전달 전반에 걸쳐 고도로 사용자 지정 가능합니다. 모든 인앱 메시지의 기본 동작과 특성을 정의하는 Braze.InAppMessage 의 열거된 유형입니다. 인앱 메시지 속성 및 사용법에 대한 전체 목록은 InAppMessage 클래스를 참조하세요.
다음은 Braze에서 사용할 수 있는 인앱 메시지 유형과 최종 사용자에게 표시되는 방식입니다.
Slideup 인앱 메시지는 화면 상단 또는 하단에서 “슬라이드 업” 또는 “슬라이드 다운”되기 때문에 이 이름이 붙여졌습니다. 화면의 작은 부분을 차지하며 효과적이고 방해가 되지 않는 메시징 기능을 제공합니다.
Modal 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 보다 중요한 메시징에 유용하며, 최대 두 개의 분석 지원 버튼을 제공할 수 있습니다.
Modal Image 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 이러한 메시지는 헤더나 메시지 텍스트가 없다는 점을 제외하면 Modal 유형과 유사합니다. 보다 중요한 메시징에 유용하며, 최대 두 개의 분석 지원 버튼을 제공할 수 있습니다.
Full 인앱 메시지는 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. Full 인앱 메시지의 상단에는 이미지가, 하단에는 텍스트와 최대 2개의 분석 지원 버튼이 표시됩니다.
Full Image 인앱 메시지는 헤더나 메시지 텍스트가 없다는 점을 제외하면 Full 인앱 메시지와 유사합니다. 이 메시지 유형은 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. Full Image 인앱 메시지에는 전체 화면에 걸친 이미지와 함께 최대 2개의 분석 지원 버튼을 표시하는 옵션이 포함되어 있습니다.
HTML 인앱 메시지는 완전히 맞춤화된 사용자 콘텐츠를 만드는 데 유용합니다. 사용자 정의 HTML 전체 인앱 메시지 콘텐츠는 WKWebView에 표시되며, 선택적으로 이미지 및 글꼴과 같이 다양한 형식의 기타 콘텐츠를 포함할 수 있으므로 메시지 모양과 기능을 완벽하게 제어할 수 있습니다.
iOS 인앱 메시지는 HTML 내에서 Braze 웹 SDK의 메서드를 호출하기 위해 JavaScript brazeBridge 인터페이스를 지원합니다. 자세한 내용은 모범 사례를 참조하세요.
다음 예는 페이지가 지정된 HTML 전체 인앱 메시지를 보여줍니다:
현재 iOS 및 Android 플랫폼에서는 iFrame에 커스텀 HTML 인앱 메시지를 표시하는 기능을 지원하지 않습니다.
필수 조건
이 기능을 사용하기 전에 .NET MAUI Braze SDK를 통합해야 합니다.
메시지 유형
Braze는 각기 다른 기본 인앱 메시지 유형을 제공하며, 메시지, 이미지, Font Awesome 아이콘, 클릭 액션, 분석, 색상 구성표 등을 사용하여 사용자 정의할 수 있습니다.
그들의 기본 동작과 특성은 IInAppMessage 인터페이스에 의해 정의되며, InAppMessageBase라는 하위 클래스에 있습니다. IInAppMessage는 또한 닫기, 클릭 액션 및 분석 버튼을 앱에 추가할 수 있는 하위 인터페이스 IInAppMessageImmersive를 포함합니다.
버튼이 포함된 인앱 메시지는 클릭 액션이 버튼 텍스트를 추가하기 전에 추가된 경우 최종 페이로드에 clickAction 메시지를 포함합니다.
slideup 인앱 메시지는 화면 상단 또는 하단에서 ‘슬라이드 업’ 또는 ‘슬라이드 다운’되기 때문에 그렇게 이름이 붙여졌습니다. 화면의 작은 부분을 차지하며 효과적이고 방해가 되지 않는 메시징 기능을 제공합니다.
slideup 인앱 메시지 오브젝트는 InAppMessageBase를 확장합니다.
modal 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 보다 중요한 메시징에 유용하며, 두 개의 클릭 동작과 분석 지원 버튼을 제공할 수 있습니다.
이 메시지 유형은 InAppMessageImmersiveBase의 하위 클래스이며, IInAppMessageImmersive을 구현하는 추상 클래스입니다. 이를 통해 로컬에서 생성된 인앱 메시지에 사용자 정의 기능을 추가할 수 있는 옵션을 제공합니다.
full 인앱 메시지는 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. full 인앱 메시지의 상단에는 이미지가, 하단에는 텍스트와 최대 2개의 클릭 동작 및 분석 지원 버튼이 표시됩니다.
이 메시지 유형은 InAppMessageImmersiveBase을 확장하여 로컬에서 생성된 인앱 메시지에 사용자 정의 기능을 추가할 수 있는 옵션을 제공합니다.
HTML 인앱 메시지는 완전히 맞춤화된 사용자 콘텐츠를 만드는 데 유용합니다. 사용자 정의 HTML 인앱 메시지 콘텐츠는 WebView에 표시되며, 선택적으로 이미지 및 글꼴과 같은 다양한 형식의 기타 콘텐츠를 포함할 수 있으므로 메시지 모양과 기능을 완벽하게 제어할 수 있습니다.
이 메시지 유형은 IInAppMessageHtml을 구현하며, 이는 IInAppMessage의 하위 클래스입니다.
Android에서는 사용자 정의 HTML 인앱 메시지에서 target="_blank"로 구성된 링크가 기기의 기본 웹 브라우저에서 열립니다.
Android 인앱 메시지는 HTML 내에서 Braze Android SDK의 메서드를 호출하기 위한 JavaScript brazeBridge 인터페이스를 지원합니다. 자세한 내용은 JavaScript bridge 페이지를 참조하세요.
현재 iOS 및 Android 플랫폼에서는 iFrame에 커스텀 HTML 인앱 메시지를 표시하는 기능을 지원하지 않습니다.
앱에 대한 사용자 정의 인앱 메시지 뷰를 정의할 수도 있습니다. 전체 안내를 보려면 Setting custom factories를 참조하세요.
각 인앱 메시지 유형은 콘텐츠, 이미지, 아이콘, 클릭 동작, 분석, 표시 및 전달 전반에 걸쳐 고도로 사용자 지정 가능합니다. 모든 인앱 메시지의 기본 동작과 특성을 정의하는 Braze.InAppMessage 의 열거된 유형입니다. 인앱 메시지 속성 및 사용법에 대한 전체 목록은 InAppMessage 클래스를 참조하세요.
다음은 Braze에서 사용할 수 있는 인앱 메시지 유형과 최종 사용자에게 표시되는 방식입니다.
Slideup 인앱 메시지는 화면 상단 또는 하단에서 “슬라이드 업” 또는 “슬라이드 다운”되기 때문에 이 이름이 붙여졌습니다. 화면의 작은 부분을 차지하며 효과적이고 방해가 되지 않는 메시징 기능을 제공합니다.
Modal 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 보다 중요한 메시징에 유용하며, 최대 두 개의 분석 지원 버튼을 제공할 수 있습니다.
Modal Image 인앱 메시지는 화면 중앙에 표시되며 반투명 패널로 둘러싸여 있습니다. 이러한 메시지는 헤더나 메시지 텍스트가 없다는 점을 제외하면 Modal 유형과 유사합니다. 보다 중요한 메시징에 유용하며, 최대 두 개의 분석 지원 버튼을 제공할 수 있습니다.
Full 인앱 메시지는 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. Full 인앱 메시지의 상단에는 이미지가, 하단에는 텍스트와 최대 2개의 분석 지원 버튼이 표시됩니다.
Full Image 인앱 메시지는 헤더나 메시지 텍스트가 없다는 점을 제외하면 Full 인앱 메시지와 유사합니다. 이 메시지 유형은 사용자 커뮤니케이션의 콘텐츠와 효과를 극대화하는 데 유용합니다. Full Image 인앱 메시지에는 전체 화면에 걸친 이미지와 함께 최대 2개의 분석 지원 버튼을 표시하는 옵션이 포함되어 있습니다.
HTML 인앱 메시지는 완전히 맞춤화된 사용자 콘텐츠를 만드는 데 유용합니다. 사용자 정의 HTML 전체 인앱 메시지 콘텐츠는 WKWebView에 표시되며, 선택적으로 이미지 및 글꼴과 같이 다양한 형식의 기타 콘텐츠를 포함할 수 있으므로 메시지 모양과 기능을 완벽하게 제어할 수 있습니다.
iOS 인앱 메시지는 HTML 내에서 Braze 웹 SDK의 메서드를 호출하기 위해 JavaScript brazeBridge 인터페이스를 지원합니다. 자세한 내용은 모범 사례를 참조하세요.
다음 예는 페이지가 지정된 HTML 전체 인앱 메시지를 보여줍니다:
현재 iOS 및 Android 플랫폼에서는 iFrame에 커스텀 HTML 인앱 메시지를 표시하는 기능을 지원하지 않습니다.
다음 단계
더 깊이 들어갈 준비가 되셨나요? 이 단계별 튜토리얼을 확인하세요:
- 메시지 전달 타이밍을 지연 및 복원된 트리거 메시지로 미세 조정하세요.
- 메시지 타겟팅을 조건부 표시 규칙 설정으로 개선하세요.
- 키-값 쌍으로 메시지 스타일링을 사용자 정의하여 브랜드의 외관을 일치시키세요.