Unity

最終更新 2026/10/03

ヒント

Unity SDK：iOS、Androidプラットフォームに対応しています

対応する最低バージョンはUnity 5.4.0です

最新バージョン：v1.3.1

更新日：2025-12-03

リソースのダウンロード：ダウンロード

Betaバージョン：なし

1. 概要

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

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

2. 統合

2.1 SDKの手動統合

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

SDK名	機能の紹介	バージョン要件
ta_unity_sdk.unitypackage	データの収集と処理を行います	>= 3.2.0
ta_remoteconfig_sdk.unitypackage	AE管理画面の設定情報を取得します	>= 1.0.0
ta_core_sdk.unitypackage	基本コンポーネントの機能を提供します	>= 1.0.0
ta_strategy_sdk.unitypackage	クライアントトリガー型の機能を提供します	>=1.0.0

1. ページ上部のリソースのダウンロードリンクをクリックし、SDKをダウンロードして解凍します
2. ta_unity_sdk.unitypackage、ta_remoteconfig_sdk.unitypackage、ta_strategy_sdk.unitypackage、ta_core_sdk.unitypackageをダブルクリックします

3. 初期化

SDKを初期化します。TDSettingsの設定の詳しい使い方は応用ガイドを参照してください。

using ThinkingData.Core;
// TDSettingsの設定の詳しい使い方は【応用ガイド】を参照してください
TDSettings settings = new TDSettings("AppId","ServerUrl");
TDApp.Init(settings);

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

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

using ThinkingData.Strategy;

public class ConcreteStrategyResultListener : TDStrategyResultListener {
    public void OnTriggerResult(TDStrategyResult result) {
    }
}

TDStrategy.SetTriggerListener(new ConcreteStrategyResultListener());

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

public class TDStrategyResult {
    public string appId;
    public string taskId;
    public string channelMsgType;
    public string pushId;
    public Dictionary<string, object> content;
    public Dictionary<string, object> userParams;
    public Dictionary<string, object> opsProperties;
}

プロパティの説明

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