Ad Pods Video (β)

Description

Ad Pods Video is an ad format that combines multiple video banners into a single ad unit for sequential playback in a specific ad position (pre-roll, mid-roll, and others). Similar to TV ads, videos play one after the other. The format is suitable for any types of video banners.

Adfox displays several video banners in a single ad request. The number of banners in an ad unit is unlimited and only determined by the ad duration specified in the request.

For smooth playback, this format requires a player that supports VAST 3.0.

How video banners are served

Example of playing back video banners in Ad Pods Video format:

Format advantages

  • Banners from different ad campaigns are served in a single ad unit.
  • With a single request, Adfox can display multiple video banners.

  • The order of video banners in the unit depends on the levels, priorities, and targetings at both the campaign and banner levels.

  • Each banner is assigned a unique labeling token. You can submit data to the state register in a standard way: under the agreement with the end advertiser linked to the campaign.

  • Preset reports include statistics on video banner positions in Ad Pods.

How are ads served in the Ad Pods Video format?

The duration of an Ad Pods Video impression is specified in the ad request's adtt parameter. If this parameter is passed, the number of displayed banners matches the number that the master banner can fit based on its duration. If not passed, a single banner is served.

The display order of the publisher and monetizer's campaigns is based on their assigned levels and priorities.

Sample content of a 100-second Ad Pods Video (adtt=100) targeting users in Moscow:

Adding Ad Pods Video banners in Adfox

In Ad Pods Video, you can either display banners from custom campaigns or add external monetizers to your inventory through Adfox. The way banners are added depends on your role:

Step 1. Select a placement and place campaigns with the Direct sale profile

Select or create a placement where you want to serve multiple video banners in Ad Pods format. Place a Guarantee, Dynamic Monetization, or Promo campaign with the Direct sale profile there.

Step 2. Create a campaign to generate Ad Pods Video banners

  1. Create a Guarantee campaign with the Ad Pods Video profile to combine multiple videos into a single VAST response.

  2. Under Placement, select a placement: this will automatically generate a banner combining several videos from campaigns with the Direct sale and Ad Pods Video Bidder profiles. Save the campaign.

Step 3. Enable an external monetizer (optional)

  1. Create a Guarantee or Dynamic Monetization campaign with the Ad Pods Video Bidder campaign profile.

  2. In the ID of the monetizer in Adfox field, specify the monetizer ID.

  3. If necessary, define the campaign level under Rotation.

  4. Place your campaign on the selected placement and save it.

  5. In the campaign settings, go to Banners and click Create.

  6. Select the Video Advertising or Video Advertising App banner format, a custom or preset banner type, and the Ad Pods Video Bidder template.

  7. In the banner settings form, add the Transition URL to the monetizer account. Once added, you'll see fields with parameters from the URL. You can also set additional banner parameters.

  8. You can specify a CPM that will be used in dynamic monetization for the monetization platform's campaigns that don't have their own CPM.

  9. Click Save.

Note

You can add multiple campaigns with the Ad Pods Video Bidder profile for a single monetizer, provided that they are served on different placements.

Step 1. Select a placement and place campaigns with the Direct sale profile

Select or create a placement where you want to serve multiple video banners in Ad Pods format. Place Guarantee and Dynamic Monetization campaigns with the Direct sale profile there.

Step 2. Create a campaign to place ads using the publisher's inventory

  1. Create a Guarantee campaign with the Ad Pods Video Bidding profile to combine multiple videos into a single VAST response.

  2. Under Placement, select a placement: this will automatically generate a banner combining several videos from campaigns with the Direct sale profile. Save the campaign.

  3. Get the ad tag from the placement and send it to the publisher to be added to the campaign with the Ad Pods Video Bidder profile.

Sample link between a site's inventory and publisher and monetizer campaigns:

Conditions for using the Ad Pods Video format

An Ad Pods Video banner will be created if:

  1. A Guarantee campaign with the Ad Pods Video profile is served on the placement.

  2. The ad request specifies the duration passed in the adtt parameter as an integer value.

  3. In the banner settings, Video duration, sec is set to at least five seconds.

