TikTok for Developers

Docs

Mini Game Analytics

This guide provides a centralized reference for your mini game's performance analytics, designed to help you track and interpret key metrics. It details the specific data modules across monetization, promotion, and operations to help you understand user behavior and revenue performance. All analytics modules can be found on your app page in the Developer Portal.

Available analytics modules

The developer platform offers analytics for the following modules found on your app page:

Category

Module

Navigation path

Overview

Daily metrics

Overview page

Monetization


In-App Purchases (IAPs)

Monetization page > In-App Purchase tab

In-App Ads (IAAs)

Monetization page > In-App Ads tab > Analytics toggle

Promotion


For You feed ads

For You Feed ads page > Analytics tab

For You feed cards

For You Feed cards page

Operations


Users

Analytics page > Users toggle

Performance

Analytics page > Performance toggle

Note: For all analytics modules, data is refreshed every day.

Overview analytics

The Overview page of your app provides a dashboard of your mini game's main daily metrics.

You can further refine your results by setting the Date Range and Region filters.

Metric

Description

Total users

Total number of users that launched a game session

Active users

Number of users who launched a game session at least once (including new users)

New users

Number of users who launched a game session for the first time

Average duration per user

Average time that a user spent in the game

For more detailed analytics, click the Go to Analytics button. This will navigate you to the overall analytics page for your app.

Monetization analytics

Data for in-app purchases (IAPs) and in-app ads (IAAs) are available on your app's Monetization page. IAP analytics allow you to track both users and orders, while IAA analytics display metrics for overall ad performance.

Note: For monetization analytics, data is deduplicated, meaning that redundant or duplicate data has been removed.

In-App Purchases

To find IAP analytics on your app page:

  1. Navigate to the Monetization page from the sidebar.
  2. Click the In-App Purchases (IAPs) tab.

Choose what type of data you want to view by switching the toggle between Users and Orders. For both types of data, you can refine your results by setting the filters:

  • Date range
  • Operating system
  • Region

User analytics

User analytics provides data on users who have made purchases in your mini game.

Click on any one of the metrics to view it in line graph form. You can also download the data by clicking the Download button in the corner of the graph.

Metric

Description

Paying users

Number of deduplicated users who have completed at least one in-app purchase

Percentage of paying users

The proportion of users who have completed at least one in-app purchase

Repeat paying users

Number of deduplicated users who have completed more than one in-app purchase

Percentage of repeat paying users

The proportion of users who have completed more than one in-app purchase

ARPPU

Average revenue per paying user, in Beans

Lifetime value

Average sales value generated by new users in the specified date range

Order analytics

You can also analyze aggregate data for transactions.

Click on any one of the metrics to view it in graph form.

  • GMV and Average GMV are viewable as a line chart or a pie chart.
  • Total orders lets you view the top 10 most ordered products.

You can download the data by clicking the Download button in the corner of the graph.

Metric

Description

GMV

Gross Merchandise Value (GMV) is the total sales value of the orders

Average GMV

Average sales value per transaction

Total orders

The total number of orders within the given date range

In-App Ads

To find IAP analytics on your app page:

  1. Navigate to the Monetization page from the sidebar.
  2. Click the In-App Ads (IAAs) tab.
  3. Click the Analytics toggle.

Refine your results by setting the filters:

  • Date range
  • Ad placements (individual ad placements, all ad placements, rewarded ads, or interstitial ads)
  • Region

Click on any one of the metrics to view it in graph form. You can download the data by clicking the Download button in the corner of the graph.

Metric

Description

Ads request

Number of times your ad placement requested ads to be displayed

Ad impressions

Number of times an ad is displayed

Ads click

Number of times an ad has been clicked

Ads click rate

Percentage of users who clicked on an ad to the total number of users who viewed it

eCPM

eCPM (effective Cost Per Mille) is the revenue earned per 1,000 ad impressions

Ads revenue

Revenue generated from ads displayed, after platform fee deduction

Promotion analytics

Data for promotional tools like For You feed ads and For You feed cards is also available.

For You feed ads

For You feed ads can be configured through TikTok Ads Manager (TTAM), which is separate from the Developer Portal. TikTok for Developers reports data by calendar day only. Since TikTok Ads Manager data reporting supports multiple time windows, select calendar day in TTAM to ensure consistent results.

