Skip to end of metadata
Go to start of metadata

Network Analytics Report

The Network Analytics report can be used to view both buy and sell-side data for a network member:

  • Direct advertiser impressions (bought across direct publishers and real-time inventory)
  • Direct publishers (sold across direct advertisers and other platform buyers)

To drill down into more granular analytics for a specific advertiser or publisher, see the Network Advertiser Analytics and Network Publisher Analytics reports.

For instructions on retrieving a report, see Report Service or the example below.

On This Page

Time Frame

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

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

Data Retention Period

Most data in this report is maintained permanently (exceptions noted below). After:

  • 100 days, you are no longer able to report on hourly data. However, daily, monthly and cumulative intervals are still available.
  • 14 months, you are no longer able to report on individual:
    • Creatives
    • Placements
    • Brands

In some cases Analytics reports can show delivery that does not match Lifetime QuickStats for a given advertiser or publisher. This is due to the way that Analytics reporting data older than 100 days and 14 months are aggregated. The data from Billing reports are kept in non-aggregated form indefinitely. 

To run a report for a custom time frame, set the start_date and end_date fields in your report request. For more details about these fields, see Report Service.

Time ranges including dates occurring greater than 45 days ago

If you create network analytics reports with the report_interval set to "lifetime" or "quarter_to_date" (where the end date is greater than 45 days from today), your report (regardless of metrics included) will be added to a special queue for "resource-intensive" reports. As a result, the report may take longer than usual to complete. In addition, these resource-intensive reports may, due to the amount of data being requested, fail before being completed. If your report fails to complete, you will receive a notification. If your report request fails or is deleted, you can:

  • rerun the report at a later time.
  • use a report type other than network_analytics.
  • alter the way you structure your reports (if possible) so they do not include dates greater than 45 days ago.

If you are frequently requesting network analytics reports via the API which include dates longer than 45 days ago, you may need to consider caching data and using Bulk Reporting Feeds or Log-Level Data (LLD) Feeds. See our Knowledge-Base article on Advanced Data Warehousing for more details on how to alter your reports to avoid these issues. (Customer login required)

Dimensions

Some dimensions have attributes. Dimension attributes are a more granular element of data about the parent dimension. If a dimension has attributes, the name of its attributes will appear below it using the following syntax: dimension_name.attribute_name.

Column

Type

Group?

Filter?

Example

Description

hour

time

Yes

No

"2010-02-01 06:00:00"

The hour of the auction. Note: For impressions older than 100 days, the day will be returned rather than the hour.

day

time

Yes

No

"2010-02-01"

The day of the auction.

month

time

Yes

No

"2010-02"

The month of the auction.

entity_member_id

int

Yes

Yes

123

If imp_type is 1, 2, 3, 4, 6, or 8, the ID of the buying member; otherwise, the ID of the selling member.

buyer_member_id

int

Yes

Yes

123

The ID of the buying member. If the impression was not purchased, this field shows one of the following values: 229 = PSA, 0 = Blank, or 319 = Default.

buyer_member_name

string

No

No

"My Network"

The name of the buying member. Note: The name might be "Default" or "Default Error", which means that there was no buyer for the impression, and a default creative was served.

buyer_member

string

No

No

"My Network (123)"

Deprecated (as of October 17, 2016).

seller_member_id

int

Yes

Yes

456

The ID of the selling member.

seller_member_name

string

No

No

"That Seller"

The name of the selling member.

seller_member

string

No

No

"That Seller (456)"

Deprecated (as of October 17, 2016).

advertiser_id

int

Yes

Yes

789

The ID of the advertiser. If the value is 0, either the impression was purchased by an external buyer, or a default or PSA was shown.

advertiser_name

string

No

No

"Verizon Wireless"

The name of the advertiser.

advertiser

string

Yes

No

"Verizon Wireless (789)"

Deprecated (as of October 17, 2016).

advertiser_code

string

No

No

"Verizon Wireless Code"

The custom code for the advertiser.

advertiser_currency

string

Yes

Yes

"USD"

The currency of the advertiser.

adjustment_id

int

Yes

Yes

890

The ID of the adjustment used to make changes to booked revenue and media cost values.

