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.

This cross-platform video format is shown on desktops, tablets, and mobile phones.

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.

Example

Preparation (for developers)

Prepare a video file that meets the requirements.

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.
• Progress (progress) — available with VAST 3.0

Add to Adfox

On the Settings → Banner types → Custom → Nondimensional 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.

  Name	MIME type
  MP4	video/mp4
  WEBM	video/webm
  SWF	application/x-shockwave-flash

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

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

    Note

    Adding the “Social ad” label doesn't automatically define the creative content as social ad. To label creative content as a social advertisement in the state register, select Social ads contract for the corresponding contract with the end advertiser.

  • In the Domain field, specify the advertiser domain, and it will be added to the label: “Ad | example.com” or “Social ad | example.com” (only if you select Ad or Social ad 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).

  The banner menu contains a link to the rules for using recommendation technologies. That is necessary to comply with paragraph 3, section 1, article 10.2-2 of Federal Law No. 149-FZ On information, information technologies, and information protection", dated July 27, 2006.

  Note

  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.

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.

You don't need to label banners with Wrapper content. Labeling is applied to the creative that is uploaded to the banner via a link.

Get the ad tag

Get the ad tag.

Example of the ad tag:

Displaying your ad after the player is minimized

To display your ad after the player is minimized, add the onVideoEnd callback function to the InPage banner ad tag. This function is triggered when the ad finishes playing. After the player is minimized, the alternative code specified in the function runs.

<script>
    window.Ya.adfoxCode.create({
        ownerId: 123456,
        containerId: 'banner-inpage',
        params: {
            p1: 'clxao',
            p2: 'gwfm',
            insertAfter: 'undefined',
            insertPosition: '0',
            stick: true,
            stickTo: 'auto',
            stickyColorScheme: 'light'
        },
        // Callback function with the tag of the RTB unit rendered in the same container
        onVideoEnd: () => {
            Ya.Context.AdvManager.render({
                renderTo: "banner-inpage",
                blockId: "R-A-123456-1"
                }
            )
        }
    });
</script>

Contact support

Send an email