Skip to main content

Social Dashboard (Coming Soon)

Track social engagement, friend networks, and virality metrics.

SDK ready, dashboard in development

The Social Analytics Dashboard is currently in development. The SDK already supports the events listed below -- implementing them now means your data will be ready when the dashboard launches.


Overview

The Social Dashboard will provide insights into your game's social features:

  • Social DAU -- Players actively using social features
  • Friend Network Size -- Average connections per player
  • Virality Coefficient -- Invites per user and acceptance rate
  • Chat Activity -- Message volume and channel usage
  • Voice Engagement -- Call duration and frequency

Supported Events

The SDK already includes typed event tracking for social interactions. Integrating these now ensures historical data is available when the dashboard launches.

EventSDK MethodPriority
friend_inviteTrackFriendInvite()Recommended
group_joinTrackGroupJoin()Recommended
chat_messageTrackChatMessage()Optional
voice_call_startTrackVoiceCallStart()Optional
voice_call_stopTrackVoiceCallStop()Optional

Event Implementation

Friend Invite Event

using GameRebellionSdk.Unity;

GameRebellion.TrackFriendInvite(new GrFriendInviteEvent
{
InviteMethod = "share_link",
InviteCount = 1
});

GameRebellion.TrackFriendInvite(new GrFriendInviteEvent
{
InviteMethod = "in_game",
InviteCount = 3
});

GrFriendInviteEvent Fields

FieldTypeRequiredDescription
InviteMethodstringNoHow the invite was sent (e.g., "share_link", "sms", "in_game").
InviteCountdouble?NoNumber of invites sent in this action.

Group Join Event

GameRebellion.TrackGroupJoin(new GrGroupJoinEvent
{
GroupId = "guild_456",
GroupName = "Dragon Riders",
GroupType = "guild",
GroupSize = 25,
JoinMethod = "search"
});

GrGroupJoinEvent Fields

FieldTypeRequiredDescription
GroupIdstringNoUnique group identifier.
GroupNamestringNoDisplay name of the group.
GroupSizedouble?NoCurrent member count.
GroupTypestringNoGroup category (e.g., "guild", "clan", "party").
JoinMethodstringNoHow the player joined (e.g., "invite", "search", "auto_match").

Chat Message Event

Track chat activity volume without sending message content.

GameRebellion.TrackChatMessage(new GrChatMessageEvent
{
ChatType = "guild",
MessageLength = 45,
MessageType = "text",
LanguageDetected = "en"
});

GrChatMessageEvent Fields

FieldTypeRequiredDescription
ChatTypestringNoChannel type (e.g., "global", "guild", "private", "party").
MessageLengthdouble?NoCharacter count (for aggregate analysis).
MessageTypestringNoContent type (e.g., "text", "emoji", "image").
LanguageDetectedstringNoISO 639-1 language code.
Privacy

Never send actual message content. Track only metadata (type, length, channel) for aggregate analytics.

Voice Call Events

// Voice call started
GameRebellion.TrackVoiceCallStart(new GrVoiceCallStartEvent
{
Type = "group",
CallId = "call_789",
ParticipantCount = 4
});

// Voice call ended
GameRebellion.TrackVoiceCallStop(new GrVoiceCallStopEvent
{
CallId = "call_789",
StopReason = "user_left"
});

Best Practices

  • Never send message content. Only track metadata (channel type, message length) for privacy compliance.
  • Use consistent group types. Standardize on a set of types ("guild", "clan", "party", "team") for clean analytics.
  • Track invite methods. Knowing how players invite friends ("share_link" vs. "in_game") helps optimize viral loops.

Implementation Checklist

  • TrackFriendInvite() called for all invite methods
  • TrackGroupJoin() called for guild/clan/party joins
  • TrackChatMessage() called for chat activity (metadata only)
  • TrackVoiceCallStart() / TrackVoiceCallStop() called for voice sessions