Skip to end of metadata
Go to start of metadata

Seller Brand Review Report

This report provides a view of brand performance across all of your inventory. You can:

  • review what creative has served on your inventory and how it performed.
  • review creative performance by audit status.
  • review client brand category performance across all of your inventory.

The time_granularity of the data is daily. For 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 must 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.

buyer_member_id

int

yes

yes

643

The ID of the member that won the auction.

placement_id

int

no

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

publisher_id

int

yes

yes

6787

The ID of the publisher.

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.

imp_type

string

yes

yes

"Kept"

Deprecated (as of October 17, 2016).

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

no

no

"Ace Hardware (3)"

Deprecated (as of October 17, 2016).

payment_type

string

yes

yes

"cpm"

The type of payment to the broker.

revenue_type

string

yes

no

"cpm"

The way the advertiser has agreed to pay you.

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

publisher_code

string

no

no

"My Publisher Code"

The custom code for the publisher.

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.

buyer_member_name

string

no

no

"Network"

The ID of the buying member.

buyer_member

string

no

no

"Network (567)"

Deprecated (as of October 17, 2016).

media_type

string

yes

yes

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

publisher_name

string

no

no

"LOL - US"

The name of the publisher on whose site the impression occurred.

publisher

string

no

yes

"LOL - US (44389)"

Deprecated (as of October 17, 2016).

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

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

"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

0

The 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

Example

Formula

Description

imps

int

34534imps

The total number of impressions (including defaults).

clicks

int

345clicks

The total number of clicks across all impressions.

cost

money

16.833378

cost

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

revenue

money

25.767257

booked_revenue + reseller_revenue

The sum of booked revenue and reseller revenue.

booked_revenue

money

25.767257

booked_revenue

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

reseller_revenue

money

0

reseller_revenue

The total revenue on resold impressions through direct publishers.

profit

money

970.40

revenue - media_cost

The total revenue minus the cost.

cpm

money

1.66051685393258

(cost / imps) x 1000

The cost per 1000 impressions.

total_convs

int

5

total_convs

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

convs_rate

double

0.000221877080097626

total_convs / imps

The rate of conversions to impressions.

ctr

double

0.002327clicks / imps

The rate of clicks to impressions.

rpm

money

2.60548314606741

(revenue / imps) x 1000

The revenue per 1000 impressions.

ppm

money

0.944966292134831

(profit / imps) x 1000

The profit per 1000 impressions.

convs_per_mm

double

221.877080097625

(total_convs / imps) x 1,000,000

The number of conversions per million impressions.

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_measurable_rate

double

45%

view_measurable_rate

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

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

  • No labels