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.
Using the 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 |
Important: Understand the following features of the data modules:
- When data is updated: Data is refreshed daily, showing data up to the previous day.
- Data threshold (US): Due to TikTok's data and privacy policies, data involving US users will only be displayed if at least 1,000 unique US users are met. Some data may be empty if the threshold is not met.
- Premise to see the data: Mini games must be officially launched online before data populates. If the mini game is unreleased, data will not be available.
On your app page, all analytics modules share the same core functions that allow you to filter, customize, and view data:
Data filtering
Filters at the top of the page can be set and generally include the following:
- Date range: Yesterday, Last week, Last month, or Custom (up to 90 days)
- Operating system: iOS, Android, or All
- Region: Filter by user region
- User type: Some pages (such as Retention, Profile, and Device) support filtering by new/old users and other dimensions
- Other filters: Some pages have exclusive filters. For example, network data can be filtered by domain, and ad performance can be filtered by ad placement.
Metric cards and charts
Analytics pages have a row of metric cards at the top and a trend chart below. Clicking on a different metric card will switch the chart below to display trends for the corresponding metric.
- The numbers on the metric card are aggregated values for the selected time range.
- The green/red percentage next to the number indicates the month-on-month change (compared to the previous period of the same length): green indicates an updwards trend, red indicates a downward trend.
Chart interaction and export
- Hover over the line/pie chart to display the detailed values for that point in time or category.
- Most charts support downloading as a CSV file in the upper right corner, if you want to perform secondary analysis yourself.
- Some error charts/tables provide a link to an error code list.
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.
User analytics
User data lets you understand the user size, activity, retention performance, and user composition of your mini game. This data can be used to judge the quality of user growth, whether users continue to use the game, and the performance differences between different client bases and entry sources.
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-days, 14-days, or 30-day
Profile
Profile analytics contain data for the following:
- Gender
- Region
Device
Device analytics contain data for the following:
- Brand: Such as iPhone, Google Pixel, Samsung Galaxy
- Model: Such as iPhone Pro Max, Pixel 8 Pro, Galaxy S23 Ultra
- TikTok app version
Source
Analytics regarding where users enter the game.
- New users
- Launch sessions
- Average duration per session
Performance analytics
Performance data allows you to track your mini game's launch performance. By using trend charts, you can observe performance changes on different dates, timely discover issues such as increased startup failure rate and slower loading speed, and further locate the reasons based on version release, resource loading, network environment, or device differences.
Launch
Metric | Descriptio |
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 |
Runtime
Reflects the smoothness of game runtime. Metrics charts are dual-axis: the left axis is the performance metric, and the right axis is superimposed with the Report count to determine whether the data has enough sample support.
Metric | Description |
FPS | The number of frames rendered by the game each second. Higher values indicate smoother performance. |
Stutter rate | Percentage of total session time affected by irregular frame delivery, including stutters and frame drops. |
Network
Measures the quality of in-game network requests and file downloads.
Metric | Description |
Average request latency | Average time taken for a tt.request() API call to complete, from the moment the request is sent to when the full response is received. |
Request error rate | Percentage of tt.request() API calls that fail, including HTTP errors (such as 4xx/5xx), timeouts, and network failures. |
Average file download latency | Average time taken for a tt.downloadFile() API call to complete, from the moment the request is initiated to when the file is fully downloaded. |
File download error rate | Percentage of tt.downloadFile() API calls that fail, including errors such as network issues, timeouts, or server-side failures. |
For latency metrics, trend comparisons by domain name are also provided. For error metrics:
- Error details table: Listed by domain name, error code, and number of occurrences, can be filtered and paged by domain name multiple selection.
- By domain/by error code error trend chart.
- You can also view a complete list of error codes to understand the meaning of each error code.
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:
- Navigate to the Monetization page from the sidebar.
- Click the In-App Purchases (IAPs) tab.
Choose what type of data you want to view by switching the toggle between Users and Orders.
User analytics
User analytics provides data on users who have made purchases in your mini game.
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.
- 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:
- Navigate to the Monetization page from the sidebar.
- Click the In-App Ads (IAAs) tab.
- Click the Analytics toggle.
Business insight
Measure ad exposure and revenue performance. You can filter by ad placement type or individual ad placements.
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 |
Performance
Measure the stability of in-game ads. Filter by ad placement.
Metric | Description |
Ad display failure rate | Percentage of attempts that fail to render or display an ad to the user. |
Ad load failure rate | Percentage of ad load requests that fail to return an ad. |
For ad display failures, there is also a failure breakdown table (by ad placement, error code, number of times) and a trend chart by error code, as well as a link to view the full list of error codes.
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:
- Navigate to the For You feed ads page from the sidebar, under Promotion.
- 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.
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 |
Frequently Asked Questions (FAQ)
Why is some data empty?
- It may be that there is no data within this time frame, or the US data has not reached the threshold of 1,000 unique users, or the game has just been launched and the data has not yet been generated.
Who is the percentage (green/red) on the metric card compared to?
- It is the month-on-month change with the previous equal-length period. For example, if you choose "last 7 days", it will be compared with the previous 7 days.
How often is the data updated? Can I see real-time data?
- The data is refreshed once a day, displaying data up to the previous day, without providing real-time data.
Why is there a difference between my own statistics and here?
- The platform data is processed based on a unified caliber and privacy compliance (such as the US threshold). The caliber, time zone, and deduplication method of your own event tracking may be different, and differences are normal.
Can the data be exported?
- Yes. Most charts support downloading CSV in the upper right corner; the error details table can also be viewed item by item.