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

Unreal

最終更新 2026/09/03
ヒント

現在、AndroidとiOSプラットフォームに対応しています。

最新バージョン：v1.0.0

更新日：2025-01-09

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

Betaバージョン：なし

1. 概要​

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

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

2. SDKの統合​

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

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

2.1 プラグインの統合​

Unreal SDKをダウンロードして解凍し、TDAnalytics TDRemoteConfig TDStrategyをプロジェクトのPluginsディレクトリに配置します。Pluginsディレクトリが存在しない場合は、まずプロジェクトのルートディレクトリにPluginsディレクトリを作成し、次にこの3つのプラグインをその中に配置します。

2.2 プラグインの有効化​

  1. Unreal Editorを再起動します

  2. 「編集」>「プラグイン」を開き、プロジェクトのTDAnalytics TDRemoteConfig TDStrategyカテゴリでTDAnalytics TDRemoteConfig TDStrategyを有効にします

  3. 「編集」>「プロジェクト設定」を開き、「プラグイン」カテゴリでTDAnalytics TDRemoteConfig TDStrategyのパラメータを設定します：

    • Server Url: 必須。受信側のURLです。httpsのURLを使用する必要があります
    • App ID: 必須。プロジェクトのAPP IDです。AE管理画面の「プロジェクト管理」ページで確認できます
    • Enable Log：デバッグログを有効にするかどうか

  4. ConfigディレクトリにあるDefaultEngine.ini ファイルに次の内容を追加します：

[Analytics]
ProviderModuleName=TDAnalytics
  1. C++コードで直接使用する場合は、プロジェクトの*.Build.csファイルに次の内容を追加する必要があります：
PrivateDependencyModuleNames.AddRange(new string[] { "TDAnalytics","TDRemoteConfig","TDStrategy" });        
PrivateIncludePathModuleNames.AddRange(new string[] { "TDAnalytics","TDRemoteConfig","TDStrategy" });

3. 初期化​

SDKを初期化します

#include "TDAnalytics.h"
#include "TDRemoteConfig.h"
#include "TDStrategy.h"
//SDKを初期化
UTDAnalytics::Initialize();    
UTDRemoteConfig::Initialize();    
UTDStrategy::Initialize();

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

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

void OnTriggerResult(FString str){    

}

UTDStrategy::SetTriggerListener(OnTriggerResult);

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

プロパティの説明

プロパティ名タイプ説明
channelMsgTypeStringチャンネルのメッセージタイプ
appIdStringAEプロジェクトのapp id
pushIdStringエンゲージタスクのチャンネル送信ID
taskIdStringエンゲージタスクのID
contentJSONObjectエンゲージタスクのプッシュ内容
userParamsJSONObjectクライアントチャンネルのカスタムパラメータ
opsPropertiesJSONObjectクライアントトリガー型タスクに付与されるチャンネル情報。リーチファネルイベントで返送するパラメータとして使用します。
このページは役に立ちましたか？
このページの内容