Quickstart — your first install in 10 minutes

Drop the SDK into a Unity project, paste three keys from your admin panel, ship a build, see your first app_install event land. That's the whole flow.

Before you begin

• A Reflect account — invite-only during beta. Email [email protected] if you don’t have one yet.
• Unity 2021.3 LTS or newer.
• An Android (API 21+) or iOS (12+) build target.

Step 1 — install the SDK

In Unity, open Window → Package Manager, click +, choose Add package from git URL…, and paste:

https://github.com/retroage/reflect-sdk.git#v2.1.0

Unity downloads, compiles, and adds the package. See Installation for Asset Store and manual options.

Step 2 — grab your keys

Sign into the admin panel:

1. Go to Settings → copy your CompanyKey (looks like co_live_…).
2. Go to Apps → either pick an existing app or create a new one.
3. Open the app → copy its AppKey (app_live_…) and SigningSecret.

Step 3 — initialize in your first scene

In your first scene’s Awake():

using Reflect;
using UnityEngine;

public class ReflectBootstrap : MonoBehaviour
{
    void Awake()
    {
        DontDestroyOnLoad(gameObject);

        ReflectSDK.Initialize(new ReflectConfig {
            BaseUrl       = "https://api.reflect.cloud",
            CompanyKey    = "co_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
            #if UNITY_IOS
            AppKey        = "app_live_<ios-key>",
            SigningSecret = "<ios-signing-secret>",
            #else                                      // Android, Editor, etc.
            AppKey        = "app_live_<android-key>",
            SigningSecret = "<android-signing-secret>",
            #endif
            EnableLogging = Debug.isDebugBuild,
        });

        // Tag the install with anything you want segmented in reports.
        ReflectSDK.SetGlobalProperty("user_tier", "free");
    }
}

Step 4 — ship a build, watch it arrive

The SDK fires app_install automatically on the first launch of the app on a device. You don’t need to call anything.

Open the admin panel’s Dashboard — you’ll see install count tick within a minute.

Step 5 — track your first custom event

Anywhere in your game:

// One-shot event
ReflectSDK.TrackEvent("level_started", new Dictionary<string, object> {
    { "level", 1 },
});

// Or use a typed standard helper — same wire format, less typing
ReflectStandardEvents.LevelStarted(1);

// Revenue
ReflectSDK.TrackPurchase(
    productId:    "sku_pro_pack",
    price:        9.99,
    currencyCode: "USD",
    transactionId: "txn_abc123"
);

Where to next

• Configuration — every ReflectConfig field.
• Admin panel walkthrough — set up partners, tracking links, postbacks.
• Debug overlay — inspect what the SDK is sending without leaving Unity.