자동 수집

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

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

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

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

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

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

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

var config = {
    appid: "YOUR_APPID",
    server_url: "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 {};
           }
         }
     }
};

• appLaunch: 미니 게임 초기화 자동 수집
• appShow: 미니 게임 시작 또는 백그라운드에서 포그라운드 진입 자동 수집
• appHide: 미니 게임의 포그라운드에서 백그라운드 진입 자동 수집
• properties: 자동 수집 커스텀 속성(appShow/appHide 지원)
• callback: 자동 수집 콜백(appShow/appHide 지원)

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

2.1 미니 게임 시작

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

• 이벤트 이름: ta_mg_show

• 자동 수집 속성:

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

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

2.2 미니 게임 숨김

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

• 이벤트 이름: ta_mg_hide

• 자동 수집 속성:

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

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