応用ガイド
1. 初期化パラメータ
初期化時に渡すTDStrategySettingsの設定の詳細は次のとおりです
1.1 TDStrategySettings
| プロパティ名 | タイプ | 説明 |
|---|---|---|
| appId | String | AE管理画面で作成したプロジェクトのapp id |
| serverUrl | String | AE管理画面で作成したプロジェクトのserver url |
| mode | TDStrategyMode | SDKの実行モード |
2. クライアントパラメータの設定
クライアントトリガー型タスクを作成する際に、「クライアント条件」を入力できます。設定方法はクライアントトリガー型タスクの作成を参照してください。
「クライアント条件」で使用できるパラメータは、クライアントが自動収集する環境パラメータと、TDRemoteConfig SDKで設定したクライアントパラメータです。TDRemoteConfig SDKが提供するインターフェースでカスタムのクライアントパラメータをSETした後、そのカスタムクライアントパラメータをAEの「エンゲージ設定」の「クライアントパラメータ」管理モジュールに追加すると、エンゲージタスクで使用できます。
注意：クライアントでSETするパラメータの名前とタイプは、AEのエンゲージ管理画面で設定したクライアントパラメータと一致させる必要があります。
クライアントパラメータの追加
TDRemoteConfig.addClientParams({
"key":"value"
});
クライアントパラメータの削除
TDRemoteConfig.removeClientParam("key")
クライアントパラメータの取得
//すべてのクライアントパラメータを取得
TDRemoteConfig.getClientParams();
//単一のクライアントパラメータを取得
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((tdStrategyResult) {
TDAnalytics.track("ops_click",properties:tdStrategyResult["opsProperties"] );
});
5. テスト送信
チャンネルの利用可否とタスクの有効性をすばやく検証できるよう、SDKはテストモードの有効化に対応しています。
//3つのSDKで同時にDEBUGモードを使用する必要があります
TDConfig config = TDConfig();
config.appId = "appId";
config.serverUrl = "serverUrl";
config.setMode(TDMode.DEBUG);
TDAnalytics.initWithConfig(config);
TDRemoteConfigSettings settings = TDRemoteConfigSettings();
settings.appId = "appId";
settings.serverUrl = "serverUrl";
settings.mode = TDRemoteConfigMode.DEBUG;
TDRemoteConfig.initWithConfig(settings);
TDStrategySettings strategySettings = TDStrategySettings();
strategySettings.appId = "appId";
strategySettings.serverUrl = "serverUrl";
strategySettings.mode = TDStrategyMode.DEBUG;
TDStrategy.initWithConfig(strategySettings);
クライアントでdebugモードを有効にすると、5秒ごとにテストタスクを取得します。AEのエンゲージモジュールでは、チャンネルテストまたはタスクテストを作成できます。タスクがトリガーを待っている間は、フロントエンドのページで進捗ノードを確認できます。
参考ドキュメント：タスクのテスト送信、チャンネルのテスト送信
クライアントトリガー型のテスト送信にはテストデバイスが必要です。テストデバイスリストでテストデバイスを選択または追加できます