Ad Pods Video banners will include ads from an Adfox monetizer if:

  1. Guarantee or Dynamic Monetization campaigns with the Ad Pods Video Bidder profile are served on the placement.

    Which monetizer campaigns can be added
    Publisher's campaign Available monetizer campaigns
    Guarantee campaign with the Ad Pods Video Bidder profile Any Guarantee campaigns with the Direct sale profile
    Dynamic Monetization campaign with the Ad Pods Video Bidder profile Guarantee and Dynamic Monetization campaigns with the Direct sale profile and a specified CPM floor
    Dynamic Monetization with the Ad Pods Video Bidder profile and a specified CPM Any Guarantee and  Dynamic Monetization campaign with the Direct sale profile. Guarantee campaigns with the Direct sale profile and a specified CPM floor override the CPM of the publisher's Ad Pods Video Bidder campaign
  2. The monetizer information is specified in the campaign with the Ad Pods Video Bidder profile and the banner settings.

  3. There are suitable Guarantee and  Dynamic Monetization campaigns in the Adfox monetizer account.

  4. A Guarantee campaign with the Ad Pods Video Bidding profile is added to the Adfox monetizer account and served on placements where a response containing multiple videos is to be received.

  5. In the Adfox monetizer banner settings, Video duration, sec is set to at least five seconds.

XML code

For placements created with XML banner types, links for getting XML codes are generated in the Adfox interface.

Example of a link for getting XML code:

https://yandex.com/ads/adfox/166283/getCode?p1=xxx&p2=xxx

If your placement hosts a campaign with Ad Pods Video, you'll see additional links in the interface:

Example of a link for getting Ad Pods Video (Web):

https://yandex.com/ads/adfox/166283/getCode?mvast-format=json&p1=xxx&p2=xxx&adtt=120&vitrina-platform=web&vitrina-sdk-version={{1.1.23}​}
Request parameters

User parameters:

  • adtt: Maximum Ad Pods Video unit duration in seconds (it can also be specified in the Duration field).
  • vitrina-platform: User environment (web, mobile_web, android, androidtv, ios, tvos, webos, tizen, vidaa).
  • vitrina-sdk-version={{SDK_VERSION}​}: Vitrina TV SDK version. {{SDK_VERSION}​}: Vitrina TV macro for passing the SDK version.

Example of a link for getting Ad Pods Video (App, SmartTV):

https://adsdk.yandex.com/v3/get_vast/1234567/getCode?mvast-format=json&adfox=true&os_name=iOS&os_version=16.5&partner=adfox&partner_group=vitrina_tv&vast_impression_tracking_mode=first_quartile&app_id=12345&app_version_name=2.0&adtt=120&device_type=tablet&idfa=F4SX1&&p1=xxx&p2=xxx&puid1=&vitrina-platform=ios&vitrina-sdk-version={{1.1.23}​}
Request parameters

User parameters:

  • os_name: Name of the operating system (android, iOS).
  • os_version: Version of the operating system.
  • device_type: Device type (phone, tablet, tv).
  • app_id: Unique ID of the app (Application ID).
  • app_version_name: Name of the app version.
  • adtt: Maximum Ad Pods Video unit duration in seconds (it can also be specified in the Duration field).
  • vitrina-platform: User environment (web, mobile_web, android, androidtv, ios, tvos, webos, tizen, vidaa).
  • vitrina-sdk-version={{SDK_VERSION}​}: Vitrina TV SDK version. {{SDK_VERSION}​}: The “TV showcase” macro used to pass the SDK version.

