Skip to end of metadata
Go to start of metadata

Network Publisher Analytics Report

The Network Publisher Analytics report can be used to view performance data for a specific publisher within your network that is more granular than the data provided in the Network Analytics report. This report is available to network users only. Publisher users can use the Publisher Analytics report.

For usage instructions, see the Example below. Note that this report requires that a publisher ID be specified as part of the URL, for example:

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_2_days
  • last_7_days
  • last_30_days
  • month_to_date
  • month_to_yesterday
  • quarter_to_date
  • last_month
  • lifetime

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.

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 is aggregated. The data from Billing reports are kept in non-aggregated form indefinitely. 

Dimensions

Column

Type

Group?

Filter?

Example

Description

hour

date

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

date

Yes

no

"2010-02-01"

The day of the auction.

month

date

yes

no

"2010-02"

The month of the auction.

buyer_member_id

int

yes

yes

567

The ID of the buying member.

buyer_member_name

string

no

no

"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

"Network (567)"

Deprecated (as of October 17, 2016).

seller_member_id

int

yes

yes

67

The ID of the selling member.

advertiser_id

int

yes

yes

728

The ID of the advertiser.

advertiser_name

string

no

no

"Test"

The name of the advertiser.

advertiser

string

no

no

"Test (123)"

Deprecated (as of October 17, 2016).

advertiser_code

string

no

no

"Code"

The custom code for the advertiser.

line_item_id

int

yes

yes

554

The ID of the line item.

line_item_name

string

no

no

"Q1 Pepsi"

The name of the line item.

line_item

string

no

no

"Q1 Pepsi (554)"

Deprecated (as of October 17, 2016).

line_item_code

string

no

no

"Q1 Pepsi Code"

The custom code for the line item.

campaign_id

int

yes

yes

567

The ID of the campaign.

campaign_name

string

no

no

"Photos 728x90"

The name of the campaign.

campaign

string

no

no

"Photos 728x90 (567)"

Deprecated (as of October 17, 2016).

campaign_code

string

no

no

"Photos Code"

The custom code for the campaign.

campaign_priority

int

no

no

5

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

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

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".

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).

publisher_id

int

yes

yes

6787

The number to identify the publisher.

publisher_code

string

no

no

"Publisher Code"

The custom code to the identify the publisher.

publisher_currency

string

yes

yes

"USD"

The currency of the publisher.

pub_rule_id

int

no

no

54

The number to identify the publisher rule.

pub_rule_name

string

no

no

"50% Revshare"

The name of the publisher rule.

pub_rule

string

no

no

"50% Revshare (54)"

Deprecated (as of October 17, 2016).

pub_rule_code

string

no

no

"50% Revshare Code"

The custom code for the publisher rule.

site_id

int

yes

yes

194

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

site_name

string

no

no

"Site Name"

The name of the site.

site

string

no

no

"Site Name (593)"

Deprecated (as of October 17, 2016).

site_code

string

no

no

"Site Name Code"

The custom code for the site.

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.

geo_country

string

yes

yes

"US"

The geographic country code.

geo_country_name

string

no

no

"Unites States"

The name of the country.

size

string

no

no

"300x250"

The size of the creative served.

placement_id

int

yes

yes

546

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

placement_name

string

no

no

"300x250 Business"

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

placement

string

yes

yes

"300x250 Business (546)"

Deprecated (as of October 17, 2016).

placement_code

string

no

no

"300x250 Business Code"

The custom code for the placement.

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

"Kept"

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

buyer_type

string

yes

yes

"Reseller"

The type of buyer, set by AppNexus.

supply_type

string

yes

no

"web"

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

payment_type

string

yes

yes

"cpm", "revshare"

The type of payment to a broker.

revenue_type

string

yes

yes

"CPA"

The basis on which the member gets paid.

revenue_type_id

int

yes

yes

4

The ID of the revenue type. 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.

external_inv_id

int

Yes

Yes

4921

An optional code passed in the query string to further break out inventory. Read more here. Note: For impressions older than 100 days, the external_inv_id will be 0.

external_inv_name

string

No

No

"External Inv Name"

An optional name assigned to the external inventory ID. Read more here.

external_inv

string

No

No

