본문으로 건너뛰기

Android용 빠른 시작 가이드

이 문서는 Android에서 네이버 앱 전환 추적 SDK를 적용하는 데 필요한 필수 구현 항목을 설명합니다. 자세한 내용은 SDK 적용 절차를 참고하세요.

사전 준비 사항​

네이버 앱 전환 추적 SDK를 사용하기 전에 다음 사항을 확인합니다.

  • 네이버 앱 전환 추적 SDK는 Android 5.0(API level 21) 이상을 지원합니다.
  • SDK를 사용하려면 '네이버 공통키(Site ID)'가 필요합니다. 자세한 내용은 네이버 공통키 발급을 참고하세요.

SDK 설치​

네이버 앱 전환 추적 SDK는 다음의 라이브러리에 의존성을 가지고 있습니다.

dependencies {
  implementation 'com.google.android.gms:play-services-appset:16.0.2'
  implementation 'com.android.installreferrer:installreferrer:2.2'
}

네이버 앱 전환 추적 SDK는 다음의 권한이 필요합니다. 

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

네이버 앱 전환 추적 SDK를 Gradle dependency 설정에 추가합니다.

dependencies {
  implementation 'com.navercorp.ntracker:NTrackerSDKExt:버전명'
}

설정 및 초기화​

다음과 같이 SDK를 설정하고 초기화합니다.

  • Application Class의 onCreate에서 configure API로 SDK를 초기화합니다.
  • enableDebugLog API로 Logcat 콘솔에 디버그 로그 출력 여부를 설정할 수 있습니다.
  • phase로 수집 서버 환경을 설정합니다.
  • 스토어 배포 시 phase는 Release, 로그 출력 여부는 false여야 합니다.
class App: Application() {
  override fun onCreate() {
    super.onCreate()

    NTrackerExt.enableDebugLog(true)
    NTrackerExt.configure(applicationContext, siteId, NTrackerExtPhase.DEBUG)

  }
}

자세한 내용은 SDK 설정 및 초기화를 참고하세요.

유입 경로 설정​

App Link나 Custom URL Scheme을 통해 앱으로 전환이 발생한 경우 유입 경로를 수집하여 전환 측정의 정확도를 높일 수 있습니다.

  • 유입 경로는 setInflow API로 수집합니다.
  • 네이버 광고를 통한 전환 추적 데이터를 측정하려면 setInflow API로 URL 정보를 수집해야 합니다. 타사 트래커에서 제공하는 딥 링크를 사용한다면 해당 트래커에서 URL 정보를 가공하기 전에 앱으로 유입되는 최초 정보를 그대로 setInflow에 전달해야 합니다.
class SampleActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {  
        super.onCreate(savedInstanceState)  
        setContentView(R.layout.activity_main)  
  
        handleIntent(intent)
    
        // Your Codes.
    }
    
    override fun onNewIntent(intent: Intent?) {  
        super.onNewIntent(intent)  
  
        handleIntent(intent)  

        // Your Codes.
    }  
  
    private fun handleIntent(intent: Intent?) {  
        if (intent == null) {  
            return  
        }  
  
        val appLinkAction = intent.action  
        val appLinkData: Uri? = intent.data  

        if (Intent.ACTION_VIEW == appLinkAction) {  
            NTrackerExt.setInflow(appLinkData)  
        }  

        // Your Codes.
    }
}

앱 설정이나 프로젝트 구성에 따라 구현 방식이 다를 수 있습니다. 자세한 내용은 SDK 적용 절차의 유입 경로 설정을 참고하세요.

전환 이벤트 전송​

네이버 앱 전환 추적 SDK에서는 다양한 전환 이벤트를 수집합니다.

  • '앱 설치', '앱 실행' 이벤트는 SDK에서 자동으로 수집합니다.
  • '구매 완료' 이벤트는 trackPurchaseEvent, '앱 내 구매 완료' 이벤트는 trackInAppPurchaseEvent로 수집합니다.
  • 그 외 일반 이벤트는 trackConversionEvent로 수집합니다.
// 환율 정보는 'ext1'에 입력합니다. 'KRW'인 경우 생략할 수 있습니다.
val items = arrayOf(
    NTrackerConversionItem(1, 100.0, "item1", null, null, "KRW"),
    NTrackerConversionItem(2, 400.0, "item2", null, null, "KRW"),
    NTrackerConversionItem(3, 900.0, "item3", null, null, "KRW")
)

// 전환 가치와 구매 아이템을 전송하는 경우
NTrackerExt.trackPurchaseEvent(1_400, items)

일반 이벤트 전송 시 이벤트 이름은 NTrackerConversionEvent에 정의되어 있습니다.

NTrackerExt.trackConversionEvent(NTrackerConversionEvent.Subscribe, 10_000)

자세한 내용은 SDK 적용 절차의 전환 이벤트 전송을 참고하세요.