Skip to end of metadata
Go to start of metadata

Publisher Brand Review Report

This report provides a view of brand performance across a specific publisher's inventory. This report is available to both network and publisher users. You can: 

  • review what creative has served on your inventory under a specific publisher and how it performed.
  • review creative performance by audit status.

This report requires that a publisher ID be specified as part of the URL as follows:

The time_granularity of the data is dailyFor instructions on retrieving a report, see the 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:

  • yesterday
  • last_7_days
  • last_30_days
  • month_to_date
  • last_month

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

Data in this report is retained for 14 months.

Dimensions

Column

Type

Group?

Filter?

Example

Description

month

time

no

no

"2010-02"

The month of the auction.

day

time

yes

no

"2010-02-01"

The day of the auction.

placement_id

int

yes

yes

546

The ID of the placement.

placement_name

string

no

no

"300x250 Business"

The name of the placement.

placement

string

no

no

"300x250 Business (546)"

Deprecated (as of October 17, 2016).

geo_country

string

yes

yes

"US" 

geo_country_name

string

nono"United States"The name of the geographical country.

imp_type

string

yesyes"Kept"The type of impressions. For possible values see imp_type_id.

imp_type_id

int

no

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.

creative_id

int

yes

yes

654

The ID of the creative.

site_id

int

yes

yes

555The ID of the site. For more information, see the Site Service.

site_name

string

no

no

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

brand_id

int

yes

yes

3

The ID of the brand associated with a creative served on the publisher's inventory.

brand_name

string

no

no

"Ace Hardware"

The name of the brand associated with a creative served on the publisher's inventory.

brand

string

nono"Ace Hardware (3)"

Deprecated (as of October 17, 2016).

width

int

yes

yes

250

The width of the creative.

height

int

yes

yes

300

The height of the creative.

site

string

no

no

"My Site (555)"

Deprecated (as of October 17, 2016).

site_code

string

no

no

"Site Name Code"

The custom code for the site.

placement_code

string

no

no

"Photos Code"

The custom code for the placement.

media_type

string

yesyes

 

"Banner", "Pop", "Interstitial", "Video", "Text"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.

mediatype_id

int

no

yes

444The ID of the media type associated with the creative that was served. For more information, see the Media Type Service.

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_code

string

no

no

"Custom code"The custom code for the deal.

brand_offer_category_id

int

yes

yes

1256The ID of the brand offer category associated with the impression. See category_id in the Brand Service page.

brand_offer_category_name

string

no

no

"Luxury Cars"The name of the brand offer category associated with the impression. See category_id in the Brand Service page.

creative_audit_status_id

int

no

yes

0The ID of the audit status of the creative associated with the impression:
  • 0 = unaudited
  • 1 = seller audited only
  • 2 = appnexus audited

creative_audit_status

string

yes

no

"Unaudited"The audit status of the creative associated with the impression:
  • "Unaudited"
  • "Self Audit Only"
  • "AppNexus Audited"
sizestringyesyes"728x90"The width and height of the creative associated with the impression.

Metrics

Column

Type

ExampleFormula

Description

imps

int

34534imps

The total number of impressions (including defaults).

clicks

int

345clicks

The total number of clicks across all impressions.

total_convs

int

205total_convsThe total number of post view and post click conversions.

convs_rate

double

0.000856total_convs / imps

The rate of conversions to impressions.

ctr

double

0.002327clicks / impsThe rate of clicks to impressions.

publisher_revenue

money

400.05publisher_revenueThe revenue paid out to the publisher (based on revshare or CPM).

publisher_rpm

money

1.71

(publisher_revenue / imps) x 1000

The publisher revenue per 1000 impressions.

convs_per_mm

double

221.877080097625

(total_convs / imps) x 1,000,000

The number of conversions per million impressions.

Example

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

Related Topics

Report Service

  • No labels