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

自動収集

最終更新 2026/08/27

自動収集機能を提供しています。インスタンスを作成する際のconfigで、自動収集したいイベントを有効にするだけで、SDKはミニアプリの一部の行動を自動的に収集します。現在、主に次のイベントの自動収集に対応しています：

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

  1. ミニアプリの初期化。ユーザーの1回の利用につき1回だけトリガーされます
  2. ミニアプリの起動。起動と、バックグラウンドからフォアグラウンドへの復帰を含みます
  3. ミニアプリのバックグラウンドへの移行。今回のアクセス（起動からバックグラウンドへの移行まで）の時間を記録します

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

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

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

var config = {
  appid: "YOU-APP-ID",
  server_url: "https://youserverurl.com",
  autoTrack: {
    appLaunch: true, // ta_mp_launchを自動収集
    appShow: true, // ta_mp_showを自動収集
    appHide: true, // ta_mp_hideを自動収集
    appInstall: true,//インストールイベントを自動収集（nativeでのみ有効）
    appCrash: true, // クラッシュイベントを自動収集（nativeでのみ有効）
  }
};
  • appLaunch：ミニアプリの初期化を自動収集
  • appShow：ミニアプリの起動、またはバックグラウンドからフォアグラウンドへの移行を自動収集
  • appHide：ミニアプリのフォアグラウンドからバックグラウンドへの移行を自動収集
  • appInstall ：インストールイベントを自動収集（nativeでのみ有効）
  • appCrash ：クラッシュイベントを自動収集（nativeでのみ有効）

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

2.1 ミニアプリの初期化​

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

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

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

2.2 ミニアプリの起動​

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

  • イベント名：ta_mp_show

  • 自動収集プロパティ：

    • #scene：シーン値。WeChatが提供するシーン値から取得します
    • #url_path：ページパス。ミニアプリの起動時に表示されたページのパスです

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

2.3 ミニアプリの非表示​

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

  • イベント名：ta_mp_hide

  • 自動収集プロパティ：

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

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

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