adjustment_daytimeYesYes"2010-02-01"The day of the adjustment.
adjustment_hourtimeYesYes"2010-02-01 06:00:00"The hour of the adjustment.

publisher_id

int

Yes

Yes

321

The ID of the publisher.

publisher_name

string

No

No

"Newscorp"

The name of the publisher.

publisher

string

Yes

No

"Newscorp (321)"

Deprecated (as of October 17, 2016).

publisher_code

string

No

No

"Newscorp Code"

The custom code for the publisher.

pub_rule_id

int

Yes

Yes

555

The ID of the publisher rule.

pub_rule_name

string

No

No

"Publisher Rule Name"

The name of the publisher rule.

pub_rule

string

Yes

No

"Publisher Rule Name (555)"

Deprecated (as of October 17, 2016).

pub_rule_code

string

No

No

"Publisher Rule Code"

The custom code for the publisher rule.

publisher_currency

string

Yes

Yes

"USD"

The currency of the publisher.

site_id

int

Yes

Yes

194

The ID of the site. Note: For impressions older than 14 months, the site_id will be 0.

site_name

string

No

No

"Site Name"

The name of the site.

site

string

Yes

No

"Site Name (194)"

Deprecated (as of October 17, 2016).

site_code

string

No

No

"Site Code"

The custom code for the site.

pixel_id

int

Yes

Yes

3141

The ID of the pixel used to track the conversion. For more information, see the Conversion Pixel Service.

flightintYesYes124785The line item flight ID.
flight.start_datedatetimeNoNo2017-02-06 00:00:00 EST5EDTThe start date of the line item's flight.
flight.end_datedatetimeNoNo2017-02-09 23:00:00 EST5EDTThe end date of the line item's flight.
flight.booked_impressions_budget_dailyintNoNo2000The daily impression budget for the line item's flight.
flight.booked_impressions_budget_lifetimeintNoNo200000The lifetime impression budget for the line item's flight.
flight.booked_revenue_budget_daily_advertiser_currencymoneyNoNo50.00The daily budget in revenue for the line item's flight.
flight.booked_revenue_budget_lifetime_advertiser_currencymoneyNoNo20000.00The lifetime budget in revenue for the line item's flight.

placement_id

int

Yes

Yes

456

The ID of the placement. Note: For impressions older than 14 months, placements will be aggregated into one row with -1 as the placement_id.

placement_name

string

No

No

"Ivillage 160x600"

The name of the placement. Note: For impressions older than 14 months, placements will be aggregated into one row with "All placement data older than 14 months" as the placement_name.

placement

string

Yes

No

"Ivillage 160x600 (456)"

Deprecated (as of October 17, 2016).

placement_code

string

No

No

"Ivillage Code"

The custom code for the placement.

insertion_order_id

int

Yes

Yes

321

The ID of the insertion order.

insertion_order_name

string

No

No

"Insertion Order"

The name of the insertion order.

insertion_order

string

Yes

No

"Insertion Order (321)"

Deprecated (as of October 17, 2016).

insertion_order_code

string

No

No

"Insertion Order Code"

The custom code for the insertion order.

insertion_order.typestringNoNo"Legacy IO"The type of insertion order associated with the impression (e.g. Legacy, Seamless).
insertion_order.statestringNoNo"active"The state of the insertion order (e.g., active, inactive)
insertion_order.start_datetimestampNoNo2017-02-06 00:00:00 EST5EDTThe start date of the non-seamless insertion order associated with the impression. For seamless orders, see billing_period.start_date.
insertion_order.end_datetimestampNoNo2017-02-09 23:00:00 EST5EDTThe end date of the non-seamless insertion order associated with the impression. For seamless orders, see billing_period.end_date.
insertion_order.booked_impressions_budget_dailyintNoNo2000The daily impression budget for the insertion order.
insertion_order.booked_impressions_budget_lifetimeintNoNo200000The lifetime impression budget for the insertion order.
insertion_order.booked_revenue_budget_dailymoneyNoNo200.00The daily budget in revenue for the insertion order.
insertion_order.booked_revenue_budget_lifetimemoneyNoNo10000.00The lifetime budget in revenue for the insertion order.
insertion_order.billing_codestringNoNo"E4567"The billing code associated with the insertion order.
type_for_insertion_orderstringYesYes"Retargeting IO"A custom reporting field describing the type of insertion order. See the labels field in the Insertion Order Service for more information. You may only select one reporting label per report.
salesrep_for_insertion_orderstringYesYes"Patricia Martin"A custom reporting field containing the sales representative for the insertion order. See the labels field in the Insertion Order Service for more information. You may only select one reporting label per report.
trafficker_for_insertion_orderstringYesYes"George Martin"A custom reporting field containing the trafficker for the insertion order. See the labels field in the Insertion Order Servicefor more information. You may only select one reporting label per report.
external_codestringYesNo"external code"An external custom code associated with the placement (by the Publisher).

