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

応用ガイド

最終更新 2026/10/03

1. 初期化パラメータ​

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

1.1 TDSettings​

プロパティ名タイプ説明
appIdStringAE管理画面で作成したプロジェクトのapp id
serverUrlStringAE管理画面で作成したプロジェクトのserver url
instanceNameString収集SDKインスタンスにエイリアスを設定します
modeTDModeSDKの実行モードの列挙型
enableLogbooleanログ出力を有効にするかどうか
defaultTimeZoneTimeZoneSDKのデフォルトタイムゾーン
encryptVersionintデータ暗号化を有効にした場合の鍵のバージョン番号
encryptKeyStringデータ暗号化を有効にした場合の公開鍵情報
enableAutoPushbooleanプッシュクリックの自動回収を有効にするかどうか
enableAutoCalibratedboolean自動時間補正を有効にするかどうか

1.2 TDMode​

列挙値説明
NORMALデータを通常どおり送信し、データベースに格納します。

DEBUG

Debugモードで収集データを送信します。

デバイスidをAEコンソールのテストデバイスリストに追加する必要があります。

AEコンソールの「デバッグモード」メニューで、リアルタイムに収集されたデータを確認できます。

送信データはAEシステムに保存されます。

DEBUG_ONLY

DebugOnlyモードで収集データを送信します。

デバイスidをAEコンソールのテストデバイスリストに追加する必要があります。

AEコンソールの「デバッグモード」メニューで、リアルタイムに収集されたデータを確認できます。

送信データはAEシステムに保存されません。

2. クライアントパラメータの設定​

クライアントトリガー型タスクを作成する際に、「クライアント条件」を入力できます。設定方法はクライアントトリガー型タスクの作成を参照してください。

「クライアント条件」で使用できるパラメータは、クライアントが自動収集する環境パラメータと、TDRemoteConfig SDKで設定したクライアントパラメータです。TDRemoteConfig SDKが提供するインターフェースでカスタムのクライアントパラメータを設定した後、そのカスタムクライアントパラメータをAEの「エンゲージ設定」の「クライアントパラメータ」管理モジュールに追加すると、エンゲージタスクで使用できます。

注意：クライアントでSETするパラメータの名前とタイプは、AEのエンゲージ管理画面で設定したクライアントパラメータと一致させる必要があります。

クライアントパラメータの追加

import cn.thinkingdata.remoteconfig.TDRemoteConfig;

// クライアントパラメータを設定。複数回設定した場合は和集合になります
JSONObject json = new JSONObject();
json.put("key","value");
TDRemoteConfig.addClientParams(json);

クライアントパラメータの削除

TDRemoteConfig.removeClientParam("key");

クライアントパラメータの取得

//すべてのクライアントパラメータを取得
JSONObject params = TDRemoteConfig.getClientParams();

//単一のクライアントパラメータを取得
Object obj = TDRemoteConfig.getClientParamValueForKey("key");

累積値タイプのクライアントパラメータ

TDRemoteConfig.accumulateNum("key",1);

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

3.1 自動取得​

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

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

3.2 手動取得​

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

TDStrategy.fetch();

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

4. リーチファネルイベント​

クライアントトリガー型チャンネルを作成する際に、リーチファネル設定をオンにできます。設定方法はチャンネル設定を参照してください。

リーチファネルをオンにすると、ファネルステップに関連付けるイベント名を設定できます。これにより、このチャンネルを使用するエンゲージタスクのデータ詳細ページで、設定したステップのコンバージョンデータを確認できます。

「実際到達」「プッシュクリック」に選択するイベントには、次の要件があります：

  • イベントには、エンゲージ固有のパラメータを含める必要があります。このパラメータは、プッシュ内容のTDStrategyResultオブジェクトのopsPropertiesプロパティから取得できます。具体的な送信方法は次のとおりです：
TDStrategy.setTriggerListener(new TDStrategyResultListener() {
    @Override
    public void onTriggerResult(TDStrategyResult tdStrategyResult) {
        TDAnalytics.track("ops_click",tdStrategyResult.opsProperties);
    }
});

5. テスト送信​

チャンネルの利用可否とタスクの有効性をすばやく検証できるよう、SDKはテストモードの有効化に対応しています。

TDSettings settings = new TDSettings();
settings.appId = "AppId";
settings.serverUrl = "ServerUrl";
// debug 
settings.mode = TDSettings.TDMode.DEBUG;
TDApp.init(this,settings);

クライアントでdebugモードを有効にすると、5秒ごとにテストタスクを取得します。AEのエンゲージモジュールでは、チャンネルテストまたはタスクテストを作成できます。タスクがトリガーを待っている間は、フロントエンドのページで進捗ノードを確認できます。

参考ドキュメント：タスクのテスト送信、チャンネルのテスト送信

クライアントトリガー型のテスト送信にはテストデバイスが必要です。テストデバイスリストでテストデバイスを選択または追加できます

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