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:
- 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. 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:
- Navigate to the Monetization page from the sidebar.
- Click the In-App Ads (IAAs) tab.
- 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:
- 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.
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 |