Page tree

Skip to end of metadata
Go to start of metadata

Buyer Segment Performance Report

Metrics in this report are affected by the the release of partner fees from September 10 November 12, 2019. For a summary of the changes, see the Partner Fees Breaking Change Notice.

This report provides buyers with segment performance across campaigns and multiple advertisers. 

The report's data is retained for 45 days. The time_granularity of the data is hourly. For instructions on retrieving a report, see the Report Service or the Example.

Impressions across user segments: Since this report aggregates impressions served by user segment, impressions associated with users who are present in multiple segments will be counted more than once. As a result, be sure to group by segment_id when running the report.

On This Page

Time Frame

The report_intervalfield in the JSON request must be set to one of the following:

  • today
  • yesterday
  • last_7_days
  • last_14_days
  • last_30_days

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.

Dimensions

Column

Type

Group?

Filter?

Examples

Description

month

time

no

no

"2010-02"

The month of the auction.

day

date

yes

yes

"2010-02-01"

The day of the auction.

hour

time

yes

no

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

The hour of the auction.

insertion_order_id

int

yes

yes

321

The ID of the insertion order. If the value is 0, the impression was purchased by a third-party buyer.

campaign_id

int

yes

yes

222

The ID of the campaign that purchased the impression.

campaign_name

string

no

no

"Fall Wares"

The name of the campaign that purchased the impression.

campaign

string

no

no

"Fall Wares (222)"

Deprecated.

advertiser_id

int

yes

yes

789

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

line_item_id

int

yes

yes

111

The ID of the line item. If the value is 0, the impression was purchased by a third-party buyer.

advertiser_name

string

no

no

"Amco"

The name of the advertiser.

advertiser

string

no

no

"Amco (789)"

Deprecated.

line_item_name

string

no

no

"Kitchen"

The name of the line item.

line_item

string

no

no

"Kitchen (111)"

Deprecated.

split_idintnoyes342The ID of the split that purchased the impressions in this data set. Splits are only applicable to augmented line items. For any reports that contain campaigns, the split_id (if included) will be null.
split_namestringnoyes"Mobile Split A"The name of the split that purchased the impressions in this data set. Splits are only applicable to augmented line items. For any reports that contain campaigns, the split_name (if included) will be null.

campaign_code

string

 

no

"Mobile Campaign Code"

The custom code for the campaign.

segment_id

int

yes

yes

220

The ID of the segment pixel.

segment_name

string

no

no

"Submitted application"

The name of the segment.

segment

 

string

no

no

"Submitted application (220)"

Deprecated.

insertion_order_name

string

no

no

"Mobile Insertion Order"

The name of the insertion order.

insertion_order

string

no

no

"Mobile Insertion Order (321)"

Deprecated.

segment_code

string

no

no

"Mobile Insertion Order Code"

The (optional) custom code associated with the user segment present for this impression.

pixel_idintyesyes1942The unique identification number of the conversion pixel.

Note: This dimension will return a maximum of 10 conversion pixels. Also, you can filter by no more than 10 conversion pixels. Although pixel_id is groupable, we do not recommend that you group by this dimension since doing so will cause conversion events to then be shown in separate rows from impression and click events. We generally assume you want to view all of these events in a single row so as to be able to retrieve accurate and aggregated values for conversion rate and cost-per-conversion calculations. As a result, we instead recommend that you filter by pixel_id so you can retrieve conversion counts and related metrics for your most relevant pixel ids.

genderstringyesyes"m", "f", "u"The gender of the user. Note: For impressions older than 100 days, the gender will be "u"
age_bucketstringyesyes"18-24, "45-54"The age bucket in which the user is contained. See Age Bucket below for more information.
age_bucket_idintyesyes1, 3, 0The ID of the age bucket. See Age Bucket below for more information.

Age Bucket

Bucket IDBucket Name
0
"unknown"
1
"13-17"
2
"18-24"
3
"25-34"
4
"35-44"
5
"45-54"
6
"55-64"
7
"65+"

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

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.

booked_revenue

money

450.00

post_view_revenue + post_click_revenue

The total revenue booked through direct advertisers.

post_view_convs

int

15post_view_convsThe number of post-view conversions.

post_view_revenue

money

150.00post_view_revenue

Advertiser revenue from post-view conversions.

post_click_convs

int

10post_click_convs

The number of post-click conversions that occurred.

post_click_revenue

money

300.00

post_click_revenue

Advertiser revenue from post-click conversions.

post_view_convs_rate

double

0.00013

post_view_convs / imps

The rate of post-view conversions to impressions.

post_click_convs_rate

double

0.0002

post_click_convs / imps

The rate of post-click conversions to impressions.

spend

money

304.36

spend 

The total marketer spend across both direct and real time media buys for this segment.

media_cost

money

100.00

media_cost

The total cost of the inventory purchased.

cpm

money

5.00

