InPage video
Description
InPage video is an ad format that allows you to show video ads in the site content.
The video player is deployed inside the main content of the site when 50% of the height of the player falls into the user's field of view. The video starts with the sound turned off.
After the playback is completed, the player collapses and disappears from the page.
The format is fully compatible with the VAST and VPAID video ad specifications. It supports standard tracking events requested at certain times when they occur in the player.
InPage enables sites to manage traffic through their own direct sales and also monetize it through the Yandex Advertising Network.
Parameters for adding a banner to Adfox:
- Setting the video player animation on the page.
- Setting the video player visibility.
- Setting the positioning of the video player in the page content.
Preparation (for developers)
Prepare a video file that meets the requirements.
Format | MP4, WebM, MOV, QT, FLV, AVI, or XML (VAST 2.0 format) |
Recommended format | MP4 |
Frame rate | no more than 60 frames per second |
Number of video tracks | 1 |
Audio codecs | AAC, MP3, Vorbis |
Number of audio tracks | no more than 1 |
Minimum resolution | 1280 × 720 pixels |
Duration | up to 2 minutes |
The maximum size of the video clip to be uploaded to the Adfox interface | 100 MB |
Format | MP4, WebM, MOV, QT, FLV, AVI, or XML (VAST 2.0 format) |
Recommended format | MP4 |
Frame rate | no more than 60 frames per second |
Number of video tracks | 1 |
Audio codecs | AAC, MP3, Vorbis |
Number of audio tracks | no more than 1 |
Minimum resolution | 1280 × 720 pixels |
Duration | up to 2 minutes |
The maximum size of the video clip to be uploaded to the Adfox interface | 100 MB |
Video files that you upload directly to the Adfox interface are automatically converted to different formats and sizes and saved to the Yandex video hosting.
To upload files to the banner that don't meet the restrictions, there's a special box labeled (URL) that specifies the full path to the file on a third-party server.
File names must only contain numbers or Latin letters and an underscore character. You can't use Cyrillic letters, spaces, quotation marks, dashes, and special characters in the file name.
For XML: Information about the VAST standard for video ads.
Event count
The banners count events automatically:
- The start of viewing (start).
- The video is selected (creativeView).
- The video is loaded (impression).
- The first quarter of viewing (firstQuartile).
- The middle of viewing (midpoint).
- The third quarter of viewing (thirdQuartile).
- Full view (complete).
- Turn the sound off (mute).
- Turn the sound on (unmute).
- Pause (pause).
- View from the beginning (rewind).
- Continue viewing (resume).
- Go to full screen (fullscreen).
- Expand (expand).
- Collapse (collapse).
- Go to the next video (acceptInvitation).
- Click on the Close button (close).
- Click on the Skip ads text bar (skipAd).
- Click on the Click to the advertiser's website text bar (addclick).
- Error (error).
- Viewable impression, Yandex is only available in the Linear-Ad (Pre / Mid / Post - Roll) VAST 3.0 Viewability for InPage template.
Add to Adfox
On the
tab , add a new banner type.The banner type lists templates compatible with the player:
- Linear-Ad (Pre / Mid / Post - Roll) VAST 3.0 Viewability for InPage: This template includes a viewability check. If at least 50% of the video area is in the active browser window for at least 2 seconds, the Viewable impression, Yandex event will be registered.
- Linear-Ad (Pre / Mid / Post - Roll) VAST 2.0 for InPage.
- Wrapper VAST 2.0 for InPage.
When adding a campaign in the Impression count method parameter, we recommend specifying Event No. 3 or Viewable impression, Yandex (for the Linear-Ad (Pre / Mid / Post - Roll) VAST 3.0 Viewability for InPage template). This is due to the fact that in video ads, the banner impression is considered to be the actual start of the ad material impression in the player: that is, on the occurrence of Event No. 3 or Viewable impression, Yandex.
Option 1. Ad type with Linear-Ad content
To add a banner, select the Linear-Ad (Pre / Mid / Post - Roll) VAST 3.0 Viewability for InPage template:
- Video URL: Upload the ad material or provide a link if the file is uploaded to a third-party server. The recommended video aspect ratio is 4:3 or 16:9.
- Click link: The link to the advertised site. If the placement uses links from third-party systems, add
%random%
to the end of the link. - width, height: Specify the size of the ad material.
- duration (hh:mm:ss) (default is 00:00:00): Video playback duration.
- content type: Must match the uploaded video file.
- uploaded video 2 (impression 2): An additional link to the counter of a third-party system for tracking events.
- uploaded video (impression).
- uploaded video 3 (impression 3): An additional link to the counter of a third-party system for tracking Uploaded video (impression) events.
Settings for Russian ad register: The section is only available if the Submit data to state register procedure is selected in the campaign settings. Fill in the fields in this section to register the creative in the Yandex advertising data operator. The creative is assigned a token automatically.
Name | MIME type |
---|---|
FLV | video/x-flv |
MP4 | video/mp4 |
WEBM | video/webm |
SWF | application/x-shockwave-flash |
Name | MIME type |
---|---|
FLV | video/x-flv |
MP4 | video/mp4 |
WEBM | video/webm |
SWF | application/x-shockwave-flash |
<paused>
until the conversion is complete. After conversion, the video status changes to <converted>
, and the banner status changes to the one that was before you uploaded the video: <active>
or <paused>
.Option 2. Ad type with Wrapper content
If you specify a link to XML with the so-called Wrapper code, use the Wrapper VAST 2.0 for InPage template. It contains a link requesting access to a third-party system to get XML with an ad.
- VASTAdTagURI: Specify a link to the XML or add an XML file.
- uploaded video 2 (impression 2): An additional link to the counter of a third-party system for tracking events.
- uploaded video (impression).
- uploaded video 3 (impression 3): An additional link to the counter of a third-party system for tracking events.
- Under Advertising label settings:
- In the Ad label list, select “Ad” or “Social ad”, and the label will be added to the banner. If the creative's design already includes the label, you can keep “Disabled” in the drop-down list.
- In the Domain field, specify the advertiser domain, and it will be added to the label:
"Advertising" | example.com
or"Social advertising" | example.com
(only if you select “Advertising” or “Social advertising” in the drop-down list).
To add a token to a non-clickable banner, enable the Show banner menu option in the banner settings. When the banner is served, the menu icon
will be displayed in the upper right corner of it. When a user clicks this icon, the advertiser information and the copy token button appear (if ad register is enabled for the banner and a third-party token is specified).
Important. If a banner is non-clickable (the Transition URL field is not filled in) and it is to be added to the ad register, be sure to show the banner menu. This is the only way to make the token available when serving the banner.Settings for Russian ad register: The section is only available if the Submit data to state register procedure is selected in the campaign settings. Fill in the fields in this section to register the creative in the Yandex advertising data operator. The creative is assigned a token automatically.
You can see an example of an XML response for Wrapper here.