応用ガイド

最終更新 2026/09/03

1. 初期化パラメータ

初期化時に渡すTDSettingsの設定の詳細は次のとおりです：

1.1 TDSettings

プロパティ名	タイプ	説明
appId	String	AE管理画面で作成したプロジェクトのapp id
serverUrl	String	AE管理画面で作成したプロジェクトのserver url
mode	String	SDKの実行モード（none、debug、debugOnly）
enableLog	Boolean	ログ出力を有効にするかどうか
zoneOffset	Number	SDKのデフォルトタイムゾーン
enableBatch	Boolean	イベントのキャッシュとバッチ送信を有効にするかどうか
batchConfig	object	バッチ送信の設定情報
autoTrack	object	自動収集関連の設定

1.2 SDKの実行モード

列挙値	説明
normal、none	データを通常どおり送信し、データベースに格納します。
debug	Debugモードで収集データを送信します。 デバイスidをAEコンソールのテストデバイスリストに追加する必要があります。 AEコンソールの「デバッグモード」メニューで、リアルタイムに収集されたデータを確認できます。 送信データはAEシステムに保存されます。
debugOnly	DebugOnlyモードで収集データを送信します。 デバイスidをAEコンソールのテストデバイスリストに追加する必要があります。 AEコンソールの「デバッグモード」メニューで、リアルタイムに収集されたデータを確認できます。 送信データはAEシステムに保存されません。

2. 取得タイミングのカスタマイズ

2.1 自動取得

次のシナリオでは、SDKがリモート設定データを自動的に取得します

• ミニゲームのコールドスタート
• ミニゲームのフォアグラウンド・バックグラウンド切り替えで、前回からの間隔が6時間を超えた場合
• TDAnalytics SDKのアカウント体系に変更があった場合（login、logoutなど）

2.2 手動取得

SDKのメソッドを手動で呼び出して、いつでもリモート設定を取得できます

TDRemoteConfig.fetch();

このAPIには内部で頻度制御があるため、頻繁に取得しないでください。

3. Fetchパラメータのカスタマイズ

Fetchパラメータは、クライアントSDKがAEサーバーに値を要求する際に使用できるパラメータです。Fetchパラメータをカスタマイズし、構成チャンネルの環境パラメータとして追加すると、戦略の設定時にFetchパラメータを使ってターゲットユーザーをカスタマイズできます。

3.1 追加

TDRemoteConfig.setCustomFetchParams({});

3.2 削除

指定したkeyに基づいて削除します

TDRemoteConfig.removeCustomFetchParam("key");