Reporting API Metrics and Dimensions

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

Back to Top ⇧