line_item_id

int

Yes

Yes

111

The ID of the line item.

line_item_name

string

No

No

"Default Line Item"

The name of the line item.

line_item

string

Yes

No

"Default Line Item (111)"

Deprecated (as of October 17, 2016).

line_item_code

string

No

No

"Default Line Item Code"

The custom code for the line item.

line_item.typestringNoNo"standard"The line item type (e.g., standard, augmented)
line_item.statusstringNoNo"active"The state of the line item (e.g., active, inactive)
line_item.start_datedatetimeNoNo2017-02-06 00:00:00 EST5EDTThe start date of the non-augmented line item. For augmented line Items (ALIs), see flight.start_date.
line_item.end_datedatetimeNoNo2017-02-09 23:00:00 EST5EDTThe end date of the non-augmented line item. For augmented line Items (ALIs), see flight.end_date.
line_item.booked_impressions_budget_dailyintNoNo2000The daily impression budget for the line item.
line_item.booked_impressions_budget_lifetimeintNoNo20000The lifetime impression budget for the line item.
line_item.booked_revenue_budget_daily_adv_currmoneyNoNo1200.00The daily budget in revenue for the line item.
line_item.booked_revenue_budget_lifetime_adv_currmoneyNoNo23000.00The lifetime budget in revenue for the line item.
line_item.commentsstringNoNo"extension of Feb spend"Any comments related to this line item.
type_for_line_itemstringYesYes"Branding IO"A custom reporting field describing the type of line item. See the labels field in the Line Item Service for more information. You may only select one reporting label per report.
salesrep_for_line_itemstringYesYes"Patricia Martin"A custom reporting field containing the sales representative for the line item. See the labels field in the Line Item Service for more information. You may only select one reporting label per report.
trafficker_for_line_itemstringYesYes"George Martin"A custom reporting field containing the trafficker for the line item. See the labels field in the Line Item Service for more information. You may only select one reporting label per report.

campaign_id

int

Yes

Yes

222

The ID of the campaign.

campaign_name

string

No

No

"Default Campaign"

The name of the campaign.

campaign

string

Yes

No

"Default Campaign (222)"

Deprecated (as of October 17, 2016).

campaign_code

string

No

No

"Default Campaign Code"

The custom code for the campaign.

campaign_priority

int

No

No

5

The bidding priority for a campaign that targets direct inventory. (Customer login required)

Possible values: 1 - 10, where 10 is the highest priority.

campaign_typestringYesYes"House Ad Campaign"The type of campaigns under the line item. See the labels field in the Line Item Service for more information.

creative_id

int

Yes

Yes

554

The ID of the creative. Note:

  • For impressions older than 100 days, creatives will be aggregated into one row with 0 as the creative_id.
  • For external click or impression trackers, creative_id will be "External Clicks" or "External Imps".

creative_name

string

No

No

"Q1 2010 728x90"

The name of the creative. Note:

  • For impressions older than 100 days, creatives will be aggregated into one row with "All creative data older than 100 days" as the creative_name.
  • For external click or impression trackers, creative_name will be "External Clicks" or "External Imps".
creative_codestringNoNo"12655"The code for the creative. Note:
  • For impressions older than 100 days, creatives will be aggregated into one row with "All creative data older than 100 days" as the creative_name.
  • For external click or impression trackers, creative_code will be "External Clicks" or "External Imps".

creative

string

No

No

"Q1 2010 728x90 (554)"

