Metrics define what type of data you want to include in your report. Dimensions allow you to filter the data set based on specific values. Names of metrics and dimensions are case-sensitive.
Metrics
Metrics are the data types that you want to include in your report. You must include at least one of the following metrics in your report request.
| METRIC NAME | DESCRIPTION | VALUE TYPE | EXAMPLE VALUE |
|---|---|---|---|
Clicks |
Count of clicks served as reported by DT | Integer | 4200 |
Installs |
Count of installs as reported by the MMP | Integer | 373 |
Impressions |
Count of impressions served as reported by DT | Integer | 219147 |
Spend |
Gross Advertiser spend with DT in USD | Double | 274.26 |
Preloads |
Count of preloads successfully loaded (opened and unopened) on a device as reported by DT |
Integer | 250 |
Dimensions
You can specify filter data based on any of the following supported dimensions. The generated report only contains data defined by the filter value(s) you specify in your report request. For example, if you request the Country dimension and specify US and CA, the generated report includes the specified metrics related only to the United States and Canada.
The following table describes the supported dimensions and how to specify values for each dimension in your JSON report request:
| DIMENSION NAME | DESCRIPTION | VALUE TYPE | EXAMPLE VALUE |
|---|---|---|---|
Ad Set |
The name of the campaign as labeled in the channel. | string | My Fun Campaign / Programmatic |
Ad Set ID |
Unique identifier for the campaign within the channel. | string | 12345 / Programmatic |
App Name |
The advertised app name. | string | MyFunGame |
Campaign ID |
A standardized identifier used across systems for this campaign. | string | 12345 |
Campaign Name |
The standardized name of the campaign used across systems. | string | My Fun Campaign |
Country |
Country code | string | US / CA |
Country Name |
Country full name | string | United States of America / Canada |
Date |
A specific date in YYYY-MM-DD format (ISO 8601 format). |
string | 2023-09-07 |
OS |
The device operating system. | string | Android / iOS |
Placement Type |
The type of placement for the ad. | string | Banner / Interstitial / Rewarded |
Store ID |
The advertised app bundle. | string | my.fun.game |
Supply Account Name |
The publisher app developer. |
string | Fun Game Studio |
Supply Source Category |
The publisher app category. | string | puzzle / casual |
Supply Source ID |
The publisher app bundle or site. | string | another.fun.game |
Supply Source Name |
The publisher app or site name. | string | Another Fun Game |