> For the complete documentation index, see [llms.txt](https://support.gamoshi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.gamoshi.com/gamoshi-wiki/analytics.md).
# Analytics
*Available for DSP accounts, Enterprise PE accounts, and PE accounts - each account will have different metrics and account screen availability*
## Overview
The **Analytics Module** helps you monitor account activity and analyze performance data in real time. You can review your advertising activity performance and conversions, generate reports, sample bid-stream data, and access Analytics data through the API.
| Screen | Purpose |
| --------------- | -------------------------------------------------------------------------------------- |
| **Today** | Monitor current hourly activity and compare it with previous periods. |
| **BI** | Build multidimensional queries and analyze performance data. |
| **QPS** | Monitor incoming and outgoing queries per second (QPS). |
| **Performance** | Review traffic, bidding, delivery, Partner performance, and latency. |
| **Conversions** | Review conversion activity recorded in the platform. |
| **Reports** | Create, manage, and schedule reports that can be sent via email in Excel, CSV format.. |
| **Sampling** | Request raw JSON samples of bid-stream data. |
| **API** | Configure programmatic access to Analytics data. |
***
## Today screen
***Availability: All account types***
The **Today** screen shows current account activity and hourly run rates.
All times use UTC.
### Current Activity
The left panel shows running estimates for:
* Impressions
* Video impressions
* Bids
* Gross spend
* Net spend
### Trend Comparison
The right panel compares:
* Today’s activity
* Yesterday’s activity for the same period
* Activity from the same day last week
Use this comparison to identify changes or unexpected drops in current performance.
***
## BI screen
The **BI** (Business Intelligence) screen includes five tabs:
1. **BI**
2. **Geo Analytics**
3. **Events Geo Heatmap**
4. **Financial**
5. **Segments**
### BI (Business Intelligence) Tab
***Availability: All account types. Metrics and dimensions vary by account type.***
Use the **BI** tab for multidimensional analysis and custom reporting.
Data can take up to five minutes to refresh.
Combine filters and dimensions to create tailored account-activity views.
For queries of up to 30 days, the **BI** tab uses the account or query time zone.
Queries longer than 30 days use UTC. Use the **Financial** tab for longer periods in another time zone. It includes all financial events.
For the full list of [metrics](/gamoshi-wiki/general-information/gamoshi-metrics.md).
#### **Filters**
Filters include:
* Time filters
* Core entities elements
* Geo filters
* Format, Device, and environment filters
* Advanced filters such as Domain and app Bundle
#### **Granularity**
* Hour
* Day
* Month
#### **Dimensions**
Dimensions include:
* Core entities elements
* Geo dimensions
* Format, Device, and Environment
* Advanced dimensions
The platform automatically calculates metrics such as Bids, Opportunities, Impressions, and Spend.
You can download the results or email them.
### Geo Analytics tab
***Availability: DSP accounts at the PRO level and higher, and PE Enterprise accounts.***
The **Geo Analytics** tab shows Campaign performance by location.
#### **Group data by:**
* Core entities - advertiser, campaign, creative, inventory, publisher
* Country
* Region
* City
* Zip Code
#### **Granularity**
* Hour
* Day
* Month
#### **Geo-related metrics include:**
* Bids
* Impressions/video impressions
* Clicks
* CTR
* eCPM
{% hint style="info" %}
You can't filter directly by individual cities or ZIP Codes. Use geographic groupings to analyze traffic by origin.
{% endhint %}
### Events Geo Heatmap tab
***Availability: DSP accounts at the PRO level and higher, and PE Enterprise accounts.***
The **Events Geo Heatmap** tab shows historical engagement data on an interactive map.
Areas with more events use warmer colors.
**You can:**
* Apply basic filters and advanced geographic criteria
* Run standalone Heatmap reports
* Hover over map markers to view location-specific metrics
* Share a map view with a quick link
**Location tooltips can show:**
* Impressions
* Clicks
* Conversions
### Financial tab
***Availability: All accounts***
The **Financial** tab shows event data for periods up to two years.
It uses the account or query-selected time zone.
Financial queries return event data only, which speeds up long-period queries.
Use this tab to analyze financial performance and events over extended periods.
This tab limits available dimensions to keep long-period queries fast:
* Time
* Core entities: Advertiser, Campaign, Inventory, and Publisher
* Ad type and source (App or Site)
**Granularity**
* Hour
* Day
* Month
### Segments tab
***Availability: DSP accounts and PE Enterprise accounts.***
The **Segments** tab shows incoming requests for audience segments associated with active campaigns. It enables users to validate the volume of traffic available for their campaign-chosen audience segments.
#### Available filters
* Time filter
* Ad type
* Source (App or Site)
* Country
* Device Type
* Segment
* Segment Provider
#### **Granularity**
* Hour
* Day
* Month
#### Available dimensions
* Time
* Source (App or Site)
* Ad Type
* Country
* Device type
#### Available metrics
* Segment
* Segment Provider
* Requests
***
## QPS screen
Use the **QPS** tab to monitor incoming and outgoing queries per second (QPS).
The screen includes three sections:
1. QPS volume graphs
2. Incoming QPS, available for all account types
3. Outgoing QPS, available for PE Enterprise accounts
QPS volumes are estimates. Don't use them for financial reporting.
#### Incoming QPS filters
* Inventory Business Partner
* Inventory
* Predefined dates, from the past five minutes to the past three days
#### Outgoing QPS filters
* Advertiser Business Partner
* Advertiser
* Predefined dates, from the past five minutes to the past three days
View each section as a table or graph. By default, results show the top 10 partners and their QPS volume for the selected time interval.
***
## Performance screen
***Availability: All account types. Metrics and dimensions vary by account type.***
The **Performance** screen provides a layered view of Advertiser and Inventory delivery.
It includes four sections.
### Requests graphs
Use the Requests graphs to review:
* Traffic quality
* App and Site traffic
* Incoming QPS
### Bids graphs
Use the Bids graphs to review:
* Bid activity
* Bid responses
* Invalid bids
* Creative dimension mismatches
### Performance metrics graphs
Use the Performance Metrics graphs to review:
* Fill Rate
* Clear Rate
* Totals for selected intervals
### Top 10 rankings and partners'Partners performance
Use these sections to review:
* Top-performing entities
* Financial performance
* Average response time
* Performance against Tmax limits
***
## Conversions screen
***Availability: DSP accounts and PE Enterprise accounts.***
Use the **Conversions** screen to review conversion activity recorded in the platform.
The screen has two sections.
### Totals section
Use the date filter, which defaults to Today, to view campaign performance totals.
**You can filter by:**
* Advertiser Business Partner
* Advertiser
* Campaign
**You can view:**
* Impressions
* Video Impressions
* Conversion Opportunities - number of times a user interacted with the conversion page (Only for Web conversion).
* Conversion Views - Number of conversion view events. Fires when a conversion event occurs following an ad view event. Used to record non-click attribution data.
* Conversion Clicks - Number of conversion events that occur within a few minutes after the click that led to the conversion.
### Data section
Query detailed conversion data by entity and conversion.
#### Filters
* Date filters
* Advertiser
* Campaign
* Creative
* Conversion
#### Granularity
* Hour
* Day
* Month
#### Dimensions
* Time
* Conversion
* Goal
* Advertiser
* Campaign
* Creative
* Country
* Device
* OS
#### Metrics
* Conversion
* Goal
* Conversion Views
* Conversions Clicks
* Conversion Value
You can email or download query results.
You can also download raw query data, including user information.
***
## Reports screen
***Availability: All account types***
Use the **Reports** screen to create, manage, and schedule two report types:
* Entity reports include complete data for high-volume entities, such as Domains and App bundles. This data might not fully appear in the **BI** screen.
* Performance summary reports cover Business Partner, Advertiser, Campaign, and Inventory dimensions. Run them manually or schedule email delivery.
### Domain and Bundle reports
**BI** results show up to 1,000 domains. Domain, Bundle, and App ID reports include every matching traffic source.
### Manual and scheduled reports
You can generate reports manually or schedule recurring delivery.
Schedules include:
* Daily
* Weekly
* Monthly
Reports support Excel, JSON, and CSV formats.
***
## Sampling screen
***Availability: All account types***
Use the **Sampling** screen to request raw, unaggregated bid-stream data.
Samples contain JSON records of valid or filtered requests and responses. Use them for Partner audits.
#### Sampling requirements and limits
* The selected Advertiser must have active Campaigns
* The selected Inventory Partner must have active traffic
* Up to five Sampling requests can run at once
* Files expire and are permanently removed after 30 days
***
## API screen
***Availability: All account types***
The **API** screen provides the details needed to extract Analytics data through an HTTP `GET` endpoint.
An Admin maps an Analytics profile to a designated Business Partner. This mapping defines the external Partner’s data-access scope before generating a secure token. See [how to generate an API token.](/gamoshi-wiki/how-to-guides/how-to-generate-an-api-token.md)
***
## Troubleshooting
BI data doesn't include the most recent activity
BI data can take up to five minutes to refresh. Wait for the update, then run the query again.
You can't select a city or ZIP Code as a Geo Analytics filter
The **Geo Analytics** tab doesn't support direct filtering by city or ZIP Code. Use geographic groupings instead.
A BI domain report doesn't include every traffic source
**BI** results show up to 1,000 domains. Use the relevant Domain, Bundle, or App ID report to include every matching traffic source.
You can't create a Sampling request
Confirm that:
* The selected Advertiser has active Campaigns
* The selected Inventory Partner has active traffic
* Fewer than five Sampling requests are running
A Sampling file is no longer available
Sampling files expire and are permanently removed after 30 days.
***
## Related topics
Use these guides to configure tracking and interpret Analytics data:
* [Gamoshi metrics](/gamoshi-wiki/general-information/gamoshi-metrics.md) Defines BI and Performance metrics.
* [How to generate an API token](/gamoshi-wiki/how-to-guides/how-to-generate-an-api-token.md) Explains how to request Analytics reports programmatically.
* [How to Implement Conversion Tracking](/gamoshi-wiki/how-to-guides/how-to-implement-conversion-tracking.md) Explains how to configure conversion events.