"External Inv Name (4921)"

Deprecated (as of October 17, 2016).

media_type

string

no

no

"Banner", "Pop", "Interstitial", "Video", "Text", "Expandable", "Skin"

The general display style of the creative. You can use the Media Type Service to view the complete list of media types.

media_type_id

int

yes

yes

2

Read-only. The ID of the media type to which the subtype belongs.

adjustment_id

int

yes

yes

890

The ID of the adjustment used to make changes to the media cost and/or impressions, clicks, and conversions you see in reporting for a publisher.

venue

string

yes

yes

"Venue Name"

The name of the cluster of domain, site, tag, and user country that AppNexus' optimization system uses to determine bid valuations. A campaign cannot targeted a venue explicitly.

predict_rev_type

int

yes

yes

2

The optimization phase of a campaign that served on the publisher's inventory. Possible values:
-2 = No predict phase
-1 = Base predict phase
0 = Learn giveup
1 = Learn
2 = Throttled
3 = Optimized
4 = Biased
5 = Optimized 1
8 = Optimized giveup
9 = Base bid below giveup

Metrics

Column

Type

Example

Formula

Description

imps_total

int

2340

imps

The total number of impressions (served and resold).

imps_sold

int

42500

imps_sold

The number of impressions you sold to other members.

imps_default

int

321

imps_default

The number of impressions that defaulted.

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 with a PSA.

imps_psa_error

int

0

imps_psa_error

The number of impressions served with a PSA due to a default error.

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 kept (direct).

imps_resold

int

0

imps_resold

The number of impressions resold.

imps_rtb

int

2332

imps_rtb

The number of rtb impressions.

external_impression

int

0

external_impression

The number of external impressions.

external_click

int

0

external_click

The number of external clicks.

clicks

int

545

clicks

The total number of clicks across all impressions.

click_thru_pct

double

1.12359550561797

(clicks / imps) * 100

The rate of clicks to impressions as a percentage.

total_convs

int

90

post_click_convs + post_view_convs

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

ctr

double

0.2327836

clicks / imps * 100

The rate of clicks to impressions.

convs_rate

double

0.0384413

total_convs / imps * 100

The rate of conversions to impressions.

convs_per_mm

double

221.877080097625

(total_convs / imps) x 1,000,000

The number of conversions per million impressions.

network_revenue

money

1201.13

network_revenue

Network revenue booked through direct advertisers and resold to real time buyers

total_network_rpm

money

2.60548314606741

(network_revenue / imps) x 1000

The network revenue per 1000 impressions.

publisher_revenue

money

400.05

publisher_revenue

The revenue paid out to the publisher (based on revshare or cpm).

publisher_revenue_pub_curr

money

400.05

publisher_revenue

The revenue paid out to the publisher (based on revshare or cpm), in the currency of the publisher.

publisher_rpm_pub_curr

money

1.71

(publisher_revenue / imps) x 1000

The publisher revenue per 1000 impressions, in the currency of the publisher.

network_profit

money

801.08

network_revenue - publisher_revenue

The total net profit for the network.

network_roi

money

  

The return on investment for the network.

network_roi_net_commissions

double

   

network_rpm

money

3.42

(network_revenue / imps) x 1000

The network revenue per 1000 impressions.

sold_network_rpm

double

   

publisher_rpm

money

1.71

(publisher_revenue / imps) x 1000

The publisher revenue per 1000 impressions.

total_publisher_rpm

money

   

sold_publisher_rpm

double

   

network_ppm

money

9.23

(profit / imps) x 1000

The profit per 1000 impressions.

network_revenue_net_commissions

money

   

network_profit_net_commissions

money

   

network_rpm_net_commissions

money

   

network_ppm_net_commissions

money

   

media_cost_pub_curr

money

16.833378

media_cost_pub_curr

The total cost of the inventory purchased, in the currency of the publisher.

commissions

money

0

commissions

Fees that come out of the booked revenue.

serving_fees

money

0.025143

serving_fees

Fees that are added to the media cost.

Column

Type

Example

Formula

Description

imps_viewed

int

30,450

imps_viewed

The number of measured impressions that were viewable per the IAB Viewability definition.

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)

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
  • No labels