Flutter

最終更新 2026/10/03

最新バージョン：v1.0.0

更新日：2025-12-08

1. 概要

AE 4.4から、エンゲージモジュールに「クライアントトリガー型タスク」機能がリリースされました。アプリ内での新規ユーザー登録やキャラクター作成などのシナリオにおけるミリ秒単位のトリガーの要件に対応し、リアルタイムのA/B分流にも対応しています。クライアント側ではThinkingData SDKがAEのバックエンドと通信し、タスクの取得と計算を行います。

App側にThinkingData SDKを統合する必要があります。App側はThinkingData SDKとのやり取りだけを考慮すればよく、AE管理画面のタスクの詳細を気にする必要はありません。

2. 統合

Flutterプロジェクトのpubspec.yamlファイルに、次の依存関係を追加します：

dependencies:
  thinking_analytics: ^3.3.1
  td_remote_config: ^1.0.0
  td_strategy: ^1.0.0

クライアントトリガー型タスクには、次のThinkingData SDKが必要です：

SDK名	機能の紹介	バージョン要件
thinking_analytics	データの収集と処理を行います	>= 3.3.1
td_remote_config	AE管理画面の設定情報を取得します	>= 1.0.0
td_strategy	クライアントトリガー型の機能を提供します	>=1.0.0

3. 初期化

import 'package:thinking_analytics/td_analytics.dart';
import 'package:td_remote_config/remote_config.dart';
import 'package:td_strategy/strategy.dart';

TDAnalytics.init("appId", "serverUrl");

TDRemoteConfig.init("appId", "serverUrl");

//方法1
TDStrategy.init("appId", "serverUrl");
//方法2
TDStrategySettings strategySettings = TDStrategySettings();
strategySettings.appId = "appId";
strategySettings.serverUrl = "serverUrl";
TDStrategy.initWithConfig(strategySettings);

4. コールバックリスナーの設定

SDKの初期化に成功したら、TDStrategy SDKにコールバックリスナーを設定します。

TDStrategy.setTriggerListener((tdStrategyResult) {

});

4.1 コールバックのデータモデル

tdStrategyResultの型はMap<String, dynamic>で、プロパティの説明は次のとおりです：

プロパティ名	タイプ	説明
channelMsgType	String	チャンネルのメッセージタイプ
appId	String	AEプロジェクトのapp id
pushId	String	エンゲージタスクのチャンネル送信ID
taskId	String	エンゲージタスクのID
content	Map	エンゲージタスクのプッシュ内容
userParams	Map	クライアントチャンネルのカスタムパラメータ
opsProperties	Map	クライアントトリガー型タスクに付与されるチャンネル情報。リーチファネルイベントで返送するパラメータとして使用します。