Deprecated (as of October 17, 2016).

size

string

Yes

Yes

"728x90"

The size of the placement/creative served.

brand_id

int

Yes

Yes

3

The ID of the brand associated with a creative. For imp_type_id = 6, no information is available in the brand_id field for this report. See the Seller Brand Review Report instead.

brand_name

string

No

No

"Ace Hardware"

The name of the brand associated with a creative. For imp_type_id = 6, no information is available in the brand_name field for this report. See the Seller Brand Review Report instead.

brand

string

No

No

"Ace Hardware (3)"

Deprecated (as of October 17, 2016).

billing_period.start_datedatetimeNoNo"2015-05-25 19:19:53"

The earliest date of the insertion order's billing period.

Alpha-Beta Notice

This field or feature is part of functionality currently in either Alpha or Beta phase. It is therefore subject to change.

billing_period.end_datedatetimeNoNo"2015-05-30 19:19:53"

The last date of the insertion order's billing period.

Alpha-Beta Notice

This field or feature is part of functionality currently in either Alpha or Beta phase. It is therefore subject to change.

billing_period.booked_imps_budget_dailyintNoNo3500The daily impression budget of the insertion order's billing period.
billing_period.booked_imps_budget_lifetimeintNoNo300000The lifetime impression budget of the insertion order's billing period.
billing_period.booked_revenue_budget_daily_buying_currencymoneyNoNo250.00The daily revenue budget of the insertion order's billing period.
billing_period.booked_revenue_budget_lifetime_buying_currencymoneyNoNo2500.00The lifetime revenue budget of the insertion order's billing period.
billing_period.external_codestringYesNo"houseware245"The custom code for the billing period (budget_interval).

geo_country

string

Yes

Yes

"US"

The code for the geographic country. For impression requests for which we received no indication that the ad was rendered (i.e., non-transacted), country information is not provided.

geo_country_name

string

No

No

"United States"

The name of the geographic country. For impression requests for which we received no indication that the ad was rendered (i.e., non-transacted), country information may not be provided.

inventory_class

string

Yes

Yes

"class_1", "class_2", "class_3", "unaudited", "black"

The class of the inventory.

bid_type

string

Yes

Yes

"Manual"

The optimization phase the node was in when it bid for this impression. Note that the term "give up" is appended to the bid types below if the valuation for that impression falls below the venue's "give up price". For more information, see Venues and Give Up (Customer login required). Allowed values:

  • "Manual": Applies when you are bidding with a CPM goal, whether it's Base, EAP, or ECP.
  • "Learn": Applies when you are bidding with optimization (CPA, CPC, or margin) and we do not yet have enough data to bid optimized.
  • "Optimized": Applies when you are bidding with optimization (CPA, CPC, or margin) and we have enough data to bid optimized.
  • "Unknown": The node was in an unknown optimization phase.
  • "Optimized give up"
  • "Learn give up"
  • "Manual give up"

imp_type_id

int

Yes

Yes

1

The ID for the type of impression. Possible values (associated types in parentheses):
  • 1 ("Blank"): No creative served.
  • 2 ("PSA"): A public service announcement served because there were no valid bids and no default creative was available.
  • 3 ("Default Error"): A default creative served due to a timeout issue.
  • 4 ("Default"): A default creative served because there were no valid bids.
  • 5 ("Kept"): Your advertiser's creative served on your publisher's site.
  • 6 ("Resold"): Your publisher's impression was sold to a third-party buyer.
  • 7 ("RTB"): Your advertiser's creative served on third-party inventory.
  • 8 ("PSA Error"): A public service announcement served due to a timeout issue or lack of a default creative.
  • 9 ("External Impression"): An impression from an impression tracker.
  • 10 ("External Click"): A click from a click tracker.

imp_type

string

Yes

Yes

"Blank"

The type of impression. For possible values, see imp_type_id.

buyer_type

string

Yes

Yes

"Real Time"

The type of impression purchased by the buyer member. Possible values: "Real Time" or "Direct".

seller_type

string

Yes

Yes

"Real Time"

The type of impression sold by the seller member. Possible values: "Real Time" or "Direct".

revenue_type

string

Yes

Yes