To find For You feed ad analytics on your app page:

  1. Navigate to the For You feed ads page from the sidebar, under Promotion.
  2. Click the Analytics tab.

Switch the toggle to reflect the type of data you want to see:

  • Overview: Overview of ads spend, activated users, and paid traffic revenue.
  • First-day activation: Data for users activated on the same day after clicking a paid ad.
  • History activation: Data for users who launched the game for the first time in 30 days after watching an ad before reporting day and are still active on reporting day.

Refine your results by setting the filters:

  • Date range
  • Operating system
  • Region

Click on any one of the metrics to view it in graph form. You can download the data by clicking the Download button in the corner of the graph.

Overview

Metric

Description

Ads spend

Total amount spent on ads

Activated users

Number of users activated after clicking paid ads

Paid traffic revenue

Total in-app ads and in-app purchases revenue generated by paid ads (before platform commission deduction). In-app purchase revenue is converted from Beans to USD.

First-day activation

Metric

Description

First day activated users

Number of users activated on the same day after clicking a paid ad

User activation cost

Total amount spent to achieve currently activated users

Paid traffic revenue

Total in-app ads and in-app purchases revenue generated by paid ads (before platform commission deduction). In-app purchase revenue is converted from Beans to USD.

ROI

Total value generated from paid ads to the total ads spend

Lifetime value

Average value per activated user till date. In-app purchase revenue is converted from Beans to USD

ARPU

Average in-app ads and in-app purchases revenue generated by clicking paid ads. In-app purchase revenue is converted from Beans to USD.

eCPM

eCPM (effective Cost Per Mille) is the revenue earned per 1,000 paid ads

History activation

History activation has an additional filter that lets you include or exclude first-day activated users.

Metric

Description

History activated users

Users who launched the game for the first time in 30 days after watching an ad before reporting day and are still active on reporting day. Reporting day is the date when the data was last refreshed.

Paid traffic revenue

Total in-app ads and in-app purchases revenue generated by paid ads (before platform commission deduction). In-app purchase revenue is converted from Beans to USD.

eCPM

eCPM (effective Cost Per Mille) is the revenue earned per 1,000 paid ads

For You feed cards

To find For You feed card analytics on your app page, navigate to the For You feed cards page from the side bar, under Promotion.

Refine your results by setting the filters:

  • Date range
  • Region

View data for the following:

Metric

Description

Click-through rate

Percentage of users who click on the For You feed card

Impressions

Number of times the For You feed card is displayed

Clicks

Total number of clicks on the For You feed card

Operation analytics

Operational analytics for your mini game contains data on both users and app performance.

To find operational analytics on your app page, click the Analytics tab on the sidebar. Then make sure the toggle is set to your desired data type: Users or Performance.

User analytics

User analytics contains the following categories:

  • Behavior
  • Retention
  • Profile
  • Device
  • Source

Each category allows you to refine your results by setting the filters:

  • Date range
  • Operating system
  • Region
  • User type (Retention, Profile, and Device only. Selectable options depend on the category.)

Behavior

Metric

Description

Total users

Total number of users that launched a game session

New users

Number of users who launched a game session for the first time

Active users

Number of users who launched a game session at least once (including new users)

Repeat users

Number of users who launched a game session more than once

Launched sessions

Total number of game sessions launched

Average launched sessions

Average number of game sessions launched per user

Average duration per user

Average time that a user spent in the game

Average duration per session

Average length of a game session

Retention

Retention is the number of users who remain active for however many days since their first game launch. Select the retention period you want to display data for:

  • 1-day
  • 7-day
  • 14-day
  • 30-day

Profile

Profile analytics contain data for the following:

  • Gender
  • Region

Device

Device analytics contain data for the following:

  • Brand
  • Model
  • TikTok app version

Source

Analytics regarding where users enter the game.

  • New users
  • Launch sessions
  • Average duration per session

Performance analytics

Track your app's launch speed and success rate in the performance analytics section.

Refine your results by setting the filters:

  • Date range
  • Operating system
  • Region

Displayable metrics are defined below.

Metric

Description

Launch success rate

Percentage of successful game sessions launched

Average first-time launch speed

Average launch time for a first-time game session


Average launch speed

Average launch time for a game session


Was this document helpful?
TikTok for Developers