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.

circle-info

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

Last updated