"CPA"

The basis on which the member gets paid.

revenue_type_id

int

Yes

Yes

4

Possible values: -1 = No Payment, 0 = Flat CPM, 1 = Cost Plus CPM, 2 = Cost Plus Margin, 3 = CPC, 4 = CPA, 5 = Revshare, or 6 = Flat Fee, 7 = Variable CPM, 8 = Estimated CPM, or 9 = CPVM.

supply_type

string

Yes

No

"web"

The type of inventory. Possible values: "web", "mobile_web", or "mobile_app", or "facebook_sidebar".

payment_type

string

Yes

Yes

"cpm"

The type of payment to a broker. Possible values: "cpm", "revshare", "cpvm".

deal_id

int

Yes

Yes

2345

The ID of the deal. For more information about negotiated deals between buyers and sellers, see Deal Service and Deal Buyer Access Service.

deal_name

string

No

No

"Private deal for buyer 1085 with floor of $2.50"

The name of the deal.

deal

 

string

No

No

"Private deal for buyer 1085 with floor of $2.50 (45)"

Deprecated (as of October 17, 2016).

deal_codestringNoNo"External seller deal code"The custom code for the deal. For deals with external supply partners, this is generally the string that you use to identify the deal.

media_type

 

string

No

No

"Standard Banner"

The specific display style of a creative. You can use the Media Subtype Service to view all possible media subtypes.

mediatype_id

 

int

Yes

Yes

1

The ID of the specific display style of a creative. You can use the Media Subtype Service to view all possible media subtypes.
media_subtypeobject   

The display style of creatives that can use this template. Each media subtype belongs to a superordinate media type, for example, the "Standard Banner" media subtype belongs to the "Banner" media type. See Media Subtype Service for more details.

media_subtype_idint   The ID of media subtype.See Media Subtype Service for more details.

salesperson_for_advertiser

string

Yes

Yes

"Michael Sellers"

The salesperson for the advertiser. See the "labels" field in the Advertiser Service for more details.

account_manager_for_advertiser

string

Yes

Yes

"Yvonne Summers"

The account manager for the advertiser. See the "labels" field in the Advertiser Service for more details.

advertiser_type

string

Yes

Yes

"Local"

The type of advertiser. See the "labels" field in the Advertiser Service for more details.

salesperson_for_publisher

string

Yes

Yes

"Brian Young"

The salesperson for the publisher. See the "labels" field in the Publisher Service for more details.

account_manager_for_publisher

string

Yes

Yes

"Ami Fisher"

The account manager for the publisher. See the "labels" field in the Publisher Service for more details.

user_group_for_campaign

string

Yes

Yes

"Test"

The test/control user group for the campaign. See the "labels" field in the Campaign Service for more details.

line_item_typestringYesYes"Performance"A field describing the line item, provided by the user. See Line Item Service for more information.
insertion_order_typestringYesYes"Client A Insertion Order"A field describing the insertion order, provided by the user. See Insertion Order Service for more information.
buying_currencystringYesYes"EUR"The transaction currency used by the buyer to purchase this impression.
selling_currencystringYesYes"EUR"The transaction currency used by the seller to sell this impression.
imps_filtered_reason_idintNoYes"3"The numeric ID associated with the reason why the impression request was filtered out by AppNexus inventory quality controls and the auction was not held. Possible values are integers betweeen 0 and 7. See imps_filtered_reason below for more information.
imps_filtered_reasonstringNoYes"Invalid Domain"

The reason why the impression request was filtered out by AppNexus inventory quality controls and the auction was not held. Possible reasons are:

  • "Invalid Domain" (1)
  • "Invalid IP" (2)
  • "Suspected Domain Detection Tampering" (3, 4, 5)
  • "Unknown" (6, 7)

"Valid Impression" (0) is also a valid filtered request reason, but in that case, an auction was held and it was not filtered.