media_cost / imps * 1000

The cost per thousand impressions.

revenue_ecpm

money

1.9221

(booked_revenue / impressions) x 1000

The total revenue per 1000 impressions.

profit

money

4.14

During the breaking change period: booked_revenue - media_cost 
After the breaking change period: booked_revenue - total_cost

During the breaking change period: Booked revenue minus media cost. 
After the breaking change period: Booked revenue minus total cost.

profit_ecpm

money

0.4949

During the breaking change period: (booked_revenue - media_cost) / imps * 1000
After the breaking change period: (booked_revenue - total_cost)/imps * 1,000

During the breaking change period: The profit (defined as booked revenue minus media cost) per 1,000 impressions.
After the breaking change period: The profit (defined as booked revenue minus total cost) per 1,000 impressions.

revenue_ecpc

money

0.8256

booked_revenue / clicks

The total revenue per click.

revenue_ecpa

money

5.00

booked_revenue / total_convs

The total revenue per conversion.

cost_ecpc

money

0.1834

media_cost / clicks

The cost per click.

cost_ecpa

money

1.1111

media_cost / total_convs

The cost per acquisition/conversion.

commissions

money

0

During the breaking change period: commissions for standard line items, commissions + equivalent partner_fees for ALIs.  
After the breaking change period:
Commissions for standard line items, $0 for ALIs. Commissions created on ALIs prior to this date will be automatically migrated to partner_fees. Previous data will not be impacted.

Fees that come out of the booked revenue.

During the breaking change period: Commissions for standard line items, commissions + equivalent partner fees for ALIs.
After the breaking change period: Commissions for standard line items, $0 for ALIs. Commissions created on ALIs prior to this date will be automatically migrated to partner fees. Previous data will not be impacted.

serving_fees

money

0.025143

During the breaking change period: serving fees for standard line items, serving fees + equivalent partner_fees for ALIs.
 After the breaking change period: Serving fees for standard line items, $0 for ALIs. Serving fees created on ALIs prior to this date will be automatically migrated to partner_fees. Previous data will not be impacted.

Fees that are added to the media cost.

During the breaking change period: Serving fees for standard line items, serving fees + equivalent partner_fees for ALIs.
After the breaking change period: Serving fees for standard line items, $0 for ALIs. Serving fees created on ALIs prior to this date will be automatically migrated to partner_fees. Previous data will not be impacted.

convs_per_mm

double

384.4

(total_convs / imps) * 1,000,000

The number of conversions per million impressions.

partner_feesmoney123.45 The total amount of third-party costs, budgeted using the Partner Fee Service, that have accrued on an augmented line item over the reported period of time.
total_costmoney123.45

total_cost = media_cost + data_costs + partner_fees + commissions + serving_fees + publisher_revenue



The total amount of costs accrued over the reported period of time. This generally includes two types of costs, budgeted costs (media cost, data cost, partner fees, serving fees, commissions) and publisher revenue if you track publisher payouts on the platform.

Note: We have added logic to prevent double counting third-party fees during the breaking change period (August 6-After the breaking change period).

total_cost_ecpmmoney123.45(total_cost/imps) * 1,000The total cost per 1,000 imps.
total_cost_ecpcmoney123.45total_cost/clicksThe total cost per click.
total_cost_ecpamoney123.45total_cost/conversionsThe total cost per conversion.
profit_ecpcmoney123.45

(booked_revenue - total_cost)/clicks

Profit per click.

profit_ecpamoney123.45

(booked_revenue - total_cost)/conversions

 Profit per conversion.

profit_marginmoney123.45

(booked_revenue - total_cost)/booked_revenue

Buyer profit margin.

video_skipsint10

The total number of times a user skipped the video. Use this metric for reporting when buying skippable inventory.

video_startsint11

The total number of times the first segment of the video creative was downloaded and started.

video_25_pctsint10

The total number of times the video creatives completed 25% of the entire duration.

video_50_pctsint10

The total number of times the video creatives completed 50% of the entire duration.

video_75_pctsint10

The total number of times the video creatives completed 75% of the entire duration.

video_completionsint12

The total number of times the video creatives played for the entire duration.

video_servedint10

The total number of video responses served to the player.An ad response occurs when the VAST document (XML) is served in response to a request.An ad response doesn't necessarily indicate a successful impression. For an impression, the first frame of the video must be served.

video_errorsint2

The total number of times a video error occurred.

revenue_per_video_completemoney

25.76


The revenue per video completion.

cost_per_video_completemoney22.76

The cost per video completion.

video_completion_rate

double

1.12359550561797%

(video completions/total impressions) x 100

The ratio of video completions to impressions, expressed as a percentage.
video_start_rate

double

1.12359550561797%


The percentage of times the first segment of the video creative was downloaded and started.
video_skip_rate

double

1.12359550561797%


The percentage of times the user opted to skip the video.

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