MultiConnectMultiConnectDocs Website home
MultiConnectCloud › MultiConnectCloud

9. SDK apps and analytics

An SDK app is one game. It has one SDK key, which you paste into MultiConnectSDK. That key is all the SDK needs: it turns on analytics and, if you host on MultiConnectCloud, lets your game clients find your servers.

The SDK key is public by design: it ships inside your game. It can only find your servers and send analytics. It cannot deploy, spend credits or read your account.

For setting up MultiConnectSDK in your game, see the Developer Guide. An SDK app also gives your game player accounts, remote config, leaderboards, cloud save, an economy, daily rewards, an inbox, store products, error reports and push notifications: the SDK Apps Guide covers each of them.

Create an SDK app

  1. Open SDK Apps and choose Create SDK app.
  2. Choose a Project, or + Create a new project to make one with the app.
  3. Enter an App name of 2 to 40 characters, usually your game's name.
  4. Under Hosting, choose a Server deployment from the project, or Custom hosting (my own servers).
  5. Choose Create.
Hosting choice What it means
A Server deployment Clients with Use Custom Hosting off are sent to this deployment's servers
Custom hosting (my own servers) You run your own servers. The key turns on analytics only. You can link a Server deployment later

An account can have at most 20 SDK apps. A Server deployment can be linked to one app only, and it must be in the app's project.

The app list shows each app's Players online, Active today, how it is hosted, and when it last reported. The copy icon copies its SDK key.

What the analytics show

Open an app, then the Analytics card, to see its tabs. Most tabs have a Time range picker.

Tab What it shows
Overview Players online or peak players, and matches started
Players Daily active and new users, retention, sessions, average session length, platforms, app versions and countries
Matchmaking Matches, time to a room, find-room requests, average wait and peak rooms
Servers Every server process that reported in the last hour: role, region, connections, rooms, versions, uptime and status
Events The custom events your game sends with McAnalytics.Track, with a breakdown by property

Setup, below the feature cards on the app page, holds the SDK key, settings, status, code to add to your game, and deleting the app.

Data appears within about a minute of players starting to play. Country data comes from the network, never from the player's device.

Settings

Under Setup, in Settings:

Setting What it does
App name The name shown on this page
Hosting Link or unlink a Server deployment
Collect analytics Off: running games keep working, and stop sending on their next report
Player sessions Daily and monthly users, retention, session length, platform, version and country
Custom events Events your game sends with McAnalytics.Track

Choose Save after a change.

Regenerate the SDK key

The key is compiled into every build of your game, so a new key reaches players only with a new build.

  1. Under Setup, choose Regenerate on the SDK key panel.
  2. Choose how long the old key keeps working: 1, 7, 14 or 30 days, or Stop the old key now (it is being abused).
  3. Choose Regenerate, and ship builds with the new key before the old one stops.

Delete an app

Under Setup, choose Delete app and type the app's name. The key stops working at once: builds carrying it stop reporting, and hosted clients can no longer find their server through it. The app's analytics and its players, scores, saves and wallets are removed. This cannot be undone.