본문으로 건너뛰기

자동 수집

최근 업데이트 2026. 08. 27.

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

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

  1. 미니 프로그램 초기화, 유저가 한 번 사용할 때 한 번만 트리거됨
  2. 미니 프로그램 시작, 시작과 백그라운드에서 포그라운드로의 복귀를 포함
  3. 미니 프로그램이 백그라운드로 전환되며, 이번 방문(시작부터 백그라운드 전환까지)의 시간을 기록

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

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

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

var config = {
  appid: "YOU-APP-ID",
  server_url: "https://youserverurl.com",
  autoTrack: {
    appLaunch: true, // ta_mp_launch 자동 수집
    appShow: true, // ta_mp_show 자동 수집
    appHide: true, // ta_mp_hide 자동 수집
    appInstall: true,//설치 이벤트 자동 수집(native에서만 적용)
    appCrash: true, // 크래시 이벤트 자동 수집(native에서만 적용)
  }
};
  • appLaunch: 미니 프로그램 초기화 자동 수집
  • appShow: 미니 프로그램 시작 또는 백그라운드에서 포그라운드 진입 자동 수집
  • appHide: 미니 프로그램의 포그라운드에서 백그라운드 진입 자동 수집
  • appInstall: 설치 이벤트 자동 수집(native에서만 적용)
  • appCrash: 크래시 이벤트 자동 수집(native에서만 적용)

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

2.1 미니 프로그램 초기화​

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

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

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

2.2 미니 프로그램 시작​

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

  • 이벤트 이름: ta_mp_show

  • 자동 수집 속성:

    • #scene, 장면 값으로, 위챗에서 제공하는 장면 값을 사용합니다
    • #url_path, 페이지 경로로, 미니 프로그램 시작 시 표시되는 페이지의 경로입니다

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

2.3 미니 프로그램 숨김​

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

  • 이벤트 이름: ta_mp_hide

  • 자동 수집 속성:

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

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

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