自動収集

最終更新 2026/08/27

TDAnalytics SDKは、次の3種類のイベントの自動収集を提供しています：

• ta_app_install: ゲームのインストール。インストール後に初めてゲームを開いたときにこのイベントを収集します
• ta_app_start: ゲームがフォアグラウンドに移行したときにこのイベントを収集します
• ta_app_end: ゲームがバックグラウンドに移行したときにこのイベントを収集します

enableAutoTrackインターフェースを呼び出して、自動収集を有効にできます：

// 自動収集を有効化
TDAnalytics::enableAutoTrack();

注意：ゲストIDをカスタマイズする必要がある場合は、必ず自動収集機能を有効にする前にsetDistinctIdインターフェースを呼び出してゲストIDを設定してください。

v1.3.2以降、自動収集イベントへのカスタムプロパティの設定に対応しています。指定したイベントを収集する際に、カスタムプロパティがそのイベントのプロパティにマージされて送信されます。

// 自動収集を有効化し、カスタムプロパティを設定
TDJSONObject autoProperties;
autoProperties.setString("auto_track_key", "auto_track_value");
TDAnalytics::enableAutoTrack(autoProperties);