본문으로 건너뛰기

자동 수집

최근 업데이트 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에서 React Navigation 라우팅으로 화면을 이동할 때 트리거되며, 대응하는 타입은 TDAutoTrackEventType.APP_VIEW_SCREEN입니다(3.2.0 이상 버전에서 지원)
  • ta_app_click: APP 컨트롤 클릭 이벤트는 유저가 컨트롤을 클릭할 때 트리거되며, 대응하는 타입은 TDAutoTrackEventType.APP_CLICK입니다(3.2.0 이상 버전에서 지원)

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

  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 페이지 조회 이벤트는 React Navigation ^2.0 ~ ^6.0을 지원합니다

APP에서 React Navigation 라우팅으로 화면을 이동할 때 트리거되며, 이벤트에 대한 자세한 설명은 다음과 같습니다:

  • 이벤트 이름: ta_app_view

  • 시스템 속성:

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

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

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

  • 활성화 방법:

    • enableAutoTrack을 호출하고 TDAutoTrackEventType.APP_VIEW_SCREEN을 전달합니다
    TDAnalytics.enableAutoTrack(TDAutoTrackEventType.APP_VIEW_SCREEN);
    • 스크립트 실행
    node node_modules/react-native-thinking-data/ThinkingDataRNHook.js -run

  • 페이지 커스텀 속성 설정: Navigation으로 이동할 때 params에 커스텀 속성을 추가할 수 있으며, SDK는 params에 설정한 값으로 App 페이지 조회 이벤트의 속성을 자동으로 보충하거나 덮어씁니다.

navigation.navigate('PageB', {
  thinkingdataparams: {
    name: 'name_A',
    '#title': '두 번째 페이지',
    '#screen_name': "page_B"
  }
});

#title과 #screen_name을 커스텀하려면 thinkingdataparams 파라미터에 전달하면 됩니다.

  • 단일 페이지 조회 이벤트 무시: thinkingdataparams에 TDIgnoreViewScreen 속성을 추가하고 값을 true로 설정하면 해당 페이지 조회 이벤트를 무시합니다 
    navigation.navigate('PageB', {
      thinkingdataparams: {
        name: 'name_A',
        '#title': '두 번째 페이지',
        '#screen_name': "page_B",
        TDIgnoreViewScreen: true
      }
    });

2.2 요소 클릭 이벤트​

App 요소 클릭 이벤트는 React Native 0.23 ~ 0.70.0을 지원합니다

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

  • 이벤트 이름: ta_app_click

  • 시스템 속성:

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

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

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

  • 활성화 방법:

    • enableAutoTrack을 호출하고 TDAutoTrackEventType.APP_CLICK을 전달합니다
    TDAnalytics.enableAutoTrack(TDAutoTrackEventType.APP_CLICK);
    • 스크립트 실행:
    node node_modules/react-native-thinking-data/ThinkingDataRNHook.js -run

  • 컨트롤 커스텀 속성 설정: 컨트롤에 커스텀 속성 thinkingdataparams를 추가합니다

<CustomButton
  title="버튼"
  thinkingdataparams={{
    name: 'button',
    pro_key:'pro_value'
  }}
/>
  • 단일 컨트롤 클릭 이벤트 무시: thinkingdataparams에 TDIgnoreViewClick 속성을 추가하고 값을 true로 설정하면 해당 컨트롤 클릭 이벤트를 무시합니다
<CustomButton
  title="버튼"
  thinkingdataparams={{
    name: 'button',
    pro_key:'pro_value',
    TDIgnoreViewClick: true
  }}
/>

3. 자동 수집 이벤트 커스텀 속성 설정​

enableAutoTrack을 호출하여 자동 수집 이벤트의 속성을 설정할 수 있습니다

TDAnalytics.enableAutoTrack(TDAutoTrackEventType.APP_START,{
        auto_name: "xxx",
        auto_age: "xxx"
})
이 문서가 도움이 되었나요?
이 페이지의 내용