Access mobile video inventory

Video inventory for mobile devices is categorized into two types: mobile app and mobile web.

Mobile app inventory

Mobile app inventory includes in-stream and outstream formats, consisting of HTML5-compatible inventory. Publishers pass buyers the ID of their app, which corresponds to the ID used in the iTunes App Store or Google Play Store environments.

The iOS Identifier for Advertising (IDFA) or the Android Advertising ID (AAID) are sent in the bid request. Learn more about targeting mobile apps with IDFA or AAID.

Mobile web inventory

Mobile web inventory targets users typically browsing mobile versions of websites on their mobile devices. Pre-roll, mid-roll, and post-roll ad positions are available, as well as in-feed video placements.

Requirements for all mobile video

All creatives for mobile video require VAST certification, must be HTML5-compliant, and contain an MP4 format (maximum 10 MB, with a maximum duration of either 15 or 30 seconds, depending on the publisher requirement in the request). You must declare the video URL in your bid response. A video pretargeting configuration should also be set up for video inventory, targeting mobile and tablet only.

Specific requirements per inventory type

Inventory type	Functionality	Placement
Mobile app interstitial	Skippable	INTERSTITIAL = 2
Mobile app in-stream	Non-skippable and skippable (majority is non-skippable mid-rolls and post-rolls)	INSTREAM = 1
Mobile app Rewarded (Beta)	Non-skippable	INTERSTITIAL = 2
Mobile web in-stream	Skippable and non-skippable Accepts VPAID 2.0	INSTREAM = 1

 

Learn about the bid request fields for mobile inventory

 

Field name	Description	Example
device_type	Type of mobile device in which the ad is shown: UNKNOWN_DEVICE = 0 HIGHEND_PHONE = 1 TABLET = 2 CONNECTED_TV = 4 GAME_CONSOLE = 5 This replaces the deprecated mobile_device_type.	2
is_app	If true, this request is from a mobile app.	false (default)
app_id	Mobile app store identifier:  Apple devices pass the app store ID Android devices pass the fully qualified package name	343200656 (Apple) com.domain.example (Android)
url	App Store URL: The URL for the app's page on the Google Play store or the Apple App Store. Content URL: The URL for the app's corresponding web page allowing contextual targeting of the app based on the web's content.
app_name	Actual app name.	Super-Bright LED Flashlight
app_rating	Average user rating for the app. The range of user rating is between 1.0 and 5.0. Currently only available for apps in Google Play store.	4.6
platform	Platform of the mobile device: Apple Android	Android
hardware_version	Model of the Apple iOS device in which the ad is shown (if applicable)	iphone 5s, iphone 6+, ipad 4
Video player size: width, height	For VAST video ad requests a single width/height pair specifies the Google-detected video player size. If Google cannot detect the player size, the publisher-provided player size (if available) is used. For mobile interstitial ads (including ones where video ads are eligible) multiple width height pairs are passed. Please note that these are full screen placements, and therefore it is better to read screen height and width.
max_ad_duration, min_ad_duration, and skippable_max_ad_duration	Required video lengths. Many publishers require ads to be skippable and have a maximum duration of 15 or 30 seconds.	15
video_ad_skippable	Value of SkippableBidRequestType containing one of the following: ALLOW_SKIPPABLE = 0 REQUIRE_SKIPPABLE = 1 BLOCK_SKIPPABLE = 2 Interstitial inventory is always REQUIRE_SKIPPABLE.	1
is_mobile_web_optimized	Determines whether the web page is optimized for mobile browsers on high-end devices.	True, False
allowed_video_formats	Describes the allowed video technologies for ads served in response to this request. The response should indicate support for at least one of them. The values for this repeated field come from the enumeration VideoFormat: VIDEO_FLV = 0 VIDEO_MP4 = 1 YT_HOSTED = 2 VPAID_FLASH = 3 VPAID_JS = 4	1
playbackmethod	Describes how the ad was played. METHOD_UNKNOWN = 0 AUTO_PLAY_SOUND_ON = 1 AUTO_PLAY_SOUND_OFF = 2 CLICK_TO_PLAY = 3	1
ScreenOrientation	The screen orientation of the device when the ad request is sent.	portrait

 

Set up pretargeting configurations to receive mobile callouts

You can pre-target mobile inventory to only receive requests for impressions that match your desired targeting criteria. This can include all mobile, mobile web only, or mobile app only. Pretargeting can be done in either the Authorized Buyers user interface or using the REST API.

Learn how to set up pretargeting configurations for different types of mobile inventory.

 

---

Learn more about real-time bidder integration with mobile.