marketplace_clearing_event_idintYesYes2The ID of the underlying auction event that was transacted (e.g., impression, viewable impression, completed video).  For more information, see Exchange Traded Views. For a list of Clearing Events and their IDs, see the Supported Viewability Standards section of Exchange Traded Views.
marketplace_clearing_event_namestringNoYes"Views - Standard Display"The name of the underlying auction event that was transacted (e.g., impression, viewable impression, completed video).  For more information, see Exchange Traded Views. For a list of Clearing Events and their IDs, see the Supported Viewability Standards section of Exchange Traded Views.
marketplace_clearing_eventstringNoNo"Views - Standard Display (2)"The concatenated value of the name and ID of the underlying auction event that was transacted (e.g., impression, viewable impression, completed video).  For more information, see Exchange Traded Views. For a list of Clearing Events and their IDs, see the Supported Viewability Standards section of Exchange Traded Views.

Metrics

Column

Type

Example

Formula

Description

imps

int

2340

imps

The total number of impressions (served and resold).

imp_requestsint3245 The total number of ad calls (impression requests).

imps_blank

int

3

imps_blank

The number of impressions served with a blank.

imps_psa

int

5

imps_psa

The number of impressions served a PSA.

imps_psa_error

int

0

imps_psa_error

The number of impressions served a PSA due to a timeout issue or lack of a default creative.

imps_default_error

int

0

imps_default_error

The number of impressions that defaulted due to a timeout issue.

imps_default_bidder

int

0

imps_default_bidder

The number of impressions that defaulted because there were no valid bids.

imps_kept

int

0

imps_kept

The number of impressions your advertiser purchased from your publisher.

imps_resold

int

0

imps_resold

The number of impressions your publisher sold to a third party.

imps_rtb

int

2332

imps_rtb

The number of impressions your advertiser bought from a third party.

external_impression

int

0

external_impression

The number of impressions from an impression tracker.

clicks

int

1

clicks

The total number of clicks across all impressions.

click_thru_pct

double

1.12359550561797%

(clicks / imps) x 100

The rate of clicks to impressions as a percentage.

external_click

int

0

external_click

The number of external clicks.

cost

money

16.833378

cost

The total amount of media cost for direct publisher and purchased real-time inventory.

cost_including_fees

money

19.281633

cost + serving_fees

The total amount of media cost for direct publisher and purchased real-time inventory plus additional fees.

revenue

money

25.767257

booked_revenue + reseller_revenue

The sum of booked revenue and reseller revenue.

revenue_including_fees

money

25.767257

revenue - commissions

The sum of booked revenue and reseller revenue minus commissions.

booked_revenue

money

25.767257

booked_revenue

The total revenue booked through direct advertisers (line item).

booked_revenue_adv_curr

money

25.767257

booked_revenue_adv_curr

The total revenue booked through a direct advertiser, in the currency of the advertiser.

reseller_revenue

money

0

reseller_revenue

The total revenue on resold impressions through direct publishers.

profit

money

0.084102

revenue - cost

The total network revenue minus network cost.

profit_including_fees

money

0.058959

revenue_including_fees - cost - serving_fees

The total network revenue minus network cost and additional fees.

commissions

money

0

commissions

Fees that come out of the booked revenue.

cpm

money

1.66051685393258

(cost / imps) x 1000

The cost per 1000 impressions.

cpm_including_fees

money

1.94302247191011

(cost_including_fees / imps) x 1000

The cost including ad serving fees per 1000 impressions.

post_click_convs

int

3

post_click_convs

The total number of recorded post-click conversions.

post_click_revenue

money

24.84

post_click_revenue

The revenue from post-click conversions.

post_view_convs

int

2

post_view_convs

The total number of recorded post-view conversions.

post_view_revenue

money

12.42

post_view_revenue

The revenue from post-view conversions.

total_convs

int

5

total_convs

The total number of post-view and post-click conversions.

convs_per_mm

double

221.877080097625

(total_convs / imps) x 1,000,000

The number of conversions per million impressions.

convs_rate

double

0.000221877080097626

total_convs / imps

The rate of conversions to impressions.

ctr

double

0.000221877080097626

clicks / imps

The rate of clicks to impressions.

rpm

money

2.60548314606741

(revenue / imps) x 1000

The revenue per 1000 impressions.

rpm_including_fees

money

2.60548314606741

(revenue_including_fees / imps) x 1000

The revenue minus commissions per 1000 impressions.

total_network_rpm

money

2.60548314606741

