What does the SDK do for me?

The Godot and Unity SDKs send game_open, session_start, session_end, app_unclean_exit and error without any code. A session ends after 30 minutes without focus or events, and it is at most 24 hours old. Your code sends the game events, such as level_complete, and identify after a login.

The Unity SDK is plain C# with no native code. It works on Windows, macOS, Linux, Android, iOS and WebGL, and it needs Unity 2021.3 or later. It sends no device ID, no hardware details and no IP address. For another engine, send the same events over HTTP to POST /v0/events.

Sources: Manalens Godot SDK, Unity SDK, game events and app events documentation.

What does an example look like?

Example numbers: with the default settings, the Godot and Unity SDKs send every 10 seconds or when 20 events wait. A player who makes 45 events in one minute causes about 2 sends of 20 events, and the last 5 go out on the next timer, on focus loss or on quit.

Sources: worked example; Manalens Godot SDK and Unity SDK documentation.

Why does the SDK matter for indie PC and web games?

An SDK saves you from writing session logic, retries and a disk queue yourself. Check that it supports your engine and your platforms before you choose a tool.

An SDK that stores an ID and sends it also has a privacy side. The EDPB says software that sends stored information to an API endpoint is gaining access under Article 5(3) of the ePrivacy Directive. The Godot and Unity SDKs have a consent mode that records nothing before consent.

Sources: EDPB Guidelines 2/2023; Manalens Godot SDK and Unity SDK documentation.

Frequently asked questions

Which engines does Manalens have an SDK for?

Godot and Unity, plus a web SDK and a Node.js SDK. The Unity SDK needs Unity 2021.3 or later. A game in another engine can send the same events over HTTP to POST /v0/events with the publishable key and an app context.

Does the SDK send a device ID?

No. The Unity SDK sends no device ID, no hardware details and no IP address. Each event carries a random anonymous ID, a session ID, the user ID after identify, and the app context: platform, storefront, version, build and engine.

Can I use Manalens without an SDK?

Yes. A game in any engine can send the same events over HTTP to POST /v0/events with the publishable key and an app context. You then write the session logic, the retries and the disk queue yourself. The Godot and Unity SDKs do this work for you and send events every 10 seconds or at 20 events.

Sources and implementation