You can start sending the data from your Unreal Engine app to Treasure Data, using our Unreal Engine SDK. Visit the following repository for more information.



This topic includes:

Requirements

Getting Started

The following document assumes that the current Unreal Engine has been compiled from sources or it has all dependencies so third-party plugins can be built.

Download and Place the Plugin

Get a copy of the plugin from the main GIT repository:

$ git clone http://github.com/treasure-data/td-ue4-sdk

Copy the new td-ue4-sdk to your Engine plugins folder, the target path as follows:

UnrealEngine/Engine/Plugins/td-ue4-sdk

Alternatively, you can copy the plugin content inside your Project Plugin directory, not that this approach don't work on Linux Development environment.

Build the Plugin

To build the plugin is required to generate the build-rules, for the purpose the UE4 Engine provides a script called GenerateProjectFiles:

Depending on the system (Unix bases or Window), run the proper script from the command line:

When the command finishes, type the make command:

$ make

After a few seconds, the plugin binary is available.

Speed Up Plugin Build Phase

In some cases is required to re-build only the plugin, using a normal make command can take some minutes as it does some parsing running some scripts to fix dependencies, to speed up the process the following options can be added:

$ make UE4Editor ARGS=-canskiplink

Enable the Analytics Plugins for Your Project

Inside the Unreal Engine 4 Editor, open your project and the plugins window:

Now enable the two required plugins:


Configure Project Settings

From your project directory, open and edit the file Config/DefaultEngine.ini and append the following content at the bottom:

[Analytics]
ProviderModuleName=TreasureData
TDApiKey=TD-WRITE-ONLY-KEY
TDDatabase=DATABASE_NAME
SendInterval=10

[AnalyticsDevelopment]
ProviderModuleName=TreasureData
TDApiKey=TD-WRITE-ONLY-KEY
TDDatabase=DATABASE_NAME
SendInterval=10

[AnalyticsTest]
ProviderModuleName=TreasureData
TDApiKey=TD-WRITE-ONLY-KEY
TDDatabase=DATABASE_NAME
SendInterval=10

Save the file and restart Unreal Engine Editor.

Gather Metrics Through Blueprints

In the Editor, select the Blueprints drop-down menu and select the Open Level Blueprint option:


Now in the Event graphs, different events can be connected to Analytics functions, as an example, the following image demonstrates how to track the Session Start, Session End, and Record Event w/Attributes events:

After a Game starts, the plugin will send the events to Treasure Data.

Treasure Data

To query the game events, go to the TD Console, select Databases, and open the database used in the game (Config/DefaultEngine.ini > TDDatabase):


By default two tables are created:

To query records select a table name and select the Query button. By default you can issue a SQL query as in the following example:

SELECT * from events;