본문으로 건너뛰기

자동 수집

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

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

enableAutoTrack을 호출하고 TDAutoTrackEventType 타입을 전달하여 자동 수집을 활성화할 수 있습니다. 현재 6가지를 지원합니다:

  • ta_app_start: 앱이 포그라운드로 진입할 때 트리거되며, 대응하는 타입은 TDAutoTrackEventType.APP_START입니다
  • ta_app_end: 앱이 백그라운드로 진입할 때 트리거되며, 대응하는 타입은 TDAutoTrackEventType.APP_END입니다
  • ta_app_install: 설치 후 앱을 처음 열 때 트리거되며, 대응하는 타입은 TDAutoTrackEventType.APP_INSTALL입니다
  • ta_app_crash: 포착되지 않은 예외로 앱이 비정상 종료될 때 트리거되며, 대응하는 타입은 TDAutoTrackEventType.APP_CRASH입니다
  • ta_app_view: APP에서 Navigator 라우트로 화면을 이동할 때 트리거되며, 대응하는 타입은 TDAutoTrackEventType.APP_VIEW_SCREEN입니다
  • ta_app_click: APP 컨트롤 클릭 이벤트는 유저가 컨트롤을 클릭할 때 트리거되며, 대응하는 타입은 TDAutoTrackEventType.APP_CLICK입니다

자동 수집 이벤트와 관련하여 다음 사항에 유의하십시오:

  1. 자동 수집 이벤트는 native SDK에서 구현되므로, 현재 동적 공통 속성을 자동 수집 이벤트에 추가할 수 없습니다.
  2. 게스트 ID나 공통 속성을 설정해야 하는 경우 자동 수집 이벤트를 활성화하기 전에 설정을 완료하십시오.

자동 수집 활성화 예시:

TDAnalytics.enableAutoTrack(TDAutoTrackEventType.APP_START |
    TDAutoTrackEventType.APP_END |
    TDAutoTrackEventType.APP_INSTALL |
    TDAutoTrackEventType.APP_CRASH |
    TDAutoTrackEventType.APP_CLICK |
    TDAutoTrackEventType.APP_VIEW_SCREEN);

2. 상세 소개​

2.1 페이지 조회 이벤트​

APP에서 Navigator 라우트로 화면을 이동할 때 트리거됩니다. 이벤트 상세 소개는 다음과 같습니다:

  • 이벤트 이름: ta_app_view

  • 시스템 속성:

    #screen_name: 문자열 타입, 페이지 이름

    #title: 문자열 타입, 페이지 제목

    #referrer: 문자열 타입, 이전 주소

  • 활성화 단계:

    • 전역 리스너를 추가합니다. MaterialApp 아래에 navigatorObservers를 추가합니다
    import 'package:thinking_analytics/autotrack/td_page_view.dart';

    void main() => runApp(new MaterialApp(
        navigatorObservers: TDNavigatorObserver.wrap([]), home: MyApp()));
    • enableAutoTrack을 호출하여 활성화합니다. 예시 코드는 다음과 같습니다:
    TDAnalytics.enableAutoTrack(TDAutoTrackEventType.APP_VIEW_SCREEN,
        autoTrackEventProperties: {
          "test_property": "test_property_value"
        },
        autoTrackPageConfig: TDAutoTrackConfig(
          pageConfigs: [
            TDAutoTrackPageConfig<Page1>(
              screenName: "Page1",
              title: "첫 번째 페이지",
            ),
            TDAutoTrackPageConfig<Page2>(
              screenName: "Page2",
              title: "두 번째 페이지",
              ignore: false,
              properties: {
                "multi_property": "multi_property_value"
              },
            )
          ],
    ));

autoTrackEventProperties: 자동 수집의 공통 속성을 설정합니다

autoTrackPageConfig: 페이지 조회 관련 설정 정보입니다. 각 페이지의 title과 screenName을 커스텀할 수 있으며, ignore는 해당 페이지의 수집을 무시할지 여부, properties는 해당 페이지의 커스텀 속성입니다

노트

가능한 한 일찍 활성화해야 합니다. 그렇지 않으면 첫 번째 페이지의 라이프사이클이 이미 지나서 첫 번째 페이지의 조회 이벤트를 수집할 수 없습니다

2.2 요소 클릭 이벤트​

APP 컨트롤 클릭 이벤트는 유저가 컨트롤을 클릭할 때 트리거됩니다

  • 이벤트 이름: ta_app_click

  • 시스템 속성:

    #screen_name: 문자열 타입, 페이지 이름

    #title: 문자열 타입, 페이지 제목

    #element_type: 문자열 타입, 요소 타입

    #element_content: 문자열 타입, 요소 내용

  • 활성화 단계

TDAnalytics.enableAutoTrack(TDAutoTrackEventType.APP_CLICK);
  • 컨트롤 커스텀 속성

TDElementKey를 설정하여 속성을 커스텀합니다

  • 첫 번째 파라미터: 요소 ID이며, 속성 #element_id에 대응합니다
  • properties: 커스텀 속성
  • isIgnore: 해당 컨트롤의 자동 수집 이벤트를 무시할지 여부
import 'package:thinking_analytics/autotrack/td_autotrack_config.dart';

ElevatedButton(
    key: TDElementKey("요소 ID", properties: {"key": "value"},isIgnore: true),
    onPressed: () {},
    child: Text(
      "버튼2",
      style: TextStyle(fontSize: 14),
    )),

3. 자동 수집 이벤트 공통 속성 설정​

enableAutoTrack을 호출할 때 autoTrackEventProperties 파라미터로 커스텀 속성을 설정할 수 있습니다

TDAnalytics.enableAutoTrack(TDAutoTrackEventType.APP_START,
    autoTrackEventProperties: {
  'auto_test': 'stu',
  'auto_arr': [1, 2, 3],
  'auto_obj': {'obj_test': 'xxx'}
});
이 문서가 도움이 되었나요?
이 페이지의 내용