type AdBreak (v202508)

Contains debugging information for a single ad break in a stream.


Namespace
https://www.google.com/apis/ads/publisher/v202508

Field

rootAdResponses

AdResponse[]

The root ad responses to the adRequest. If this is a staged request, there may be two root ad responses - one for the prefetch stage and another if there is a follow up request at the ad break.

A VAST redirect response triggers another ad request (that is not recorded), and thus a response for that request, which is why there can be multiple ad responses nested within an ad response.

For more information, see https://support.google.com/admanager/answer/7009058

adDecisionCreatives

AdDecisionCreative[]

Contains information about the creatives that were served in the ad break, such as the ad system that served them and whether they were transcoded by Truman already.

podNum

xsd:int

1-based index of this pod within the whole stream.

linearAbsolutePodNum

xsd:int

Pod number of the ad break, for "ad break specific" records like AdRequest, AdResponse, AdDecision, etc. This field is only used for Linear streams.

adBreakDurationMillis

xsd:long

The duration in milliseconds of the entire ad break, from when content stops playing until it resumes.

filledDurationMillis

xsd:long

The sum of the durations in milliseconds of the ads within this ad break.

If the ad break is 60 seconds and two 25 second ads are returned in an ad response the filled time would be 50000 milliseconds.

servedDurationMillis

xsd:long

The amount of ad time in milliseconds a user actually sees.

If the ad break is 60 seconds and two 25 second ads are returned but one of these ads wasn't transcoded so a slate was used, the served time would be 25 seconds.

startDateTime

DateTime

The date and time this ad break started (the time the ad request was made).

startTimeOffsetMillis

xsd:long

The offset of the ad break within the content in milliseconds. Used for VOD sessions only.

samError

SamError

Any error that occurred while attempting to stitch the ad break into the stream.

midrollIndex

xsd:int

For break type MIDROLL, the 1-based index of the mid-roll position. Only applies to VOD VMAP ad breaks.

decisionedAds

xsd:boolean

Whether ads were decisioned for this ad break.

trackingEvents

TrackingEvent[]

The list of tracking events associated with this ad break.