(revenue / imps) x 1000

The revenue per 1000 impressions.

total_publisher_rpm

money

1.66051685393258

(cost / imps) x 1000

The cost per 1000 impressions.

sold_network_rpm

double

231.888

(revenue / imps) x 1000 ----- no errors

The revenue per 1000 impressions that were not defaults or errors.

sold_publisher_rpm

double

147.786

(cost / imps) x 1000 ----- no errors

The cost per 1000 impressions that were not defaults or errors.

media_cost_pub_curr

money

123.45

cost

The media cost, expressed in the currency of the publisher.


You must group by publisher or publisher_currency when pulling this report if you are reporting across publishers who use different currencies.

ppm

money

0.944966292134831

(profit / imps) x 1000

The profit per 1000 impressions.

ppm_including_fees

money

0.662460674157303

(profit_including_fees / imps) x 1000

The profit including additional fees per 1000 impressions.

serving_fees

money

0.025143

serving_fees

Fees that are added to the media cost.

imps_viewed

int

30,450

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

10,120

view_measured_imps

The total number of impressions that were measured for viewability.

view_rate

double

58%

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_measurement_rate

double

45%

view_measurement_rate

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

cpvmmoney2.25(media_cost / imps_viewable) x 1000The cost per 1000 viewable impressions.
imps_master_creativeint1276imps_master_creativeThe total number of impressions from the master creative in page-level roadblocking. Note: This metric is in alpha testing and not available to all customers.
data_costsmoney123.45data_costsThe total cost of 3rd party data used on the campaign.
imps_filteredint2024 The total number of bid requests for which AppNexus did not hold an auction due to inventory quality concerns. See imps_filtered_reason_id and imps_filtered_reason (under Dimensions) for a list of the possible reasons.
avg_bid_reductiondouble18% The average bid reduction you gained on the line item or campaign. This value represents the difference (as a percentage) between your bid and the actual media cost you paid for the impression you won (e.g., due to bid reduction). This value is only valid for RTB bidding (i.e., not Managed). Currently, this value is not accurately calculated for line items for which the payment_auction_event_type field has been set to 2 .
Metrics with local currency support:
revenue_buying_currencymoney123.45(booked_revenue + reseller_revenue) * [buying exchange rate]The sum of booked revenue and reseller revenue in the currency the buyer used to purchase the inventory. Note: exchange rates are not yet available in reporting.
revenue_selling_currencymoney123.45(booked_revenue + reseller_revenue) * [selling exchange rate]The sum of booked revenue and reseller revenue in the currency the seller used to sell the impression. Note: exchange rates are not yet available in reporting.
booked_revenue_buying_currencymoney123.45booked_revenue * [buying exchange rate]The total revenue booked through direct advertisers (line item) in the currency the buyer used to purchase the inventory. Note: exchange rates are not yet available in reporting.
booked_revenue_selling_currencymoney123.45booked_revenue * [selling exchange rate]The total revenue booked through direct advertisers (line item) in the currency the seller used to sell the impression. Note: exchange rates are not yet available in reporting.
reseller_revenue_buying_currencymoney123.45reseller_revenue * [buying exchange rate]The total revenue on resold impressions through direct publishers in the currency the buyer used to purchase the inventory. Note: exchange rates are not yet available in reporting.
reseller_revenue_selling_currencymoney123.45reseller_revenue * [selling exchange rate]The total revenue on resold impressions through direct publishers in the currency the seller used to sell the impression. Note: exchange rates are not yet available in reporting.
cost_buying_currencymoney123.45cost * [buying exchange rate]The total amount of media cost for direct publisher and purchased real-time inventory in the currency the buyer used to purchase the inventory. Note: exchange rates are not yet available in reporting.
cost_selling_currencymoney123.45cost * [selling exchange rate]The total amount of media cost for direct publisher and purchased real-time inventory in the currency the seller used to sell the impression. Note: exchange rates are not yet available in reporting.
profit_buying_currencymoney123.45(revenue - cost) * [buying exchange rate]The total network revenue minus network cost in the currency the buyer used to purchase the inventory. Note: exchange rates are not yet available in reporting.
profit_selling_currencymoney123.45(revenue - cost) * [selling exchange rate]The total network revenue minus network cost in the currency the seller used to sell the impression. Note: exchange rates are not yet available in reporting.
total_network_rpm_buying_currencymoney123.45(revenue / imps) x 1000 * [buying exchange rate]The revenue per 1000 impressions in the currency the buyer used to purchase the inventory. Note: exchange rates are not yet available in reporting.
total_network_rpm_selling_currencymoney123.45(revenue / imps) x 1000 * [selling exchange rate]The revenue per 1000 impressions in the currency the seller used to sell the impression. Note: exchange rates are not yet available in reporting.
cpm_buying_currencymoney123.45

