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

Unreal

最終更新 2026/10/03

最新バージョン：v1.0.0

更新日：2025-01-09

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

Betaバージョン：なし

1. 概要​

AE 4.4から、エンゲージモジュールに「構成センター」機能がリリースされました。AE管理画面で機能パラメータの構成を追加し、クライアントSDKでAppに取得することで、プレイヤーとのインタラクション内容をきめ細かくカスタマイズできます。

このドキュメントでは、クライアントSDKの統合手順を説明します。App側はThinkingData SDKとのやり取りだけを考慮すればよく、AE管理画面の構成の詳細を気にする必要はありません。

2. SDKの統合​

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

SDK名機能の紹介バージョン要件
TDAnalyticsデータの収集と処理を行います>= 2.1.0
TDRemoteConfigAE管理画面の設定情報を取得します>= 1.0.0

2.1 プラグインの統合​

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

2.2 プラグインの有効化​

  1. Unreal Editorを再起動します

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

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

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

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

    [Analytics]
    ProviderModuleName=TDAnalytics

  5. C++コードで直接使用する場合は、プロジェクトの*.Build.csファイルに次の内容を追加する必要があります：

    PrivateDependencyModuleNames.AddRange(new string[] { "TDAnalytics","TDRemoteConfig" });        
    PrivateIncludePathModuleNames.AddRange(new string[] { "TDAnalytics","TDRemoteConfig" });

3. 初期化​

メインスレッドでSDKを初期化します

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

4. 使用方法​

4.1 データ構造のサンプル​

"configId" : {
    "templateId" : [
        {
         "#strategy_id" : "2024121001",
          "paramater_x" : "1111",
          "#ops_receipt_properties" : {}
        }
    ],
    "#custom_params" : {

    }
}

補足：

configId：エンゲージ管理画面の構成センターモジュールで作成した「構成項目ID」。業務モジュールの情報を識別するために使用します。構成項目の詳細は構成項目管理を参照してください

templateId：業務側で「構成項目」の下に追加した「テンプレートID」。具体的な機能モジュールの情報を識別するために使用します。構成テンプレートの詳細は構成テンプレート管理を参照してください

#strategy_id：戦略の一意のID。戦略のライフサイクル管理に使用します。構成戦略の詳細は構成戦略管理を参照してください

paramater_x：構成テンプレートのパラメータ。機能モジュールに必要な構成パラメータに対応します

#ops_receipt_properties：イベントの回収統計に使用します。戦略の効果を自動集計する（未対応）場合は、回収イベントにこのプロパティを含める必要があります

#custom_params：クライアントの構成チャンネルに設定したカスタムパラメータ。クライアントに渡す必要があるユーザープロパティ情報を定義できます。

4.2 ローカルのデフォルト値の設定​

TDRemoteConfig SDKで構成項目のデフォルト値を設定できます。AEサーバーで構成項目が追加されていない場合や、ローカルでリモートの値を取得できなかった場合に、SDKはローカルのデフォルト値を取得します。

形式​

ローカルのデフォルト値の構造は、次の形式にする必要があります：

{
    "configId": {
        "templateId": [
            { 
              "paramater_x" : ""
            }
        ]
    }
}

直接設定​

UTDRemoteConfig::SetDefaultValues("{\"key1\":\"value1\"}");

デフォルト値のクリア​

UTDRemoteConfig::ClearDefaultValues();

4.3 値の取得方法​

構成項目の下で、リリース済みで配信中の特定タイプの戦略内容を取得します：

FString str = UTDRemoteConfig::GetAllData(TEXT("configId_xxx"),TEXT("template_xxx"));

補足：

configId：エンゲージ管理画面の構成センターモジュールで作成した「構成項目ID」。業務モジュールの情報を識別するために使用します。構成項目の詳細は構成項目管理を参照してください

templateId：業務側で「構成項目」の下に追加した「テンプレートID」。具体的な機能モジュールの情報を識別するために使用します。構成テンプレートの詳細は構成テンプレート管理を参照してください

取得ルール​

あるkeyの値を取得する手順：

  • そのkeyに対応するリモート構成の値を優先して取得します
  • リモートでそのkeyが構成されていない場合は、そのkeyのローカルのデフォルト値を探します
  • ローカルのデフォルト値にもそのkeyがない場合は、空を返します。

5. テスト送信​

接続の利用可否と構成戦略の有効性をすばやく検証できるよう、SDKはテストモードの有効化に対応しています。

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

操作ドキュメント構成テンプレート管理の、クライアントのテスト送信の部分を参照してください。

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

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