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

自動収集

最終更新 2026/08/27

1. 自動収集イベント​

TDAnalytics SDKは現在、3種類のイベントの自動収集に対応しています：

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

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

// 自動収集を有効化
UTDAnalytics::EnableAutoTrack();

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

収集を有効にする自動収集イベントを手動で渡すこともできます：

TArray<FString> EventTypeList;
EventTypeList.Emplace(TEXT("ta_app_install"));
EventTypeList.Emplace(TEXT("ta_app_start"));
EventTypeList.Emplace(TEXT("ta_app_end"));
UTDAnalytics::EnableAutoTrackWithType(EventTypeList, AppID);

2. カスタムプロパティの設定​

v1.4.1以降、自動収集イベントにカスタムプロパティを設定できます。指定したイベントを収集する際、カスタムプロパティがそのイベントのプロパティに結合されて送信されます。

TArray<FString> EventTypeList;
EventTypeList.Emplace(TEXT("ta_app_install"));
EventTypeList.Emplace(TEXT("ta_app_start"));
EventTypeList.Emplace(TEXT("ta_app_end"));
UTDAnalytics::EnableAutoTrackWithTypeAndProperties(EventTypeList, TEXT("{\"autoTrackKey1\":\"autoTrackvalue1\",\"autoTrackKey2\":\"autoTrackvalue2\"}"), AppID);

3. 自動収集イベントのコールバックの設定​

V1.5.0以降、自動収集イベントにコールバックメソッドを設定できます。指定したイベントを収集する際、このコールバックを通じて通知され、現在付与されているイベントプロパティが渡されます。必要に応じてデータを転送したり、新しいイベントプロパティを追加して返したりできます。

//コールバックの定義
FString UTAUserWidget::TAAutoTrackProperties(FString AutoTrackEventType, FString Properties)
{
    //AutoTrackEventType 自動収集イベントのタイプ
    //Properties 現在のイベントに付与されたイベントプロパティ
    //処理ロジック
    FDateTime TDateTime = FDateTime::Now();
    int64 SecondTimestamp = TDateTime.ToUnixTimestamp();
    int32 MillisecondPart = TDateTime.GetMillisecond();
    FString TimeStr = *FString::Printf(TEXT("%llu"), SecondTimestamp);
    TimeStr += *FString::Printf(TEXT("%lld"), MillisecondPart);
    return "{\"auto_property1_name\":\"" + AutoTrackEventType + "\",\"auto_property2_time\":\"" + TimeStr + "\"}";
}

//コールバックの設定
void UTAUserWidget::Call_TA_SetAutoTrackEventListener()
{   
    TArray<FString> EventTypeList;
    EventTypeList.Emplace(TEXT("ta_app_install"));
    EventTypeList.Emplace(TEXT("ta_app_start"));
    EventTypeList.Emplace(TEXT("ta_app_end"));
    UTDAnalytics::SetAutoTrackEventListener(this, &UTAUserWidget::TAAutoTrackProperties, EventTypeList, AppID);
}
このページは役に立ちましたか？
このページの内容