About this project

Aptabase is an open-source, privacy-first analytics platform. This Unreal Engine SDK allows developers to instrument their UE projects with Aptabase analytics for mobile, desktop, and web apps. Installation can be done through the Unreal Marketplace or by cloning the repository into the project's `Plugins` folder (requires a C++-based project). After enabling the plugin via the Editor's Edit → Plugins menu, add `ProviderModuleName=Aptabase` under `[Analytics]` in `Config/DefaultEngine.ini`. If another analytics provider is configured, it must be replaced or used alongside via the Multicast Analytics Provider Plugin. Project setup requires an App Key from the Aptabase dashboard, entered in Project Settings → Analytics → Aptabase. The host is auto-selected based on the key; self-hosted deployments allow a custom URL. Send intervals for events can be configured separately for Release and Debug modes. Event tracking is supported via Blueprints and C++. Blueprint users are encouraged to use the Blueprint Analytics Plugin for provider-agnostic tracking. Available nodes include `Record Event with Attributes` for custom events and `Record Currency Purchase` for purchase tracking. In C++, `FAnalytics` module methods like `RecordEvent` and `RecordCurrencyPurchase` are recommended. The SDK automatically enriches events with OS and app version information. It does not auto-track any events — developers must record them manually. Record calls run asynchronously in the background. Custom properties support only strings and numbers. For Apple App Store submissions, Aptabase provides guidance on filling out the App Privacy form.