# 自動収集イベントガイド
インスタンスを作成する設定で自動収集が必要なイベントを有効にすると、SDK がミニゲームの一部の動作を自動的に収集します。現在、自動収集を対応するイベントは主に次のとおりです:
対応できる自動収集イベントデータ:
- ミニゲームがフォアグラウンドに戻るイベント
- ミニゲームはバックグラウンドに戻され、この時間を記録します (バックグラウンドへの転送を開始)
次に、それぞれのデータ収集方法を詳しく紹介します。
# 自動収集イベントを有効化
config では、パラメーター autoTrack
の要素は、各自動収集イベントの切り替えを表し、true
に設定すると自動収集が有効になります。
var config = {
appid: "YOUR_APPID",
server_url: "YOUR_SERVER_URL",
autoTrack: {
appShow: true,
appHide: true,
properties: {
callback: (eventType:any) =>{
if (eventType === 'appShow')
{
return { appShowKey: 'appShowValue' };
}
else if (eventType === 'appHide')
{
return { appHideKey: 'appHideValue' };
}
else {
return {};
}
}
}
};
var te = new ThinkingAnalyticsAPI(config);
- appShow:ゲームを自動的に収集して開始するか、バックグラウンドからフォアグラウンドに入る
- appHide:フォアグラウンドからバックグラウンドまで小さなゲームを自動的に収集される
- properties:カスタム属性の自動収集(appShow/appHide 対応)
- callback:自動収集コールバック(appShow/appHide 対応)
# 自動収集イベント紹介
# 2.1 ミニゲームを起動
ミニゲームの起動は、ミニゲームが起動されたとき、またはミニゲームがバックグラウンドからフォアグラウンドに戻ったときにトリガーされます。詳細なイベントは次のとおりです。
- イベント名:ta_mg_show
- 自動収集プロパティ:
#scene
、シーン値、Wechat が提供するシーン値
ミニゲームの起動はフォアグラウンドとバックグラウンドの呼び出しによって影響を受けるため (項目数が多い)、直接的な分析には適していませんが、行動パスでユーザーの使用状況を特定でき、使用できるユーザー行動経路の初期行動とされます。
# 2.2 ミニゲームをハイド
ミニゲームの非表示は、ミニゲームがバックグラウンドに転送されるとトリガーされ、この使用時間は記録されます. 詳細なイベントは次のとおりです。
- イベント名:ta_mg_hide
- 自動収集プロパティ:
#scene
シーン値、Wechat が提供するシーン値#duration
数値型、今回起動(ta_mg_show)からハイドまでの経過時間
ミニゲームの隠しイベントは使用時間(秒単位)を記録するため、ユーザーの合計使用時間と平均使用時間を直接計算するか、初期化の回数で割って 1 回の使用時間を計算できます。