(cost / imps) x 1000 * [buying exchange rate]

The cost per 1000 impressions in the currency the buyer used to purchase the inventory. Note: exchange rates are not yet available in reporting.

cpm_selling_currencymoney123.45

(cost / imps) x 1000 * [selling exchange rate]

The cost per 1000 impressions in the currency the seller used to sell the impression. Note: exchange rates are not yet available in reporting.

rpm_buying_currencymoney123.45

(revenue / imps) x 1000 * [buying exchange rate]

The revenue per 1000 impressions in the currency the buyer used to purchase the inventory. Note: exchange rates are not yet available in reporting.

rpm_selling_currencymoney123.45

(revenue / imps) x 1000 * [selling exchange rate]

The revenue per 1000 impressions in the currency the seller used to sell the impression. Note: exchange rates are not yet available in reporting.

ppm_buying_currencymoney123.45

(profit / imps) x 1000 * [buying exchange rate]

The profit per 1000 impressions in the currency the buyer used to purchase the inventory. Note: exchange rates are not yet available in reporting.

ppm_selling_currencymoney123.45

(profit / imps) x 1000 * [selling exchange rate]

The profit per 1000 impressions in the currency the seller used to sell the impression. Note: exchange rates are not yet available in reporting.

sold_network_rpm_buying_currencymoney123.45

(revenue / imps) x 1000 * [buying exchange rate] ----- no errors

The revenue per 1000 impressions that were not defaults or errors in the currency the buyer used to purchase the inventory. Note: exchange rates are not yet available in reporting.

sold_network_rpm_selling_currencymoney123.45

(revenue / imps) x 1000 * [selling exchange rate] ----- no errors

The revenue per 1000 impressions that were not defaults or errors in the currency the seller used to sell the impression. Note: exchange rates are not yet available in reporting.

commissions_buying_currencymoney123.45

commissions * [buying exchange rate]

Fees that come out of the booked revenue in the currency the buyer used to purchase the inventory. Note: exchange rates are not yet available in reporting.

commissions_selling_currencymoney123.45

commissions * [selling exchange rate]

Fees that come out of the booked revenue in the currency the seller used to sell the impression. Note: exchange rates are not yet available in reporting.

serving_fees_buying_currencymoney123.45

serving_fees * [buying exchange rate]

Fees that are added to the media cost in the currency the buyer used to purchase the inventory. Note: exchange rates are not yet available in reporting.

serving_fees_selling_currencymoney123.45

serving_fees * [selling exchange rate]

Fees that are added to the media cost in the currency the seller used to sell the impression. Note: exchange rates are not yet available in reporting.

data_costs_buying_currencymoney123.45data_costs * [buying exchange rate]The total cost of 3rd party data used on the campaign in the currency the buyer used to purchase the inventory. Note: exchange rates are not yet available in reporting.
data_costs_selling_currencymoney123.45data_costs * [selling exchange rate]The total cost of 3rd party data used on the campaign the seller used to sell the impression. Note: exchange rates are not yet available in reporting.
marketplace_clearing_event_unitsint23 The total number of events purchased (for the associated Clearing Event). When buying a Clearing Event other than impression (e.g., viewable impressions), the number of billed events will be less than the number of impressions. For more information, see Exchange Traded Views.
marketplace_clearing_events_booked_revenue_cpmdouble2.45 The total revenue per 1000 events (for the associated Clearing Event).
marketplace_clearing_event_buyer_media_cost_ecpmdouble2.37 The total media cost per 1000 events (for the associated Clearing Event).

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