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

自動収集

最終更新 2026/10/03

インスタンスを作成する際のconfigで、自動収集したいイベントを有効にすると、SDKはミニゲームの一部の行動を自動的に収集します。現在、主に次のイベントの自動収集に対応しています：

現在対応している自動収集データは次のとおりです：

  1. ミニゲームがフォアグラウンドに戻ったイベント
  2. ミニゲームがバックグラウンドに移行したイベント。今回のアクセス（起動からバックグラウンドへの移行まで）の時間を記録します

以下では、各データの収集方法について詳しく説明します

1. 自動収集イベントの有効化​

configでは、パラメーターautoTrack内の各要素が自動収集イベントごとのスイッチを表します。trueに設定すると自動収集が有効になります：

var config = {
    appId: "YOUR_APPID",
    serverUrl: "YOUR_SERVER_URL",
    autoTrack: {
         appLaunch: true, // ta_mg_launchを自動収集
         appShow: true, // ta_mg_showを自動収集
         appHide: true, // ta_mg_hideを自動収集
         properties: { staticKey: 'staticValue' }, // 自動収集のカスタムプロパティ
         callback: (eventType:any) =>{ // 自動収集のコールバック
           if (eventType === 'appShow')
           {
            return { appShowKey: 'appShowValue' };
           } 
           else if (eventType === 'appHide')
           {
            return { appHideKey: 'appHideValue' };
           } 
           else {
             return {};
           }
         }
     }
};
TDAnalytics.init(config);
  • appLaunch：ミニゲームの初期化を自動収集
  • appShow：ミニゲームの起動、またはバックグラウンドからフォアグラウンドへの移行を自動収集
  • appHide：ミニゲームのフォアグラウンドからバックグラウンドへの移行を自動収集
  • properties：自動収集のカスタムプロパティ（appShow/appHideに対応）
  • callback：自動収集のコールバック（appShow/appHideに対応）

最初の自動収集イベントにアカウント、ゲスト、静的共通プロパティを含める必要がある場合は、初期化時に次の設定を渡します：

TDAnalytics.init(config, () => {
  TDAnalytics.login("TA")
  TDAnalytics.setDistinctId("DIS_TA")
  TDAnalytics.setSuperProperties({
    key: "value"
  });
});

2. 自動収集イベントの詳細​

2.1 ミニゲームの初期化​

ミニゲームの初期化は、ミニゲームが初めて開かれたとき、またはユーザーがプロセスを終了してから再び開いたときにトリガーされます。プロセスのライフサイクル内で1回だけトリガーされます。イベントの詳細は次のとおりです：

  • イベント名：ta_mg_launch

  • 自動収集プロパティ：

    • #scene：シーン値。WeChatが提供するシーン値から取得します
    • #start_reason：アプリの起動元。getLaunchOptionsSyncインターフェースから取得したパラメーターです

ミニゲームの初期化イベントを使うと、1日あたりのユーザーの使用回数や1人あたりの使用回数を計算できます。シーン値でグループ化して、シーン値ごとのユーザーの利用状況を確認することもできます。

2.2 ミニゲームの起動​

ミニゲームの起動は、ミニゲームが起動されたとき、またはミニゲームがバックグラウンドからフォアグラウンドに戻ったときにトリガーされます。イベントの詳細は次のとおりです：

  • イベント名：ta_mg_show
  • 自動収集プロパティ：
    • #scene：シーン値。WeChatが提供するシーン値から取得します

ミニゲームの起動は、フォアグラウンドとバックグラウンドの切り替えの影響を受ける（件数が多い）ため、直接の分析にはあまり適していません。ただし、行動フローの中でユーザーの1回の利用を示すことができ、ユーザーの行動フローの最初の行動として使えます

2.3 ミニゲームの非表示​

ミニゲームの非表示は、ミニゲームがバックグラウンドに移行したときにトリガーされ、今回の利用時間を記録します。イベントの詳細は次のとおりです：

  • イベント名：ta_mg_hide

  • 自動収集プロパティ：

    • #scene：シーン値。WeChatが提供するシーン値から取得します
    • #duration：数値型。今回の起動（ta_mg_show）から非表示になるまでの継続時間を表します

ミニゲームの非表示イベントは利用時間（単位は秒）を記録するため、ユーザーの総利用時間や1人あたりの利用時間を直接計算できます。初期化回数で割って1回あたりの利用時間を計算することもできます。

このページは役に立ちましたか？
このページの内容