Documentation

Everything you need to integrate AreaTech into your game. From first event to production dashboard in under 5 minutes.

Quick Start

AreaTech works by receiving events from your game client or server. Events are processed in real-time and appear on your dashboard within seconds. Here's the fastest path to your first integration:

1. Create your project

Sign up at app.areatech.tech and create a new project. You'll receive a PROJECT_ID and API_KEY that you'll use in the SDK.

2. Install the SDK

Choose your platform:

Unity (C#)

// Install via Unity Package Manager
// Add to Packages/manifest.json:
"com.areatech.sdk": "https://github.com/areatech/unity-sdk.git#v1.4.2"

// Or download from the Asset Store
// Search: "AreaTech Analytics"

Unreal Engine (C++)

// Add to your .Build.cs
PublicDependencyModuleNames.Add("AreaTechSDK");

// Or clone into Plugins/
git clone https://github.com/areatech/unreal-sdk.git Plugins/AreaTech

Roblox (Luau)

-- Install via Wally package manager
-- wally.toml:
[dependencies]
AreaTech = "areatech/analytics@1.2.0"

-- Or use HttpService directly:
local AreaTech = require(game.ReplicatedStorage.AreaTech)

REST API (Any platform)

curl -X POST https://ingest.areatech.tech/v1/events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "proj_abc123",
    "events": [{
      "name": "session_start",
      "player_id": "player_456",
      "timestamp": "2024-11-15T10:30:00Z",
      "properties": {
        "platform": "PC",
        "version": "1.2.0",
        "region": "us-east-1"
      }
    }]
  }'

3. Initialize the SDK

Unity Example:

using AreaTech;

public class GameManager : MonoBehaviour
{
    void Awake()
    {
        AreaTechSDK.Initialize(new Config
        {
            ProjectId = "proj_abc123",
            ApiKey = "ak_live_xxxxxxxxxxxxxxxx",
            Environment = "production",
            FlushInterval = 10, // seconds
            BatchSize = 25
        });
    }

    void OnPlayerJoin(Player player)
    {
        AreaTechSDK.Track("session_start", new Dictionary<string, object>
        {
            { "player_id", player.Id },
            { "display_name", player.Name },
            { "platform", Application.platform.ToString() },
            { "game_version", Application.version }
        });
    }

    void OnMatchComplete(Match match)
    {
        AreaTechSDK.Track("match_complete", new Dictionary<string, object>
        {
            { "match_id", match.Id },
            { "duration_seconds", match.Duration },
            { "winner_id", match.Winner.Id },
            { "player_count", match.Players.Count },
            { "map", match.MapName }
        });
    }
}

4. Verify events are arriving

Head to your project dashboard at app.areatech.tech. Within 5 seconds of sending your first event, you should see it appear in the Live Events stream.

Core Concepts

Events

Events are the foundation of AreaTech. Every player action — session starts, match completions, purchases, level-ups — is an event. Events have a name, a player ID, a timestamp, and a properties bag for custom data.

Players

Players are automatically created when you send their first event. You can enrich player profiles with traits (platform, country, spend tier) that power segmentation and cohort analysis.

Cohorts

Cohorts group players by shared characteristics or behaviors. Use them to compare retention curves across acquisition channels, measure the impact of balance changes, or identify at-risk segments.

Funnels

Track conversion through multi-step flows: onboarding, first match, first purchase. AreaTech auto-calculates drop-off at each step with statistical significance testing.

API Reference

Base URL

https://api.areatech.tech/v1

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer ak_live_xxxxxxxxxxxxxxxx

Rate Limits

The ingestion API supports up to 10,000 events per second per project on the Studio plan. Enterprise plans have custom limits. Batch requests can contain up to 500 events per call.

Endpoints

POST   /v1/events              — Ingest events (batch)
GET    /v1/players/:id         — Get player profile
GET    /v1/players/:id/events  — Get player event history
GET    /v1/cohorts             — List cohorts
POST   /v1/cohorts             — Create cohort
GET    /v1/metrics/dau         — Daily active users
GET    /v1/metrics/retention   — Retention curves
GET    /v1/metrics/revenue     — Revenue metrics
POST   /v1/queries             — Run custom analytics query

SDKs & Libraries

Official SDKs are available for:

• Unity — C# SDK with auto-batching, offline queuing, and automatic session tracking
• Unreal Engine — C++ plugin with Blueprint support and Subsystem integration
• Godot — GDScript autoload with signal-based event tracking
• Roblox — Luau module with DataStore fallback for offline resilience
• Node.js — Server-side SDK for backend event ingestion
• Python — Data science and automation SDK

Need Help?

Join our Discord community for real-time support, or email us at support@areatech.tech. Enterprise customers have access to dedicated Slack channels and priority engineering support.