Skip to main content
Version: 29.1.35

Using a Mobile Measurement Partner with Skillz

Mobile Measurement Partners (MMPs) are third-party platforms that allow mobile game developers to track and measure the performance of their advertising campaigns across different advertising channels, such as social media, search, and display networks. MMPs are an essential component of advertising for mobile games. They provide tracking and measurement of advertising campaigns, which helps game developers optimize their campaigns and achieve better results. By tracking user behavior and engagement, MMPs are able to provide valuable insights into how users interact with ads, how they convert, and how they engage with the game after installing it. Skillz utilizes Singular as its MMP, however, game developers are free to choose other MMP providers such as Branch, AppsFlyer, Kochava, and Adjust.

Benefits of using MMP​

Campaign Effectiveness: Advertising for mobile games will inevitably lead to the utilization of a variety of advertising networks such as AppLovin and AdMob in order to drive installs and increase the players engaging with the game. Utilizing an MMP allows a game developer to track campaigns across multiple advertising networks and advertising channels, such as social media, search, and display networks in order to better understand the value of those installs. They provide a comprehensive view of the user's journey from seeing or clicking on the ad to installing the game to additional metrics potentially relevant in modeling predictive Lifetime Value (LTV) (e.g. the number of games played or tutorial completed). This helps mobile developers to understand which channels and networks are most effective in driving installs and user engagement, allowing them to adjust advertising spend to maximize user engagement and achieve better results.

Detecting Fraud: When paying per install, as most mobile advertising is done, detecting fraudulent activity across advertising campaigns is essential. MMPs offer significant protection from fraud utilizing their own advanced algorithms and machine learning technologies for detecting and eliminating different suspicious behavior. As a result, developers are able to protect their advertising budgets and achieve a higher return on investment by allowing them to better allocate spend.

While Skillz is not endorsing nor requiring the use of an MMP, using an MMP in advertising for mobile games can allow developers to better optimize advertising campaigns, provide valuable insights into user behavior, and protect advertising budgets from fraud. 

Implement MMP with Skillz​

Once an MMP has been selected, it is important to understand how to get the most relevant data, primarily revenue, from Skillz to that MMP. For a Skillz developer, revenue is directly associated with the match entry fees in a given game. This information is available in the MatchInfo Object received client side at the start of every match. Tracking entry fees spent by a user allows game developers to better understand the revenue of that user and overall, the game. Relevant details within the MatchInfo object should be sent to the MMP in order to allow the MMP to provide further insights into a user after install. 

An MMP will primarily be used to track the attribution on installs; however being able to understand further insights into those users becomes just as important as tracking the install, if not even more so. Gaining insight into the game’s players allows developers to better understand the engagement and revenue potential from those users and better determine which install sources drive the highest quality traffic. Because of this, developers will want to be sure to send revenue to an MMP (example shown below), to help calculate LTV, as well as other potential bottom of the funnel events such as ‘Tutorial Completed’ or ‘Match Played’. Please refer to the preferred MMP provider to learn how best to send this data to the MMP. 

Skillz’ MatchInfo Object​

Match​

PropertyData TypeDescription
BracketRoundint?Indicates the round of the bracket tournament if IsBracket is true
CustomServerConnectionInfoCustomServerConnectionInfoThe connection info to a custom server that coordinates a real-time match
DescriptionstringThe description of this tournament type
EntryCashfloat?If this tournament is being played for real cash, this is the amount of cash required to enter
EntryPointsint?If this tournament is being played for Z, this is the amount of Z required to enter.
GameParamsDictionary<string, string>The custom parameters for this tournament type specified in the developer portal
IDulong?The unique ID for the match
IsBracketboolIndicates the match is a bracketed tournament
IsCashbool?Indicates the match is for real prizes or for Z
IsCustomSynchronousMatchboolIndicates if the match is a sync match
IsSynchronousboolDeprecated. Indicates if this match is Sync. Note: please use the IsCustomSynchronousMatch property
IsTieBreakerboolIndicates whether the match is a tie-breaker
IsVideoAdEntrybool?Indicates the match entry was through a video ad
NamestringName of the match
PlayersList<Player>List of players in the match
SkillzDifficultyuint?The difficulty of the game (used with automatic difficulty). Note: only set in production.
TemplateIDint?The unique ID for the tournament template this match is based on

