Android Reference

com.kakao.kinsight.sdk.android

Class KinsightSession

  • package com.kakao.kinsight.sdk.android
    public final class KinsightSession
    extends Object
    Analytics를 사용하기 위해 세션을 관리한다. 데이타 수집을 위한 세션을 생성하거나 종료할 수 있다. 사용자의 앱 내에서의 활동(event)에 대한 정보를 얻거나, 사용자가 이용한 화면(screen)에 대한 정보를 얻을 수 있다.
    • Constructor Summary

      Constructors
      Constructor and Description
      KinsightSession(android.content.Context context)
      새로운 KinsightSession 객체를 생성한다.
    • Method Summary

      Methods
      Modifier and Type Method and Description
      void addEvent(String event)
      이미 열려진 세션에 사용자의 이벤트를 기록한다.
      void addEvent(String event, Map<String,Object> attributes)
      이미 열려진 세션에 사용자의 이벤트와 이벤트에 관련된 부가 속성을 기록한다.
      void close()
      데이타 수집을 위한 세션을 종료하고 전송이 가능한 데이타를 업로드한다.
      void open()
      분석용 데이타 수집을 위한 세션을 시작하고, 필요한 데이타를 업로드 한다.
      void tagScreen(String screen)
      사용된 화면(스크린)을 열려진 세션에 기록한다.
    • Constructors

      • public KinsightSession(android.content.Context context)
        새로운 KinsightSession 객체를 생성한다.
        Parameters:
        context - 앱의 리소스를 사용하기 위한 context. Context.getApplicationContext()를 통해 값을 설정하도록 하며, 그 값이 null이 되면 안된다.
        Throws:
        IllegalArgumentException - context의 값으로 null이 전달되면 발생함
        IllegalArgumentException - AndroidManifest.xml 파일의 com.kakao.sdk.AppKey의 값이 null이거나 정의되지 않으면 발생함
    • Method Detail

      • public void addEvent(String event)
        이미 열려진 세션에 사용자의 이벤트를 기록한다.
        Parameters:
        event - 이벤트의 이름이며, null이거나 빈 문자열일 수 없음
        Throws:
        IllegalArgumentException - event이 null이거나 빈 문자열일 때 발생함
        See Also:
        addEvent(String, Map)
      • public void addEvent(String event,
                    Map<String,Object> attributes)
        이미 열려진 세션에 사용자의 이벤트와 이벤트에 관련된 부가 속성을 기록한다.
        Parameters:
        event - 이벤트의 이름이며, null이거나 빈 문자열일 수 없음
        attributes - 이 이벤트의 속성에 대한 컬렉션
        Throws:
        IllegalArgumentException
      • public void close()
        데이타 수집을 위한 세션을 종료하고 전송이 가능한 데이타를 업로드한다. open()을 통해 한 번 시작된 세션은 반드시 종료가 되어야 한다.
      • public void open()
        분석용 데이타 수집을 위한 세션을 시작하고, 필요한 데이타를 업로드 한다. 세션이란 앱을 실행과 종료까지의 과정을 의미한다.

        만약 시작하려는 세션이 바로 전의 세션이 종료된 후 짧은 시간이 경과되었다면, 새로운 세션을 시작하는 대신에 이전의 세션을 다시 재개한다. 이렇게 함으로써 앱 내부의 액티비티의 전환이 있을 때에도 하나의 세션으로 처리한다.

      • public void tagScreen(String screen)
        사용된 화면(스크린)을 열려진 세션에 기록한다.
        Parameters:
        screen - 사용된 화면의 이름이며, null이거나 빈 문자열일 수 없음
        Throws:
        IllegalArgumentException - screen이 null이거나 빈 문자열일 때 발생함