メインコンテンツまでスキップ

自動収集

最終更新 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': '2番目のページ',
    '#screen_name': "page_B"
  }
});

#titleと#screen_nameをカスタマイズする必要がある場合は、thinkingdataparamsパラメーター内で渡すことができます。

  • 単一のページ閲覧イベントを無視する：thinkingdataparamsにTDIgnoreViewScreenプロパティを追加し、値をtrueにすると、そのページ閲覧イベントは無視されます 
    navigation.navigate('PageB', {
      thinkingdataparams: {
        name: 'name_A',
        '#title': '2番目のページ',
        '#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"
})
このページは役に立ちましたか？
このページの内容