From the MatchInfo Object, there are a few values that are most important to keep track of before sending the match revenue information to the preferred MMP.

  1. IsCash - boolean - Indicates whether it is a Pro (true) or Z (false) match

  2. EntryCash - float - For Pro tournaments, EntryCash will contain the entry fee required to join the match

  3. IsBracket - boolean - Indicates the match is a bracketed tournament

  4. BracketRound - int - Indicates the round of the bracket tournament if IsBracket is true

  5. IsTieBreaker - bool - Indicates if the match is a tiebreaker

Sending EntryCash​

EntryCash is equivalent to the entry fees used to calculate the developer revenue share. This value is important to send to an MMP, however a few checks should be performed before sending to ensure there is no over or under reporting.

  1. Check ‘IsCash’ == true. This will ensure that only values associated with Pro matches are calculated.

  2. Next is a two part check designed to check for head-to-head/events or bracketed tournament cases. The overall check should be: if a or b.

    1. Check ‘IsBracket’ == false  AND that ‘IsTieBreaker’ == false – handles head to head and event matches
    2. Check ‘IsBracket’ == true AND ‘BracketRound’ == 1 – handles bracketed tournaments

  3. If the match clears those two checks, then ‘EntryCash’ can be sent to the preferred MMP.

SkillzGameController.cs
public void OnMatchWillBegin(Match matchInfo){
    //check for a cash game
    if (matchInfo.IsCash && !matchInfo.IsTieBreaker){
        if (!matchInfo.IsBracket || (matchInfo.IsBracket && matchInfo.BracketRound == 1)){
            //Send EntryCash to MMP with the tournament name as the Revenue Event Name
        }
    }
}

When sending the EntryCash value to the preferred MMP there are two options for determining revenue: 

  1. Multiply ‘EntryCash’ by the developer revenue share and send that calculated value to the MMP or 

  2. Account for it later on the MMP or Ad Network end.

One other optional method to consider for SKAdNetwork tracking on iOS would be calculating the sum of all entry fees within the first 24-48 hours and sending that value to SKAdNetwork. 

Tracking revenue allows for a picture of lifetime value (LTV) to emerge. The goal is to grow LTV to surpass the cost per install (CPI). When this occurs, the user or cohort is profitable for the game, presenting an opportunity for expansion.

Singular​

As we utilize Singular, we will describe the types of Singular SDK calls that may be useful with a Skillz integration.There are two primary mechanisms for sending events that should be utilized: Event and CustomRevenue (Singular Documentation). 

Event Method​

The Event calls are focused on sending other information that generally does not have revenue information. This is the opportunity to send events such as ‘Tutorial Started’, or ‘Match Completed’. There is a lot of flexibility with these events, so developers should feel free to send any that make sense in the context of any predictive modeling that may be done.

Custom Revenue Method​

CustomRevenue events are a subset of revenue events that are able to be sent to Singular. This particular function provides added flexibility to allow game developers to include additional revenue details beyond just the entry fee. Additional details that may be worth tracking are the different tournaments (track by ‘Name’), tiebreakers (IsTieBreaker), and synchronous gameplay (IsSynchronous).

SkillzGameController.cs
public void OnMatchWillBegin(Match matchInfo){
    //check for a cash game
    if (matchInfo.IsCash && !matchInfo.IsTieBreaker){
        if (!matchInfo.IsBracket || (matchInfo.IsBracket && matchInfo.BracketRound == 1)){

            //Send EntryCash to MMP with the tournament name as the Revenue Event Name

            //NOTE::This is for Singular only - just an example
            SingularSDK.CustomRevenue(matchInfo.Name, "USD", matchInfo.EntryCash);
        }
    }
}

Once the revenue or event data is within the chosen MMP, in this case Singular, it should be accessible to utilize in reporting and other modeling such as SKAdNetwork.

Because this data is sent real time, there may occasionally be discrepancies related to match refunds, however, it should still be an accurate predictor of revenue.

SKAdNetwork (Applicable for iOS games)​

SKAdNetwork is Apple's attribution framework for mobile apps. It provides advertisers with a means to measure campaign effectiveness without violating user privacy. A model needs to be defined through an MMP to allow for proper tracking. The values in the SKAdNetwork model are sent directly to Apple from the iOS client and then sent back to ad networks from Apple directly rather than through the iOS client. Through this model, advertisers get some install data, but users' identities are kept anonymous, striking a balance between privacy and advertising efficiency. For more detailed information on SKAdNewtork, the MMPs have extensive documentation around the different versions and current status of SKAdNetwork.

Example SKAdNetwork V3 model option in Singular​