The AdX Seller REST API has been deprecated and will be sunset on July 23, 2018. New and existing users should migrate to the DoubleClick for Publishers API.

Dimensions and Metrics

The Ad Exchange Seller REST API reporting system exposes the flexibility and customization capabilities of the Ad Exchange Seller website. Reports are generated by specifying a list of dimensions and metrics.

Dimensions

Each time Ad Exchange Seller displays an ad, every event associated with that ad is logged with a set of attributes: date, country, channel, ad unit, etc. These attributes are called dimensions.

Dimensions are used for grouping purposes in reports.

Metrics

When a report is requested, the logged events are added together according to the chosen dimensions. Metrics represent the different measurements you can make on that data.

Some metrics are calculated, instead of being measured directly.

Using multiple dimensions wisely

The generated report consists of a series of rows, each having one or more fields. Adding a new metric to a report produces a new column but adding a dimension multiplies the number of rows.

For example, a report with DATE as a dimension will generate a set of rows, one row for each day with activity. Adding a new dimension, like CUSTOM_CHANNEL_NAME, will generate a row per day and per existing channel. As a guideline it's fine to use as many metrics as you like, but try not to use more than two dimensions per report.

Choose dimensions wisely

Incompatible dimensions and metrics

There are some metrics and dimensions that cannot be combined in a single report. For example, a conflict will arise when trying to fetch URL and custom channels at the same time. This limitation is the same as in the Ad Exchange Seller website (Performance reports tab).

See an up-to-date list of dimensions and metrics.

Next steps

Send feedback about...

Seller REST API
Seller REST API