menu
Is this helpful?

# uni-app 자동 수집 가이드

자동 수집 기능을 사용하려면 인스턴스의 config에 자동 수집하려는 이벤트를 활성화하면 자동으로 수집됩니다.

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

  1. 미니 프로그램 초기 설정: 1회 이용 시 1회 트리거
  2. 미니 프로그램 기동: 기동 및 백그라운드에서 재개
  3. 미니 프로그램이 백그라운드로 들어갈 때: 이번 활성화와 경과 시간을 기록
  4. 미니 프로그램 표시 또는 백그라운드에서 재개 시, 페이지 경로 및 이전 페이지 경로를 자동으로 기록
  5. 미니 프로그램에서 공유: 자동으로 공유 시의 페이지를 기록

각각의 수집 방법을 소개합니다.

# 1. 자동 수집 활성화

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

var config = {
  appid: "YOUR-APP-ID",
  server_url: "https://yourserverurl.com",
  autoTrack: {
    appLaunch: true, // 미니 프로그램 기동 자동 수집
    appShow: true, // 미니 프로그램 활성화 및 백그라운드에서 재개 자동 수집
    appHide: true, // 미니 프로그램 백그라운드 전환 자동 수집
    pageShow: true, // 미니 프로그램 페이지 표시 및 포어그라운드 전환 자동 수집
    pageShare: true, // 미니 프로그램 공유 자동 수집
  }
};
  • appLaunch: 미니 프로그램 기동 자동 수집
  • appShow: 미니 프로그램 활성화 및 백그라운드에서 재개 자동 수집
  • appHide: 미니 프로그램 백그라운드 전환 자동 수집
  • pageShow: 미니 프로그램 페이지 표시 및 포어그라운드 전환 자동 수집
  • pageShare: 미니 프로그램 공유 자동 수집

# 2. 자동 수집 이벤트 설명

# 2.1 미니 프로그램 초기 설정

미니 프로그램 초기 설정은 미니 프로그램이 처음 기동할 때 또는 앱이 프로세스 중단 후 재기동할 때 트리거됩니다. (프로세스 중 라이프사이클에서 한 번만 카운트)

  • 이벤트 이름: ta_mp_launch
  • 자동 수집 속성:
    • #scene: 씬 값, 미니 프로그램 벤더의 씬 값

미니 프로그램 초기 설정 이벤트를 통해, 일일 사용자 이용 횟수, 1인당 이용 횟수, 씬 값으로 세그먼트 하여 다양한 사용자 이용 상황을 분석할 수 있습니다.

# 2.2 미니 프로그램 기동

미니 프로그램이 기동되거나 백그라운드에서 재개될 때 트리거됩니다.

  • 이벤트 이름: ta_mp_show
  • 자동 수집 속성:
    • #scene: 씬 값, 미니 프로그램 벤더의 씬 값
    • #url_path: URL 경로

미니 프로그램 기동은 전후의 호출에 영향을 받기 때문에 직접적인 분석에는 적합하지 않지만, 행동 경로에서 사용자의 사용 방식을 특정할 수 있어 사용자 시퀀스의 초기 행동으로 사용됩니다.

# 2.3 미니 프로그램 하이드

미니 프로그램이 백그라운드로 전환될 때 트리거되며, 이번 사용의 경과 시간을 기록합니다.

  • 이벤트 이름: ta_mp_hide
  • 자동 수집 속성:
    • #scene: 씬 값, 미니 프로그램 벤더의 씬 값
    • #duration: 수치형, 이번 기동(ta_mp_show)에서 하이드까지의 경과 시간

미니 프로그램 하이드 이벤트는 사용 시간 경과(단위: 초)가 기록되어 사용자 이용 시간 계산에 적합합니다.

# 2.4 미니 프로그램 페이지뷰

미니 프로그램의 페이지가 표시되거나 포어그라운드로 전환될 때 트리거되며, 페이지 경로 및 이전 페이지 경로를 기록합니다.

  • 이벤트 이름: ta_mp_view
  • 자동 수집 속성:
    • #scene: 씬 값, 미니 프로그램 벤더의 씬 값
    • #url_path: 페이지 경로, 표시된 페이지의 경로
    • #referrer: 이전 페이지 경로

미니 프로그램 페이지뷰 이벤트를 통해, 페이지별 PV, UV 및 미니 프로그램 이용 경로를 분석할 수 있습니다.

# 2.5 미니 프로그램 페이지 공유

미니 프로그램의 공유 버튼을 클릭할 때 트리거됩니다.

  • 이벤트 이름: ta_mp_share
  • 자동 수집 속성:
    • #scene: 씬 값, 미니 프로그램 벤더의 씬 값
    • #url_path: 페이지 경로, 표시된 페이지의 경로

미니 프로그램의 공유 이벤트는 공유율 분석에 적합합니다.

← 디버깅 →