Mobile IDs:

  • google_aid: Android device ID (Google's identifier).
  • huawei_oaid: Huawei device ID.
  • idfa: iOS device ID.
  • ifv: iOS device ID for apps from the same developer.
  • ext_duid: External device ID.

Links are added to the app or player, and the Adfox server returns banner codes in response to the request.

Statistics

To view statistics, you can use:

Report

Metrics

Level

Ad Pods Video by days

  • Loads Ad Pods: The number of Ad Pods Video responses.

  • Banner loads Ad Pods: The number of banners selected to serve in the Ad Pods Video.

  • Impressions Ad Pods: The number of banner impressions in the Ad Pods Video.

  • Total Ad Pods requests: Total Ad Pods Video requests.

  • Unfilled Ad Pods responses: The number of unfilled Ad Pods Video requests.

  • Clicks Ad Pods: The number of clicks on Ad Pods Video banners.

  • CTR Ad Pods: Ratio of banner clicks to banner impressions in the Ad Pods Video.

  • Account
  • Site
  • Section
  • Placement
  • Campaign (flight)
  • Banner

Ad Pods Video by campaigns

  • Banner loads Ad Pods: Number of banners selected for the Ad Pods Video format.

  • Impressions Ad Pods: Number of banner impressions in the Ad Pods Video format.

  • Clicks Ad Pods: Number of clicks on Ad Pods Video banners.

  • CTR Ad Pods: Ratio of banner clicks to banner impressions in the Ad Pods Video.

  • Account
  • Site
  • Section
  • Placement
  • Campaign (supercampaign)

Ad Pods Video by position

  • Banner loads Ad Pods: Number of banners selected for the Ad Pods Video format.

  • Impressions Ad Pods: Number of banner impressions in the Ad Pods Video format.

  • Clicks Ad Pods: Number of clicks on Ad Pods Video banners.

  • CTR Ad Pods: Ratio of banner clicks to banner impressions in the Ad Pods Video.

  • Account
  • Site
  • Section
  • Placement
  • Campaign (flight)
  • Banner

Ad Pods Video by monetizers (publisher account)

  • Ad Pods Bidder Requests: The number of requests to the monetizer.

  • Ad Pods Bidder Responses: The number of responses from the monetizer.

  • Banner selections in Ad Pods Bidder: The total number of the monetizer's selected banners.

  • Banner returns in Ad Pods Bidder: The number of the monetizer's banners selected to serve.

  • Impressions Ad Pods Bidder: The number of the monetizer's banner impressions in the Ad Pods Video.

  • Account
  • Site
  • Section
  • Placement

Ad Pods Video bidding (monetizer account)

  • Requests Ad Pods Bidding: The number of requests to Ad Pods Video Bidding.

  • Loads Ad Pods Bidding: The number of responses from Ad Pods Video Bidding.

  • Banner selections in Ad Pods Bidding: The total number of banners selected from Ad Pods Video Bidding.

  • Banner loads in Ad Pods Bidding: The number of banners from Ad Pods Video Bidding selected to serve.

  • Impressions in Ad Pods Bidding: The number of banner impressions from Ad Pods Video Bidding in the Ad Pods Video.

  • Loads default Ad Pods Bidding: The number of unfilled requests to Ad Pods Video Bidding.

  • Clicks Ad Pods Bidding: The number of banner clicks in Ad Pods Video Bidding.

  • CTR Ad Pods Bidding: Ratio of banner clicks to banner impressions in Ad Pods Video Bidding.

  • Account
  • Site
  • Section
  • Placement

Note

To see only Ad Pods Video metrics in the Report Builder, apply the Only Ad Pods and Ad Pods Bidding traffic filter.

General

If several banners from the publisher account and connected monetizers' accounts fill a single ad request:

  • Adfox will record one response in the Loads Ad Pods metric.

  • The number of selected banners will be recorded in the Banner loads Ad Pods metric.

  • Impressions of all selected banners will be recorded in the Impressions Ad Pods metric.

You can view the following metrics in the Report Builder:

Metric

Description

Total Ad Pods requests

Total Ad Pods Video requests.

Loads Ad Pods

The number of Ad Pods Video responses.

Share of responses from Ad Pods Video, %

Ratio of responses to requests in the Ad Pods Video.

Unfilled Ad Pods responses

The number of unfilled Ad Pods Video requests.

Banner loads Ad Pods

The number of banners selected for the Ad Pods Video.

Impressions Ad Pods

The number of banner impressions in the Ad Pods Video.

Clicks Ad Pods

The number of banner clicks in the Ad Pods Video.

CTR Ad Pods

The ratio of banner clicks to banner impressions in the Ad Pods Video.

The number of banners selected in Ad Pods Video

Average number of selected banners per Ad Pods Video unit.

Average duration of one Ad Pods block, sec

Average duration of a single Ad Pods Video unit.

The average duration of the banner, sec

Average duration of a single banner in seconds.

The average number of advertising positions per Ad Pods Video

Average number of banners per Ad Pods Video unit.

Code requests from positions in the Ad Pods block

Number of potentially available Ad Pods banners with average duration.

The average duration of one banner Ad Pods shown, sec

Average duration of a single served banner in seconds.

Ad Pods Duration, sec

Total requested Ad Pods Video duration in seconds.

Filled Ad Pods Duration, sec

How many seconds video ads filled in the Ad Pods Video.

Unfilled Ad Pods Duration, sec

Unfilled ad time in the Ad Pods Video, in seconds.

Unfilled Ad Pods duration, on average, sec

Average number of unfilled seconds in the Ad Pods Video.

Shown Ad Pods Duration, sec

Total duration of Ad Pods Video banners served to the user.

Fill rate Ad Pods

Ratio of the filled duration to the requested duration in the Ad Pods Video.

Fill rate by impressions in Ad Pods

Ratio of served duration to requested duration in the Ad Pods Video.

Unique total Ad Pods requests

Unique Ad Pods Video requests (without repeat requests) to which the Adfox server responded with a banner ad or a backup ad.

Unique banner ad responses in Ad Pods

Unique banner ad response (without repeat responses) delivered to a user and recorded by the system. If you've redefined the campaign's impression count method, the number of recorded impressions may differ from the number of banner responses.

Unique impressions in Ad Pods

Unique banner impression delivered to a user and recorded by the system. If you've redefined the campaign's impression count method, the number of recorded impressions may differ from the number of banner responses.

Unique clicks in Ad Pods

Unique clicks (without repeat clicks) on ad banners that resulted in a click-through to the advertiser's site.

Drop off by duration Ad Pods, %

Percentage of filled duration that didn't generate impressions.

Drop off on banner downloads Ad Pods, %

Percentage of banner responses that didn't generate impressions due to technical losses or errors.

Drop off on errors Ad Pods, %

Ratio of errors to banner responses. Shows technical losses caused by errors.

Publisher account (by monetizer)

If you've enabled any other monetizers for your account, you can view the following metrics in the Report Builder:

Metric

Description

Ad Pods Bidder Requests

The number of requests from the Ad Pods Video to the monetizer.

Ad Pods Bidder Responses

The number of responses from the monetizer to the Ad Pods Video.

Default Ad Pods Bidder requests

The number of Ad Pods Video requests not filled by the monetizer.

Banner selections in Ad Pods Bidder

The number of banners from the monetizer selected to be potentially served in the Ad Pods Video.

Banner returns in Ad Pods Bidder

The number of banners from the monetizer selected to serve in the Ad Pods Video, excluding those that didn't fit into the requested duration.

Impressions Ad Pods Bidder

The number of the monetizer's banner impressions in the Ad Pods Video, counted according to the monetizer's impression count method.

Monetizer account

If a request for ads comes to the monetizer account:

  • Adfox records one request in the Requests Ad Pods Bidding metric.

  • The number of banners selected for potential impressions in the Ad Pods Video will be recorded in the Banner selections in Ad Pods Bidding metric.

  • The number of banners selected for impressions in the Ad Pods Video will be recorded in the Banner loads in Ad Pods Bidding metric.

  • The number of unfilled requests will be recorded in the Loads default Ad Pods Bidding metric.

You can view the following metrics in the Report Builder:

Metric

Description

Requests Ad Pods Bidding

The number of requests to Ad Pods Video Bidding.

Loads Ad Pods Bidding

The number of responses from Ad Pods Video Bidding, provided that at least one banner longer than five seconds was selected.

Share of responses from Ad Pods Bidding, %

Ratio of Ad Pods Video responses to Ad Pods Bidding requests.

Loads default Ad Pods Bidding

The number of unfilled requests to Ad Pods Video Bidding.

Banner selections in Ad Pods Bidding

The number of banners selected in Ad Pods Video Bidding for potential impressions in the Ad Pods Video.

Banner loads in Ad Pods Bidding

The number of banners selected for impressions in the Ad Pods Video, excluding those that didn't fit into the requested duration.

Impressions in Ad Pods Bidding

The number of impressions in Ad Pods Video Bidding counted in accordance with the campaign impression count method in the Ad Pods Video.

Clicks Ad Pods Bidding

The number of banner clicks in Ad Pods Video Bidding.

CTR Ad Pods Bidding

The ratio of banner clicks to banner impressions in Ad Pods Video Bidding.

The number of banners selected in Ad Pods Bidding

Average number of selected banners per Ad Pods Bidding unit.

Average duration of one Ad Pods Bidding block, seconds

Average duration of a single Ad Pods Bidding unit.

The average duration of the banner Ad Pods Bidding, sec

Average duration of a single banner in seconds.

The average number of advertising positions per Ad Pods Bidding

Average number of banners per Ad Pods Bidding unit.

Code requests from positions in the Ad Pods Bidding block

Number of potentially available Ad Pods Bidding banners with average duration.

The average duration of one banner Ad Pods Bidding shown, sec

Average duration of a single served banner in seconds.

Ad Pods Duration Bidding, sec

Total requested Ad Pods Video duration in seconds.

Available duration of Ad Pods Bidding, sec

Ad Pods Video duration in seconds filled by the publisher and available to the monetizer.

Filled Ad Pods Duration Bidding, sec

How many seconds video ads filled in the Ad Pods Video Bidding.

Unfilled Ad Pods Duration Bidding, sec

Unfilled ad time in Ad Pods Video Bidding, in seconds.

Unfilled Ad Pods Duration Bidding, sec

Average number of seconds unfilled by the monetizer.

Shown Ad Pods Duration Bidding, sec

Total duration of Ad Pods Bidding banners served to the user.

Fill rate Ad Pods Bidding

The ratio of the filled duration to the requested duration in Ad Pods Video Bidding.

Fill rate by impressions in Ad Pods Bidding

Ratio of served duration to requested duration in Ad Pods Video Bidding.

Fill rate from selected banners Ad Pods Bidding

Ratio of filled duration to requested duration across all banners selected by the monetizer, including those not shown in the Ad Pods Video.

Unique total Ad Pods Bidding requests

Unique requests to Ad Pods Video Bidding (without repeat requests) to which the Adfox server responded with a banner ad or a backup ad.

Unique banner ad responses in Ad Pods Bidding

Unique banner ad response (without repeat responses) delivered to a user and recorded by the system.

If you've redefined the campaign's impression count method, the number of recorded impressions may differ from the number of banner responses.

Unique impressions in Ad Pods Bidding

Unique banner impression delivered to a user and recorded by the system.

If you've redefined the campaign's impression count method, the number of recorded impressions may differ from the number of banner responses.

Unique clicks in Ad Pods Bidding

Unique clicks (without repeat clicks) on ad banners that resulted in a click-through to the advertiser's site.

Drop off by duration Ad Pods Bidding, %

Percentage of filled duration that didn't generate impressions.

Drop off on banner downloads Ad Pods Bidding, %

Percentage of banner responses that didn't generate impressions due to technical losses or errors.

Drop off on errors Ad Pods Bidding, %

Ratio of errors to banner responses. Shows technical losses caused by errors.

Comparing statistics in publisher and monetizer accounts

When you compare data between publisher and monetizer accounts, these metrics should match:

  • Ad Pods Bidder Requests = Requests Ad Pods Bidding

  • Ad Pods Bidder Responses = Loads Ad Pods Bidding

  • Default Ad Pods Bidder requests = Loads default Ad Pods Bidding

  • Banner selections in Ad Pods Bidder = Banner selections in Ad Pods Bidding

  • Banner returns in Ad Pods Bidder = Banner loads in Ad Pods Bidding

  • Impressions Ad Pods Bidder = Impressions in Ad Pods Bidding

Contact support

Send an email