Skip to end of metadata
Go to start of metadata

Platform Buyer Report

The Platform Buyer Report provides granular transaction information to buyers (down to the tag level). For instructions on retrieving this report, see the Example below.

On This Page

Need more than 90 days of data?

The platform_buyer and platform_seller types pull from tables that store the last 90 days worth of data. For data beyond the past 90 days, please use the buyer_platform_billing and seller_platform_billing report types.


Time Frame

The report_interval field in the JSON request can be set to one of the following:

  • current_hour
  • last_hour
  • last_48_hours
  • today
  • yesterday
  • last_7_days
  • month_to_date
  • quarter_to_date
  • last_month
  • lifetime
  • mtd
  • month_to_yesterday

Dimensions

ColumnTypeFilter?Description
monthtimeYesThe month of the year in which the event being counted occurred.
daydateYesThe day of the year in which the event being counted occurred.
hourdateYesThe hour in which the event being counted occurred.
yeardateYesThe year in which the event being counted occurred.
buyer_member_idintYesThe internal ID of the buyer member.
seller_member_idintYesThe internal ID of the seller member.
seller_member_namestringYesThe display name of the seller member.
seller_memberstringYes

Deprecated.

tag_idintYesThe ID of the tag.
publisher_idintYesThe internal ID of the publisher.
publisher_namestringYesThe display name of the publisher.
publisherstringYes

Deprecated.

sizestringYesThe size of the creative.
geo_countrystringYesThe display name of the country followed by the ID (AppNexus format).
geo_country_namestringYesThe country where the event being counted (e.g., click) occurred.
content_category_idintYesThe ID of the content category that the inventory where the impression occurred was associated with. For more information about content categories, see the Content Category Service.
content_category_namestringYesThe name of the content category that the inventory where the impression occurred was associated with. For more information about content categories, see the Content Category Service.
content_categorystringYes

Deprecated.

imp_typestringYes

The type of impression served. Possible values:

  • 1 = blank
  • 2 = PSA
  • 3 = default error
  • 4 = default
  • 5 = kept
  • 6 = resold
  • 7 = RTB
  • 8 = PSA resulting from a default error
  • 9 = external impression
  • 10 = external click
creative_idintYesThe ID of the creative that served on the impression where the "event" you're counting occurred. For more information about creatives, see the Creative Service.
creative_namestringYesThe name of the creative that served on the impression where the "event" you're counting occurred. For more information about creatives, see the Creative Service.
creativestringYes

Deprecated.

bidder_idintYesThe ID of the bidder that purchased the impression where the "event" you're reporting on occurred. For more information about bidders, see the Bidder Service.
bidder_namestringYesThe name of the bidder that purchased the impression where the "event" you're reporting on occurred. For more information about bidders, see the Bidder Service.
bidderstringYes

Deprecated.

site_idintYesThe internal ID of the site.
site_namestringYesThe display name of the site.
sitestringYes

Deprecated.

tag_namestringYesThe display name of the tag.
tagstringYes

Deprecated.

buyer_currencystringYesThe buyer member's selected currency. For a list of supported currencies, see Supported Currencies.
supply_typestringNo

The type of inventory. Possible values:

  • "web"
  • "mobile_web"
  • "mobile_app"
publisher_codestringYesThe custom code for the publisher, entered to correspond to the publisher code within the external system.
site_codestringYesThe custom code for the site, entered to correspond to the site code within the external system.
buyer_member_namestringYesThe display name of the buyer member.
buyer_memberstringYes

Deprecated.

Metrics

ColumnTypeFormulaDescription
imps_boughtintimps_boughtThe total number of impressions purchased successfully.
buyer_spendmoneybuyer_spend

The amount the buyer pays for the cost of media.

clicksintclicksThe total number of clicks. NOTE: Clicks are not logged for external demand partners.
click_rate_solddouble( clicks / imps_bought )The "click-through rate", or CTR. NOTE: Clicks are not logged for external demand partners.
buyer_ecpmmoney( buyer_spend / imps_bought ) * 1000

The buyer's cost per impression expressed in eCPM.

buyer_spend_buyer_currmoneybuyer_spend, expressed in the buyer's currency.

The buyer's total spend in their selected currency. For a list of supported currencies, see Supported Currencies.

buyer_ecpm_buyer_currmoneybuyer_ecpm, expressed in the buyer's currency.

The buyer's cost per impression in their selected currency. For a list of supported currencies, see Supported Currencies.

imps_viewed
int

imps_viewed

The number of measured impressions that were viewable, per the IAB Viewability definition, which states that an impression is viewable if 50% of the pixels are in-view during 1 consecutive second.

view_measured_imps

int

view_measured_imps

The total number of impressions that were measured for viewability.

view_rate

double

view_rate

The percentage of impressions that were viewable out of the total number of impressions measured for viewability. (Viewed Imps / View Measured Imps)

view_measurable_rate

double

view_measurable_rate

The percentage of impressions measured for viewability out of the total number of impressions. (View Measured Imps / Imps)

Example

1. Create the JSON-formatted report request
2. POST the request to the Reporting Service
3. GET the report status from the Report Service
4. GET the report data from the Report Download Service

Schedule a frequently run report

You can schedule reports that you would like to pull regularly. See the Saved Report Service for more information.

Related Topics