본문으로 건너뛰기

자동 수집

최근 업데이트 2026. 10. 03.

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

현재 지원하는 자동 수집 데이터는 다음과 같습니다:

  1. 미니 게임이 포그라운드로 돌아오는 이벤트
  2. 미니 게임이 백그라운드로 전환되며, 이번 방문(시작부터 백그라운드 전환까지)의 시간을 기록

다음에서는 각 데이터의 수집 방법을 자세히 소개합니다

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

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

var config = {
    appId: "YOUR_APPID",
    serverUrl: "YOUR_SERVER_URL",
    autoTrack: {
         appLaunch: true, // ta_mg_launch 자동 수집
         appShow: true, // ta_mg_show 자동 수집
         appHide: true, // ta_mg_hide 자동 수집
         properties: { staticKey: 'staticValue' }, // 자동 수집 커스텀 속성
         callback: (eventType:any) =>{ // 자동 수집 콜백
           if (eventType === 'appShow')
           {
            return { appShowKey: 'appShowValue' };
           } 
           else if (eventType === 'appHide')
           {
            return { appHideKey: 'appHideValue' };
           } 
           else {
             return {};
           }
         }
     }
};
TDAnalytics.init(config);
  • appLaunch: 미니 게임 초기화 자동 수집
  • appShow: 미니 게임 시작 또는 백그라운드에서 포그라운드 진입 자동 수집
  • appHide: 미니 게임의 포그라운드에서 백그라운드 진입 자동 수집
  • properties: 자동 수집 커스텀 속성(appShow/appHide 지원)
  • callback: 자동 수집 콜백(appShow/appHide 지원)

첫 번째 자동 수집 이벤트에 계정, 게스트, 정적 공통 속성을 포함하려면 초기화할 때 다음 설정을 전달할 수 있습니다:

TDAnalytics.init(config, () => {
  TDAnalytics.login("TA")
  TDAnalytics.setDistinctId("DIS_TA")
  TDAnalytics.setSuperProperties({
    key: "value"
  });
});

2. 자동 수집 이벤트 상세 설명​

2.1 미니 게임 초기화​

미니 게임 초기화는 미니 게임이 처음 열릴 때 또는 유저가 프로세스를 종료한 후 다시 열 때 트리거되며, 프로세스 라이프사이클 내에서 한 번만 트리거됩니다. 이벤트 상세 설명은 다음과 같습니다:

  • 이벤트 이름: ta_mg_launch

  • 자동 수집 속성:

    • #scene, 장면 값으로, 위챗에서 제공하는 장면 값을 사용합니다
    • #start_reason, 앱 시작 출처로, getLaunchOptionsSync 인터페이스에서 가져온 파라미터입니다

미니 게임 초기화 이벤트로 일별 유저 사용 횟수와 인당 사용 횟수를 계산할 수 있으며, 장면 값으로 그룹화하여 장면 값별 유저의 사용 현황을 확인할 수도 있습니다.

2.2 미니 게임 시작​

미니 게임 시작은 미니 게임이 시작되거나 백그라운드에서 포그라운드로 돌아올 때 트리거됩니다. 이벤트 상세 설명은 다음과 같습니다:

  • 이벤트 이름: ta_mg_show
  • 자동 수집 속성:
    • #scene, 장면 값으로, 위챗에서 제공하는 장면 값을 사용합니다

미니 게임 시작은 포그라운드/백그라운드 전환의 영향을 받아(건수가 많음) 직접 분석하기에는 적합하지 않지만, 행동 경로에서 유저의 1회 사용을 식별하는 데 활용할 수 있으며 유저 행동 경로의 시작 행동으로 사용할 수 있습니다

2.3 미니 게임 숨김​

미니 게임 숨김은 미니 게임이 백그라운드로 전환될 때 트리거되며, 이번 사용 시간을 기록합니다. 이벤트 상세 설명은 다음과 같습니다:

  • 이벤트 이름: ta_mg_hide

  • 자동 수집 속성:

    • #scene, 장면 값으로, 위챗에서 제공하는 장면 값을 사용합니다
    • #duration, 숫자형으로, 이번 시작(ta_mg_show)부터 숨김까지의 지속 시간을 나타냅니다

미니 게임 숨김 이벤트는 사용 시간(단위: 초)을 기록하므로 유저의 총 사용 시간과 인당 사용 시간을 바로 계산할 수 있으며, 초기화 횟수로 나누어 1회 사용 시간을 계산할 수도 있습니다.

이 문서가 도움이 되었나요?
이 페이지의 내용