menu
Is this helpful?

# 자동 수집 이벤트 가이드

인스턴스 생성 설정에서 자동 수집이 필요한 이벤트를 활성화하면, SDK는 미니게임의 일부 동작을 자동으로 수집합니다. 현재 자동 수집을 지원하는 이벤트는 주로 다음과 같습니다:

지원 가능한 자동 수집 이벤트 데이터:

  1. 미니게임이 포어그라운드로 돌아오는 이벤트
  2. 미니게임이 백그라운드로 전환되며, 이 시간을 기록합니다 (백그라운드로의 전환 시작)

이제 각 데이터 수집 방법을 자세히 소개합니다.

# 1. 자동 수집 이벤트 활성화

config에서, 파라미터 autoTrack의 요소는 각 자동 수집 이벤트의 스위치를 나타내며, true로 설정하면 자동 수집이 활성화됩니다.

var config = {
    appid: "YOUR_APPID",
    server_url: "YOUR_SERVER_URL",
    autoTrack: {
         appShow: true, 
         appHide: true, 
         properties: { 
         callback: (eventType:any) =>{ 
           if (eventType === 'appShow')
           {
            return { appShowKey: 'appShowValue' };
           } 
           else if (eventType === 'appHide')
           {
            return { appHideKey: 'appHideValue' };
           } 
           else {
             return {};
           }
         }
     }
};
var te = new ThinkingAnalyticsAPI(config);
  • appShow: 게임을 자동으로 수집하여 시작하거나, 백그라운드에서 포어그라운드로 들어갈 때
  • appHide: 포어그라운드에서 백그라운드로 미니게임이 자동으로 수집됩니다
  • properties: 커스텀 속성의 자동 수집(appShow/appHide 대응)
  • callback: 자동 수집 콜백(appShow/appHide 대응)

# 2. 자동 수집 이벤트 소개

# 2.1 미니게임 시작

미니게임의 시작은 미니게임이 시작될 때, 또는 미니게임이 백그라운드에서 포어그라운드로 돌아올 때 트리거됩니다. 자세한 이벤트는 다음과 같습니다.

  • 이벤트 이름: ta_mg_show
  • 자동 수집 속성:
    • #scene, 시네값, Wechat이 제공하는 시네값

미니게임의 시작은 포어그라운드와 백그라운드의 호출로 인해 영향을 받기 때문에(항목 수가 많음), 직접적인 분석에는 적합하지 않지만, 행동 경로로 유저의 사용 상황을 특정할 수 있으며, 사용 가능한 유저 행동 경로의 초기 행동으로 간주됩니다.

# 2.2 미니게임 숨김

미니게임의 숨김은 미니게임이 백그라운드로 전환될 때 트리거되며, 이 사용 시간은 기록됩니다. 자세한 이벤트는 다음과 같습니다.

  • 이벤트 이름: ta_mg_hide
  • 자동 수집 속성:
    • #scene, 시네값, Wechat이 제공하는 시네값
    • #duration, 숫자형, 이번 시작(ta_mg_show)부터 숨김까지의 경과 시간

미니게임의 숨김 이벤트는 사용 시간(초 단위)을 기록하기 때문에, 유저의 총 사용 시간과 평균 사용 시간을 직접 계산하거나, 초기화 횟수로 나누어 한 번의 사용 시간을 계산할 수 있습니다.

← 디버깅 →