Skip to end of metadata
Go to start of metadata

Network Audio Analytics Report

The Network Audio Analytics report can be used to view audio event metrics for a network member. 

For instructions on retrieving a report, see 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:

  • last_available_day
  • today
  • last_24_hours
  • yesterday
  • last_48_hours
  • last_7_days
  • last_14_days
  • last_7_available_days
  • last_14_available_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?

Example

Description

hour

time

Yes

Yes

"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

time

Yes

Yes

"2010-02-01"

The day of the auction.

month

time

Yes

No

"2010-02"

The month of the auction.

buyer_member_id

int

Yes

Yes

123

The ID of the buying member. If the impression was not purchased, this field shows one of the following values: 229 = PSA, 0 = Blank, or 319 = Default.

buyer_member_name

string

No

No

"My Network"

The name of the buying member.

buyer_member

string

No

No

"My Network (123)"

Deprecated (as of October 17, 2016).

creative_id

int

Yes

Yes

554

The ID of the creative. Note:

  • For external click or impression trackers, creative_id will be "External Clicks" or "External Imps".

creative_name

string

No

No

"Q1 2010 728x90"

The name of the creative. Note:

  • For external click or impression trackers, creative_name will be "External Clicks" or "External Imps".

creative

string

No

No

"Q1 2010 728x90 (554)"

Deprecated (as of October 17, 2016).

member_idintYesYes767The ID of the member.

seller_member_id

int

Yes

Yes

456

The ID of the selling member.

seller_member_name

string

No

No

"That Seller"

The name of the selling member.

seller_member

string

No

No

"That Seller (456)"

Deprecated (as of October 17, 2016).

advertiser_id

int

Yes

Yes

789

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

advertiser_name

string

No

No

"Verizon Wireless"

The name of the advertiser.

advertiser

string

Yes

No

"Verizon Wireless (789)"

Deprecated (as of October 17, 2016).

advertiser_currency

string

Yes

Yes

"USD"

The currency of the advertiser.

publisher_id

int

Yes

Yes

321

The ID of the publisher.

publisher_name

string

No

No

"Facebook"

The name of the publisher.

publisher

string

Yes

No

"Facebook (321)"

Deprecated (as of October 17, 2016).

publisher_currency

string

Yes

Yes

"USD"

The currency of the publisher.

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

Yes

No

"Site Name (194)"

Deprecated (as of October 17, 2016).

placement_id

int

Yes

Yes

456

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

"Ivillage 160x600"

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_code

string

No

No

"Ivillage Code"

The custom code for the placement.

insertion_order_id

int

Yes

Yes

321

The ID of the insertion order.

insertion_order_name

string

No

No

"Insertion Order"

The name of the insertion order.

insertion_order

string

Yes

No

"Insertion Order (321)"

Deprecated (as of October 17, 2016).

line_item_id

int

Yes

Yes

111

The ID of the line item.

line_item_name

string

No

No

"Default Line Item"

The name of the line item.

line_item

string

Yes

No

"Default Line Item (111)"

Deprecated (as of October 17, 2016).

line_item_code

string

No

No

"Default Line Item Code"

The custom code for the line item.

campaign_id

int

Yes

Yes

222

The ID of the campaign.

campaign_name

string

No

No

"Default Campaign"

The name of the campaign.

campaign

string

Yes

No

"Default Campaign (222)"

Deprecated (as of October 17, 2016).

size

string

Yes

Yes

"728x90"

The size of the placement/creative served.

brand_id

int

Yes

Tes

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

geo_country

string

Yes

Yes

"US"

The code for the geographic country.

geo_country_name

string

No

No

"United States"

The name of the geographic country.

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

trafficker_for_insertion_order

string

Yes

Yes

"Maurice Truman"

The trafficker for the insertion order. See the "labels" field in the Insertion Order Service for more details.

salesrep_for_insertion_order

string

Yes

Yes

"Beverly Heller"

The sales rep for the insertion order. See the "labels" field in the Insertion Order Service for more details.

creative_recency_bucket_id

string

no

no

"4"

The ID of the creative recency bucket. See Creative Recency Buckets below for possible values.

creative_recency_bucket

string

yes

yes

"15-30 minutes"

The bucket for how recently the creative was displayed. See Creative Recency Buckets  below for possible values.

