Skip to content

인앱 메시지 통합

이 구현 가이드에서는 인앱 메시지 코드 고려사항과 함께 제공되는 코드 스니펫을 다룹니다. 샘플 통합 코드를 제공하지만, 원하는 UI 내에서 트리거된 메시지를 처리하고 표시하는 로직을 추가해야 합니다.

코드는 앱에 고유한 것이므로 사용 사례와 관련이 없는 경우 나열된 모든 상황을 처리할 필요는 없습니다. 예를 들어 인앱 메시지 지연 표시를 사용하지 않는다면 해당 로직과 엣지 케이스를 구현할 필요가 없습니다.

SDK 요구 사항

인앱 메시지는 지원되는 최소 SDK 버전을 실행하는 Roku 기기로만 전송됩니다.

인앱 메시지 설정

인앱 메시지를 처리하려면 BrazeTask.BrazeInAppMessage 에서 옵저버를 추가할 수 있습니다:

1
m.BrazeTask.observeField("BrazeInAppMessage", "onInAppMessageReceived")

그런 다음, 핸들러 내에서 캠페인이 트리거하는 최상위 인앱 메시지에 액세스할 수 있습니다.

1
2
3
4
sub onInAppMessageReceived()
  in_app_message = m.BrazeTask.BrazeInAppMessage
  ...
end sub

인앱 메시지 필드

다음은 인앱 메시지를 처리하는 데 필요한 필드 목록입니다:

스타일링 필드

대시보드에서 사용할 수 있는 다양한 스타일 필드도 있습니다.

또는 인앱 메시지를 구현하고 표준 팔레트를 사용하여 Roku 애플리케이션 내에서 스타일을 지정할 수 있습니다:

버튼 필드

상호 작용 처리하기

캠페인의 분석을 처리하기 위해 특정 함수가 호출되는지 확인해야 합니다.

메시지가 표시되는 경우

메시지가 표시되거나 확인되면 노출 횟수를 기록합니다.

1
LogInAppMessageImpression(in_app_message.id, brazetask)
사용자가 메시지를 클릭하는 경우

사용자가 메시지를 클릭하면 클릭을 기록한 다음, in_app_message.click_action을 처리합니다.

1
LogInAppMessageClick(in_app_message.id, brazetask)
사용자가 버튼을 클릭하는 경우

사용자가 버튼을 클릭하면 버튼 클릭을 기록한 다음, inappmessage.buttons[selected].click_action을 처리합니다.

1
LogInAppMessageButtonClick(inappmessage.id, inappmessage.buttons[selected].id, brazetask)
인앱 메시지 처리 후

인앱 메시지를 처리한 후에는 해당 필드를 지워야 합니다.

1
m.BrazeTask.BrazeInAppMessage = invalid
이 페이지가 얼마나 도움이 되었나요?
New Stuff!