Skip to end of metadata
Go to start of metadata

Publisher Analytics

The Publisher Analytics report can be used to view revenue and profit data across a specific publisher's sites and placements. This report is available to both network and publisher users.

For instructions on retrieving a report, see the Report Service or the Examples below. This report requires that a publisher ID be specified as part of the URL as follows:

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

Dimensions

Column

Type

Group?

Filter?

Example

Description

hour

time

yes

no

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

The hour of the auction. Note that, 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.

publisher_id

int

yes

yes

923

The ID of the publisher.

publisher_code

string

no

no

"My Publisher Code"

The custom code for the publisher.

publisher_currency

string

no

no

"USD"

The currency of the publisher.

pub_rule_id

int

yes

yes

736

The ID of the publisher rule.

pub_rule_name

string

no

no

"My Publisher Rule"

The name of the publisher rule.

pub_rule

string

no

no

"My Publisher Rule (736)"

Deprecated (as of October 17, 2016).

pub_rule_code

string

no

no

"My Publisher Rule Code"

 

seller_member_id

int

yes

yes

456

The ID of the selling member.

geo_country

string

yes

yes

"US"

The code of the geographical country.

geo_country_name

string

no

no

"United States"

The name of the geographical country.

size

string

yes

yes

"728x90"

The size of the placement/creative served.

placement_id

int

yes

yes

546

The ID of the placement. Note that, 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 that, for impressions older than 100 days, placements will be aggregated into one row with "All placement data older than 100 days" as theplacement_name.

placement

string

no

no

"Photos 728x90 (567)"

Deprecated (as of October 17, 2016).

placement_code

string

no

no

"Photos Code"

 

deal_id

int

Yes

Yes

2345

The ID of the deal. For more information about deals you have negotiated with buyers, see Deal 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"Custom code"The custom code for the deal.

brand_id

int

yes

yes

3

The ID of the brand associated with a creative served on the publisher's inventory. For imp_type_id = 6, no information is available in the brand_id field for this report. See the Publisher Brand Review Report instead.

brand_name

string

no

no

"Ace Hardware"

The name of the brand associated with a creative served on the publisher's inventory. For imp_type_id = 6, no information is available in the brand_name field for this report. See the Publisher Brand Review Report instead.

brand

string

no

no

"Ace Hardware (3)"

Deprecated (as of October 17, 2016).

supply_type

string

yes

no

 

The type of inventory. Possible values:

  • "web"
  • "mobile_web"
  • "mobile_app"

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

name

yes

yes

"Kept"

The type of impressions. For possible values see imp_type_id.

media_type

string

no

no

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

The general display style of a creative served on the publisher's inventory. You can use the Media Type Service to view the complete list of media types.

adjustment_id

int

yes

yes

22

The ID of an adjustment you have set using the Adjustment Service. Networks use adjustments to help display their actual revenue in Console reporting. For more information, see Adjustments (Customer login required).

site_idintyesyes555The ID of the site. For more information, see the Site Service.
site_namestringnoyes"My Site"The name of the site. For more information, see the Site Service .

site

stringnoyes"My Site (555)"

Deprecated (as of October 17, 2016).

venuestringyesyes"Venue 55"The word Venue followed by the ID of the inventory's associated venue. For more information on venues, see What is a Venue? (Customer login required).
mediatype_idintyesyes444The ID of the media type associated with the creative that was served. For more information, see the Media Type Service .

Metrics

Column

Type

Example

Formula

Description

imps_total

int

234223

imps

The total number of impressions (including defaults).

imps_sold

int

234123

imps_sold

The total number of impressions sold to direct and real-time advertisers.

imps_default

int

100

imps_default

The total number of impressions not sold (default creative served).

imps_blank

int

12

imps_blank

The number of impressions which were served with a blank.

imps_psa

int

10

imps_psa

The number of impressions which were served with a PSA.

imps_default_error

int

3

imps_default_error

The number of impressions which defaulted due to a timeout error.

imps_default_bidder

int

5

imps_default_bidder

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

imps_kept

int

405

imps_kept

The number of impressions your advertiser purchased from your publisher.

imps_resold

int

506

imps_resold

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

imps_rtb

int

94

imps_rtb

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

imps_filled

int

4900

imps_filled

The number of blank, PSA, default, kept, resold, and external 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.

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_pub_curr

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

publisher_filled_revenue

money

350.02

publisher_filled_revenue

The revenue paid out to the publisher (based on revshare or CPM) for filled impressions.

publisher_filled_revenue_publisher_curr

money

350.02

publisher_filled_revenue

The revenue paid out to the publisher (based on revshare or CPM) for filled impressions, in the currency of the publisher.

publisher_default_revenue

money

350.02

publisher_default_revenue

The revenue paid out to the publisher (based on revshare or CPM) for default impressions.

publisher_default_revenue_publisher_curr

money

350.02

publisher_default_revenue

The revenue paid out to the publisher (based on revshare or CPM) for default impressions, in the currency of the publisher.

total_convs

int

205

total_convs

The total number of post view and post click conversions.

ctr

double

0.002327

clicks / imps

The rate of clicks to impressions.

click_thru_pct

double

1.12359550561797

(clicks / imps) * 100

The rate of clicks to impressions as a percentage.

convs_rate

double

0.000856

total_convs / imps

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.

publisher_rpm

money

1.71

(publisher_revenue / imps) x 1000

The publisher revenue per 1000 impressions.

publisher_rpm_pub_curr

money

1.71

(publisher_revenue / imps) x 1000

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

publisher_filled_rpm

money

 

(publisher_revenue / imps_filled) x 1000

The publisher revenue per 1000 filled impressions.

publisher_filled_rpm_publisher_currency

money

 

(publisher_revenue / imps_filled) x 1000

The publisher revenue per 1000 filled impressions, in the publisher's currency.

publisher_default_rpm

money

1.71

(publisher_revenue / imps_default) x 1000

The publisher revenue per 1000 default impressions.

publisher_default_rpm_publisher_curr

money

1.71

(publisher_revenue / imps_default) x 1000

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

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)

Age Buckets

Bucket ID

Bucket Name

0

"unknown"

1

"13-17"

2

"18-24"

3

"25-34"

4

"35-44"

5

"45-54"

6

"'55-64"

7

"65+"

Examples

Step 1. Prepare your report request
Step 2. POST the request JSON to the report service
Step 3. Check the status of your request
Step 4. Download your data
  • No labels