creative_frequency_bucket

string

yes

yes

"11-20"

The bucket for how frequently the creative was displayed. See Creative Frequency Buckets  below for possible values.

creative_frequency_bucket_id

string

no

no

"3"

The ID of the creative frequency bucket. See Creative Frequency Buckets below for possible values.

site_domain

string

yes

no

bestsiteever.com

The site domain of an impression.

application_idstringYesYes

'343200656' (iOS) or

'com.rovio.angrybirds'

(Android)

A targetable Apple App Store ID, Google Play package name, or Windows application ID.

supply_typestringYesYesmobile_webThe seller-classified channel to denominate supply in terms of web, mobile-optimized web, and mobile app impressions. Possible values are 'web', 'mobile_app', and 'mobile_web'.
video_playback_methodstringYesYes"1"

The playback method for the creative. See Playback Method below for possible values.

video_contextstringYesYes"3"The type of the video creative. See Video Context below for possible values.
video_player_size_idstringYesYes"2"The ID of the video player width. See Player Size below for possible values.

Metrics

Column

Type

Example

Formula

Description

imps

int

2340

imps

The total number of impressions (served and resold).

clicks

int

1

clicks

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.

profit

money

0.084102

revenue - cost

The total network revenue minus network 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.000221877080097626

clicks / imps

The rate of clicks to impressions.

rpm

money

2.60548314606741

(revenue / imps) x 1000

The revenue per 1000 impressions.

rpm_including_fees

money

2.60548314606741

(revenue_including_fees / imps) x 1000

The revenue minus commissions per 1000 impressions.

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

ppm_including_fees

money

0.662460674157303

(profit_including_fees / imps) x 1000

The profit including additional fees per 1000 impressions.

cpm_including_feesmoney2.60548314606741(cost_including_fees / imps) x 1000The cost including additional fees per 1000 impressions.
errorsint5errorsThe total number of times an error occurred.
startsint360startsThe total number of times the first segment of the video creative was downloaded and started.
start_ratedouble25.85starts / impsThe number of video starts divided by the number of impressions.
skipsint20skipsThe total number of times a user skipped the video.
skip_ratedouble20.5skips / impsThe number of video skips divided by the number of impressions.
25_pctsint78025% completeThe total number of times the video creatives completed 25% of the entire duration.
50_pctsint65450% completeThe total number of times the video completed 50% of the entire duration of time.
75_pctsint56775% completeThe total number of times the video completed 75% of the entire duration of time.
completionsint989100% completeThe total number of times the video played for the entire duration of time.
completion_ratedouble85.45completions / impsThe number of video completions divided by the number of impressions.
revenue_per_video_completedouble15.869revenue / completionsThe revenue per video completion.
cost_per_video_completedouble2.056cost / completionsThe cost per video completion.
servedint87649video impressions served

The total number of video impressions served.

An  Imp  refers to when the video player loads the video and starts the first frame.  Videos Served  refers to the  VAST  document being served in response to a request from the video player.

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 2 consecutive seconds.

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)

 

Creative Frequency Buckets

Bucket ID

Bucket Name

-2

"no-cookie-date

-1

"no-cookie"

0

"0"

1

1"

2

"2-5"

3

"6-10"

4

"11-20"

5

"21-40"

6

"41-60

7

"61-100"

8

"101-150"

9

"151-250"

10

"251-500"

11

"500+"


Creative Recency Buckets

Bucket ID

Bucket Name

-2

"no-cookie-date

-1

"no-cookie"

0

"< 1 minute"

1

"1-5 minutes"

2

"5-15 minutes"

3

"15-30 minutes"

4

"30-60 minutes"

5

"1-4 hours"

6

"4-12 hours"

7

"12-24 hours"

8

"1-2 days"

9

"2-7 days"

10

"8-14 days"

11

"14-30 days"

Video Playback Method

Method ID

Method

0

Unknown

1Auto-play, sound on

2

Auto-play, sound off

3

Click-to-play

4

Mouse-over

5

Auto-play, sound unknown

Video Context 

Method ID

Method

0

Unknown

1

Pre-roll

2

Mid-roll

3

Post-roll

4

Outstream

Player Size

ID

Name

0

small

1

medium

2

large

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