Helika Unreal Engine (UE) SDK

Helika UE SDK Docs

The Helika Unreal SDK mirrors the functionalities of the Web and Unity SDK, catering specifically to UE developers. This integration facilitates the seamless inclusion of Helika services into your games. By incorporating the Helika UE SDK, you gain effortless access to the complete range of Helika capabilities, empowering you to construct robust and scalable solutions with ease.

Features

  • Streamline integration with Helika services

📘

Current Version: 0.1.1

Installation

You can download the latest version of the Helika Plugin from our github repository.

Add the Plugin to your project directory and enable it from the plugins menu inside the editor. Please follow the quick start guide below as an additional reference.

Quick Start

Pre-requisites

  1. Helika API Key
    1. You’ll need a Helika API Key in order to instantiate the plugin.
    2. Please reach out to your Client Success Manager in order to receive an API key for your organization.
  2. Event Taxonomy
    1. We strongly recommend following our suggested Event Taxonomy for game event handling and structure. This is due to how we ingest and store data from your game, in order to make it accessible through our Game Management Platform. By following a standardized format, you will be able to access dashboards and other insights faster within the Helika Portal.
    2. Please contact your account representative to get support on Event Taxonomy.

Initial Setup

  1. Step 1: Download the sources.zip file

    1. Navigate to the Helika UE SDK repo and download the sources.zip file

    2. Unzip and rename the folder to Helika from helika-ue-sdk-v.X.X.X.

  2. Step 2: Add the Plugin to Your Project

    1. Open your Unreal Engine project in the Unreal Editor. An example project can be found here.
    2. Navigate to the Plugins directory within your project’s folder.
    3. Copy/Move the Helikafolder into the Plugins directory of your project.
  3. Step 3: Enable the Plugin in Unreal Editor

    1. Launch the Unreal Editor for your project.
    2. Go to the Edit menu and select Plugins.
    3. In the Plugins window, navigate to the Installed section and locate the Helika plugin you installed.
    4. Enable the plugin by checking the checkbox next to its name.
    5. Click the Restart Now button to apply the changes and restart the Unreal Editor.
    6. The plugin is now installed and enabled in your Unreal Engine project.

Sending Events

  1. Step 1: Add the BP_HelikaActor blueprint

    1. After installing the plugin, Add BP_HelikaActor to your level From All->Plugins->Helika Content.

  2. Step 2: In the Details menu, add in the required config values.

    1. Now select BP_HelikaActor in your level and add in the required config values.

      1. Api Key

        1. Provided by your account rep. Please contact Client Success Manager if you do not yet have an API key for your organization.
      2. Game Id

        1. Identifier for the specific game the events should associate to.
        2. Used to differentiate events between multiple IPs in your portfolio.
      3. Player Id

        1. Unique identifier for a given player.
          1. You can also programmatically set the Player ID at any time. It is simply appended to all sent events.
      4. Helika Env

        1. either Localhost, Develop, or Production

  3. Step 3: Get Reference to BP_HelikaActor and send events

    1. Reference BP_HelikaActor from your Level
    2. Call the Send Event Function using the suggested Event Taxonomy format.

API Reference

Game Event Taxonomy

Automatic Data Capture

The Helika SDK automatically appends selected data fields in the event along side your customized data event.

FieldTypeRequired/OptionalDescription
game_idstringrequiredThe Game ID that we will use to identify your game's events (if set in the event itself, that overrides the default game_id set on initialization
created_atDateTimerequiredThe timestamp when the event was created.
session_idu4requiredThe sdk generates a new Session ID when the Helika Object is created.
player_idstringoptionalYou can set the "player_id" to identify all events generated after will be associated with this specific player.

Demo Project

A demo project has been created to demonstrate how the Helika UE SDK functions. Please use the following repo as a reference:

Helika UE SDK Demo Project

Validation

It is recommended that you verify events are being ingested correctly by sending some test events via the SDK. Successfully sent events should have a 200 status response.

Check within your portal for the events to appear in the Data Ingestion Summary.

The Data Ingestion Summary report can be found in the side menu:

  • Data Summary > Data Ingestion Summary

The Data Ingestion Summary will display information such as:

  • Which environment the events are being sent to
  • Total Event Volumes
  • Types, and Sub Types Seen
  • A table for the raw event stream, with raw payload.

🚧

Ingestion Delays

Please expect up to the following delays during event processing, before results are populated:

  • Production: 15 minutes
  • Development: 2 hours

After seeing some test events appear, this report can be used to monitor your ongoing events and event volumes, as they are added.