Android

이 페이지에서는 안드로이드 앱 내에서 인앱메세지 테스트 방법을 안내합니다.

사전 작업

이 문서는 Android SDK 연동 완료 이후 인앱 메시지 수신을 테스트하기 위한 방법을 가이드합니다. 아래 문서의 사전 작업을 완료 후 진행해주세요.

Android SDKIn-App Campaign 테스트

수신 및 집계를 정확히 확인하기 위해 로그 레벨을 debug 로 설정해주세요.

로그 레벨 설정

1. 캠페인 수신 확인

캠페인 테스트 단계에서 설정한 트리거 이벤트인 홈 화면 조회 를 찍도록 이벤트를 추가하고 캠페인이 트리거 되는지 확인해보겠습니다.

코드의 적당한 위치에 홈 화면 조회(mkt_home_view) 이벤트를 추가합니다. 앱 실행 후 해당 코드가 실행되면 캠페인이 트리거되어야 합니다.

class MainActivity : AppCompatActivity() {
    @RequiresApi(Build.VERSION_CODES.TIRAMISU)
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        
        // 캠페인에서 설정한 이벤트 발생
        Marketap.track("mkt_home_view") 
        // ...
    }
    // ...
}

디바이스에서 인앱 메시지가 정상 수신되는지 확인해주세요. 2. 로그 확인 으로 이동해서 연동을 추가로 확인해주세요.

2. 로그 확인

인앱 메시지를 수신했을 때, logcat에서 다음 로그가 출력되어야 합니다.

[com.marketap.sdk.Marketap]: Marketap SDK track event with name: mkt_home_view, properties: null
[com.marketap.sdk.domain.service.inapp.InAppService]: Showing in-app campaign: {campaign id} with layout type: MODAL
[com.marketap.sdk.domain.service.inapp.InAppService]: Recorded impression for campaign: {campaign id}

인앱 메시지를 클릭해서 설정한 링크로 정상 랜딩되는지 확인해주세요. logcat에 다음 로그가 출력됩니다.

[com.marketap.sdk.client.inapp.WebAppInterface]: trackClick called with locationId: image-1, url: https://marketap.kr
[com.marketap.sdk.client.api.RetryMarketapBackend]: tracking event for project kx43pz7, eventName: mkt_click_message
[com.marketap.sdk.domain.service.inapp.InAppService]: Recorded click for campaign: ii1t0h43 at location: image-1

3. 클릭 액션 커스텀하기 (선택)

캠페인에 클릭 액션 URL이 설정되어 있는 경우, 마켓탭 SDK는 기본 동작으로 ACTION_VIEW 인텐트를 실행하여 해당 URL을 처리합니다.

실행된 URL은 앱의 딥링크 처리 Activity(예: intent-filter에 등록된 Activity의 onCreate 또는 onNewIntent)에서 수신하여 처리할 수 있습니다.

이 기본 동작을 비활성화하고 클릭 시 액션을 직접 제어하려면, 아래 페이지 안내에 따라 clickHandler 기반 커스텀 연동을 진행해주세요.

커스텀 클릭 핸들러

4. 이어서 진행하기

이제 In-App Campaign 테스트가 완료되었습니다. 아래 문서에서 이어서 진행해주세요.

EVENT 및 USER 연동

Push Notification 테스트

심화 연동