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

自動収集

最終更新 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: "2番目のページ",
              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を設定してプロパティをカスタマイズします

  • 1つ目のパラメータ：要素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'}
});
このページは役に立ちましたか？
このページの内容