Social Events
Overview
Tracking Social Systems aims to help understand how players engage with Social content, such as creating/joining/leaving Teams/Guilds and sending/receiving invites and gifts.
Available Events
social
: this is a catch-all type of event for players’ actions/engagement with social features that are not captured by the other events belowsocial_connect
: use this event when the user connects to a social networkinvite_sent
: when an invite is sentinvite_received
: when the invite sent is receivedgift_sent
: when a player sends a giftgift_received
: when a player receives a gift
Critical Parameters
- Required
social
:social_type
: describes the social action the player takes
social_connect
:connect_user_id
: the userID provided when connected to a social network
invite_received
:sender_id
: the ID of the sender of the invite
gift_sent
:gift
: the reward object that contains the name, type, and amount of the gift contentrecipient_id
: The ID of the user who received the gift
gift_received
gift
: the reward object that contains the name, type, and amount of the gift contentrecipient_id
: The ID of the user who sent the gift
- Optional
invite_received
,invite_sent
:invite_type
: if there are multiple types of invites that players can send, such as “Download Game,” “Join My Guild,” etc., use this parameter to specify the type of invite sent
social
,social_connect
:reward
: if the player receives any rewards for performing any social action or connecting their social media account, thereward
object can be used to track the details of the reward received
Example
- Match 3D
- The game has robust social features. Players can connect their social media/platform account to the game to keep progress across devices, create/join/search for/leave teams and interact and compete with their teams
![](/docs/2_Features/Analytics/Planning/SocialEvents/IMG_4593.png)
![](/docs/2_Features/Analytics/Planning/SocialEvents/IMG_4594.png)
![](/docs/2_Features/Analytics/Planning/SocialEvents/IMG_4595.png)
- Example of Event trigger timing and the usage of critical parameters
social
: when the player clicks the Join button to join a teamsocial_type
= “join_team”
social
: when the player fills out Team info and hits the Create button to create a new teamsocial_type
= “create_team”
social
: when the player types in name in the search box and hits the Search buttonsocial_type
= “team_search”
Implementation
- Note that the Social event flow chart below was taken from Match 3D. Not all social features have the exact same flow, but the concept should be similar enough
Event Validation
- If you do not have access to Looker, please use the LionAnalytics QA Tool following the instructions here: LionAnalytics QA Tool
- If you have access to Looker, for each relevant event, check the following:
Dashboard & Analysis
Analyses
- General Social feature engagement performance
- Team/Guild health - whether Teams have active members who facilitate frequent interaction with team members
- Correlation between Social features and mid to long-term retention
Metrics
N/A
Explore
N/A
Dashboards
N/A