Link Search Menu Expand Document

PDF

Ad Units

Publishers

Last updated on May 3, 2017


After you set up your sites, you can create ad units, which represent the specific areas to display ads. Read this section for ad unit basics. You must create an ad unit for each ad size and location on your website or app. You set attributes in the UI that are used to generate an ad tag for making real-time ad requests.


on this page

NOTE

Some features mentioned here may not be available in your region or based on your user role. For more information, please visit the O​penX Community​.


About Ad Units and Ad Tags

Each ad unit you create belongs to a single site and generates an ad tag with a unique identifier, called an ad unit ID, or “auid”. An example ad tag where the blurred section is a placeholder for your instance name:

For web-based ad units, place this ad tag code in the source code of your sites. For mobile and video ad units, configure your app or video player to communicate the ad request to OpenX. For more information on tag types, read about the Ad Request API.


Ad unit type

One of the attributes that you must specify for each ad unit is Ad Unit Type, which defines the delivery medium for the ad unit. Learn more about supported ad unit types in Creating ad units.


Tag type

For web and email ad units, you must also specify the Tag Type setting, which describes the type of code to use to display ads in your ad space. Available tag types depend on the selected Ad Unit Type setting. That is if the Ad Unit Type is:

  • Web: you can use asynchronous JavaScript (the default), synchronous JavaScript, image, or iframe ad tags to serve ads.
  • Email: you must use image ad tags to serve ads.
  • Mobile: you must use structured ad tags to serve ads.

Creating Ad Units

Last updated on October 8, 2018

Click to expand this section


You can create an ad unit for each unit of ad space on your website or mobile app. Each ad unit belongs to a site (the OpenX object), and the settings for that site are used as defaults for each ad unit.

For an overview of how to create sites and ad units, see the video below.


NOTE

You can copy an existing ad unit by selecting it and clicking the clone icon. You can then edit it to make any desired changes.


Ad unit types

The Ad Unit Type field is where you select the delivery medium, or the way ads will be viewed. Depending on your OpenX products and the type of site you have set up in OpenX, you can create email, linear video, non-linear video, mobile, native, video companion, or web ad units.

This field inherits options based on the site’s default delivery medium. Refer to the following table for links to step-by-step instructions by ad unit type:

Ad unit typeDescription
WebStandard web-based display ads, such as web banners on web pages.
MobileAds that display in mobile web browsers or within mobile applications. To create a mobile ad unit, the site under which you create an ad unit must have a Default Delivery Medium of Mobile.
If you set up a Mobile site to serve video ad units to your mobile app, at the ad unit level, change the Ad Unit Type to Linear Video.
Linear VideoVideo ads that play in sequence with video content in a video player.
If you set up a Mobile site to serve video ad units to your mobile app, at the ad unit level, change the Ad Unit Type to Linear Video.
Non-Linear VideoAds that display during video content in a video player, like a banner that overlays the video near the bottom of the player.
Video CompanionAds that are tied to either linear or non-linear video ads, but that appear outside of the video player.
Use this ad unit type if you are setting up companion ad units for an ad unit group where the primary ad unit (master ad unit) is for a linear or non-linear video ad.

Creating Web Ad Units

Last updated on March 5, 2018

Click to expand this section


Once you have created a site in OpenX, you need to create ad units for it. Create a web ad unit when you’d like to display standard web-based ads, such as web banners.

You can learn more about ad units and read creating ad units for more information about types of ad units for different delivery mediums.

To create a web ad unit:

  1. Open the site for which you are creating an ad unit.

  2. Click Create Ad Unit. The Create Ad Unit form is displayed.

  3. Complete the following fields:

    • Name field: Enter a unique name.
    • Ad Unit Type: Web should already be selected.
    • Presentation Format: Select Display or Interstitial.
    • Ad Unit Size: Select a size for the new ad unit. This represents the width-by-height size of the ad unit’s viewing area. Select an IAB standard ad unit size, or specify a custom size for the ad unit. To do this, select Custom Size in the list, and in the Custom Width and Custom Height fields that appear, type in the ad unit’s custom dimensions (in pixels).

    If you want to specify multiple sizes for the ad unit (up to 5) so that more ads are eligible to serve to it, see Flexible ad units.

  4. (Optional) Complete the following fields:

    • Screen Location: Select the placement of the ad unit on the webpage, relative to the fold.
    • Site Section: Select the section of the website where the ad unit resides. This list contains all sections already set up for the site in OpenX.
    • Content Topic: Select a content topic for the ad unit, which describes the main subject of the online content that surrounds the ad unit on the webpage. Start typing in a string, and then select a content topic in the list. You can select multiple content topics for the ad unit.
    • Content Type: Select the content type for the ad unit, which describes the main function of the content around the ad unit on the webpage. By default, OpenX populates this setting with the selected Default Content Type set for the ad unit’s site container.
  5. In the Tag Type list, select one of the following ad tag types to set the interaction rules for the ad unit:

    • javascript - asynchronous (the default): Uses JavaScript that runs in parallel with the execution of the overall loading of a page to deliver an ad to a specified ad unit.
    • javascript - synchronous: Uses inline JavaScript that runs in series with the execution of the overall loading of a page to deliver an ad to a specified ad unit.
    • iframe: These ad tags use HTML iframe tags (<iframe\>) to deliver an ad (within a separate HTML document) to a specified ad unit.
    • Real-time Bid Floor: If your OpenX configuration enables exchange selling, enter the minimum price that you are willing to accept for this ad unit. The currency type is based on the Currency setting for the container site. If any real-time selling rules target this ad unit and have a Floor Price value that is different than this Real-time Bid Floor, the higher floor becomes the minimum bid price allowed to win the inventory.
  6. Depending on your OpenX configuration, you can select the Optimization check box to either:

    • Make this ad unit available to ad networks or ad exchanges that OpenX has relationships with.
    • Allow OpenX to sell this ad unit through its ad exchange.
  7. (Optional) Complete the following fields:

    • Auto Refresh Settings: Set or change for the ad unit. By default, OpenX applies the auto refresh settings for the container site.
    • Passback Ad Tag: Type the HTML ad code for a fallback ad to serve in cases when OpenX would otherwise serve a blank ad. You can enter a value in the Passback Ad Tag field if you have appropriate permissions. You should leave the Passback Ad Tag field empty if you do not have a passback tag for the ad unit.
    • External Identifier field: Type a free-form reference ID.
  8. Do one of the following to complete ad unit setup:

    • Click Create. The Create Ad Unit screen closes, and a confirmation message for the new ad unit appears above the ad units list.
    • Click Create and Add Another Ad Unit. This opens a new Create Ad Unit screen with a confirmation message for the new ad unit, where you can automatically begin creating another one for this account.
    • Click the drop-down arrow and then Create and Get Ad Tag. This opens the View Ad Unit screen for the new ad unit, and a confirmation message for the new ad unit appears above the ad tag.

Now you can copy and paste the ad tag into the source code of your website. For more information, see Viewing ad units.


Creating Mobile Ad Units

Last updated on October 4, 2018

Click to expand this section


Once you have created a site in OpenX for either mobile app or for mobile web browser inventory, you need to create ad units for it. Ad units created under Mobile Sites are considered “mobile” ad units whether intended for mobile app or mobile browser display.

For ad units belonging to a mobile app site, you can select OpenX, DFP, or MoPub as your ad server to generate the corresponding tag.

If you’re creating a mobile ad unit for video inventory, see the video-specific instructions for Creating a linear video ad unit. See Creating ad units for a list of all types of ad units you can create for different delivery mediums.

To create a mobile ad unit for mobile web or mobile app:

  1. Open the mobile site for which you are creating an ad unit. A mobile “site” is needed in OpenX even for a mobile app, in order to group the inventory together for that app.

  2. Click Create Ad Unit. The Create Ad Unit form is displayed.

  3. Complete the following fields:

    • Name: Enter a unique name.
    • Ad Unit Type: Select Mobile.
    • Ad Server: Select which ad server you are using (DFP or MoPub).
    • Presentation Format: Select Display (banner ads) or Interstitial. This setting determines which sizes you can select for the ad unit.
    • Ad Unit Size: Select a size for the ad unit. This is the width-by-height size of the ad unit’s viewing area. You can also specify a custom size for the ad unit. To do this, select Custom Size in the list, and in the Custom Width and Custom Height fields that appear, type in the ad unit’s custom dimensions (in pixels).

    To specify multiple sizes for the ad unit (up to 5) so that more ads are eligible to serve to it, see Flexible ad units. For multiple sizes in a mobile app ad unit, the recommended size combinations are 320x480 and 300x250 or 480x320 and 300x250 for interstitial ads. Make sure that the primary size you select is the largest size and that the alternative size fits within the dimensions of the primary size.

  4. (Optional) Complete the following fields:

    • API Framework: Type to select one or more API frameworks. This information can then be passed to buyers. Note that populating this field will override any “af” query argument or OpenRTB “api” argument set in the ad request.
    • Screen Location: Select the placement of the ad unit on the screen, relative to the fold.
    • Site Section: Select the section of the site where the ad unit resides. This list contains any sections set up for the site in OpenX.
    • Content Topic: Select a content topic for the ad unit, which describes the main subject of the online content that surrounds the ad unit on the webpage. Start typing in a string, and then select a content topic in the list. You can select multiple content topics for the ad unit.
    • Content Type: Select the content type for the ad unit, which describes the main function of the content around the ad unit in the webpage. By default, OpenX populates this setting with the selected Default Content Type set for the ad unit’s site container.
    • Allow Defaulting Chain - Allow a chain to end with defaulting line item: Select this check box to allow a chain to return no ad; clear this check box to require a chain to return a guaranteed ad.
    • Enable Server Mediation - Enable Request 3rd Party Network at Server Side: Select this check box to allow OpenX to send requests to third party mobile ad networks, such as Conversant, MobFox, or Smaato. You must have accounts set up and be configured for this type of mediation. OpenX will prompt for additional information, such as publisher ID, to access the account. Clear this check box to prevent OpenX from sending requests to third party mobile ad networks.
  5. If the ad unit is for a display in mobile browsers (Mobile Web), select one of the following values from the Tag Type list to use when requesting ad delivery from OpenX:

    • javascript - asynchronous: Uses JavaScript that runs in parallel with the execution of the overall loading of a page to deliver an ad to a specified ad unit.
    • javascript - synchronous: Uses inline JavaScript that runs in series with the execution of the overall loading of a page to deliver an ad to a specified ad unit.
    • iframe (the default): Uses HTML iframe tags (<iframe\>) to deliver an ad (within a separate HTML document) to a specified ad unit.
  6. Depending on your OpenX configuration, select the Optimization check box to either:

    • Make this ad unit available to ad networks or ad exchanges that OpenX has relationships with.
    • Allow OpenX to sell this ad unit through the OpenX Ad Exchange.
  7. (Optional) Complete the following fields:

    • Real-time Bid Floor: Set a floor price for the ad unit.
    • Set or change Auto Refresh Settings for the ad unit. By default, OpenX applies the auto refresh settings for the container site.
    • Passback Ad Tag: Type the HTML ad code for a fallback ad to serve in cases when the ad server would otherwise serve a blank ad. Note that if you are using DFP as your ad server for a mobile app ad unit, you can only use a secure (https) passback tag. You can enter a value in the Passback Ad Tag field if you have the appropriate permissions. You should leave the Passback Ad Tag field empty if you do not have a passback tag for the ad unit.
    • External Identifier: Type a free-form reference ID.
  8. Do one of the following to complete ad unit setup:

    • Click Create. The Create Ad Unit screen closes, and a confirmation message for the new ad unit appears above the ad units list.
    • Click Create and Add Another Ad Unit. This opens a new Create Ad Unit screen to begin creating another one for this account.
    • Click the list arrow and then Create and Get Ad Tag. This opens the View Ad Unit screen for the new ad unit, and a confirmation message for the new ad unit appears above the ad tag.

After you create a mobile ad unit, a Mobile Ad Tag is generated. This base Mobile Ad Tag is necessary for serving ads, as well as validation and testing. You can retrieve the tag by selecting the ad unit and copying the Mobile Ad Tag displayed on the ad unit page.

For details about modifying the tag, see MoPub integration or DFP mobile app integration. If you want to further modify or enhance your MoPub or DFP tag, you can also add more fields to your OpenRTB parameter.


Creating Linear Video Ad Units

Last updated on January 16, 2019

Click to expand this section


To serve video ads that play in a video player in your mobile app or on your website (mobile and/or desktop), you need to create separate linear video ad units for each of the following inventory types:

  • Desktop web
  • Mobile web
  • Mobile app

You must have your publisher account and sites created before you can create your linear video ad units. The site for which you intend to create video ad units must have the following selections:

  • For mobile apps, Mobile in the Default Delivery Medium field and iOS or Android in the Platform field.
  • For mobile web and desktop web, Linear Video in the Default Delivery Medium field.
NOTE

Do not select Web in the Default Delivery Medium field for mobile web or desktop web video ad units.

To save time, you may clone existing similar linear video ad units and edit them as needed. For details on which fields you can update, see Editing ad units.

To create a linear video ad unit:

  1. Open the site for which you are creating an ad unit.

  2. Click Create Ad Unit.

  3. In the displayed Create Ad Unit form, provide the appropriate information in the fields as described in Linear video ad unit settings below.

  4. To complete the ad unit setup, do one of the following:

    • Click Create. A confirmation message for the new ad unit appears at the top of the Site page with a list of ad units.
    • Click Create and Add Another Ad Unit. A new Create Ad Unit form appears with a confirmation message for the new ad unit. You can begin creating another ad unit for the same site.
    • Click the drop-down arrow next to Create and Add Another Ad Unit and then Create and Get VAST ad tag. The Ad Unit page for the ad unit you have just created appears with a confirmation message above the VAST ad tag. An example app VAST ad tag, where the blurred section is a placeholder for your instance name:

    VAST ad tags are necessary for serving ads, as well as for validation and testing. To retrieve the tag, click the ad unit in the site list and copy the displayed VAST ad tag.

NOTE

For Prebid adapters, server-to-server integrations, and mobile SDKs, OpenX provides ad unit IDs (auid) and delivery domains instead of VAST tags. 


Configuring VAST ad tags

Now that you have created a linear video ad unit and you have a VAST ad tag, you must configure your VAST ad tag and add it to your ad server or video player.


Linear video ad unit settings

SettingDescription
NameEnter a descriptive name to identify your linear video ad unit.
Ad Unit TypeSelect Linear Video. The default option is determined by the Default Delivery Medium selection from the parent site for which you are creating the ad unit.
Ad ServerChoose your ad server. If not listed, select Other.
   • If you choose any of the following ad servers, OpenX automatically appends their macros to your exportable VAST ad tag:
      • DFP (Web only at this time)
      • Fyber (Mobile app only)
      • Ironsource (Mobile app only)
      • LKQD (Web only at this time)
      • MoPub (Mobile app only). If you choose this option, some of the fields on this from get automatically pre-filled for you.
      • If you choose Other, OpenX does not append any macros, but creating the ad unit still results in an exportable VAST tag. This VAST tag can be used in any third-party ad server that accepts VAST as its alternative tag format.

Note: Place tags into the UI of the appropriate ad server, not into your video player code/configuration.
Video PlayerSelect your video player:
   • JW Player (Web only at this time). Adds JW Player macros to the exportable VAST ad tag if no Ad Server macros are available to append.
   • Other. Currently does not affect your base VAST ad tag.

After you have constructed the tag based on your needs, paste it into your video player code/configuration. See also the important note above.
Presentation FormatSelect In-stream or Interstitial. Support for Out-stream is coming soon.
Video DimensionsSelect the size dimensions for video playback. If you choose Custom Size, specify the desired dimensions in the Custom Width and Custom Height fields that appear underneath.
Mime TypesChoose the MIME types that your video player is compatible with. For more information, see Video MIME types.
API FrameworkThis setting overrides any OpenRTB api arguments set in the ad request. Choose the API framework supported by your video player. If necessary, see the IAB guidelines for MRAID and VPAID.
   • MRAID-1
   • MRAID-2
   • ORMMA
   • VPAID 2.0

Note: If you selected application/javascript in the MIME Types field, select VPAID 2.0.
Playback MethodSelect the preferred way for a video to launch. Select only one playback method. Selecting more than one method is unclear to buyers and may impact revenue. Failing to specify a playback method signals to buyers that any method may be used, which can lead to confusion and, as a result, lower bid depth and/or lower-priced bids.
ProtocolsChoose the highest version of the OpenRTB protocol that your video player supports. Include the backwards-compatible options.
If your video player support wrappers, you may include both wrapper and non-wrapper options. Most players support both regular VAST and wrapped VAST since both are part of the IAB standard. A wrapped VAST is when the DSP adds XML to a VAST response by encapsulating the original VAST response in a new VAST response.
Position within Linear Video ContentThis field is recommended by the IAB in the OpenRTB API specification version 2.3, section 5.10. OpenX recommends that you use this field for optimization purposes. Buyers may prefer a particular position depending on the creative. Using this field gives them the information they need to target desired positions.
Select the location of the ad unit in the video content:
   • Pre-roll. A video ad for this ad unit plays before the video stream.
   • Mid-roll. A video ad for this ad unit plays in the middle of the video stream.
   • Post-roll. A video ad for this ad unit plays at the end of the video stream.
Site Selection(Optional) Select the section of the site where the ad unit resides. This list contains any sections already set up for the site in OpenX
Is RewardedCheck this box if this ad unit contains opt-in video inventory.
Content Topic(Optional) Visibility of this field depends on your OpenX configuration. If visible, start typing the topic text for the ad unit and select the content topic, which describes the main subject of the online content that surrounds the ad unit. You can select multiple content topics.
Content Type(Optional) Visibility of this field depends on your OpenX configuration. If visible, select the content type for the ad unit, which describes the main function of the content around the ad unit. The default option is determined by the Default Content Type selection from the parent site for which you are creating the ad unit.
Allowable Delivery MethodsSelect the streaming protocol that the ad unit supports for video ads:
   • HTTP-based. (Recommended) Uses the hypertext transfer protocol to stream the video ad.
   • RTMP- or HTTP-based. Uses either protocol to stream the video ad.
   • RTMP-based. Uses the real-time messaging protocol to stream the video ad.
Maximum Ad DurationSelect an ad duration from the list for a video ad to be displayed in this ad unit. If you choose Custom Size, specify the desired maximum length for the ad (in seconds) in the Custom Duration field that appears underneath.
Minimum Ad Bitrate(Optional) Specify the acceptable minimum bitrate for video ads. If left blank, the default setting is 240 Kbps.
Maximum Ad Bitrate(Optional) Specify the acceptable maximum bitrate for video ads. If left blank, the default setting is 4,000 Kbps.
Real-time Bid FloorSpecify the minimum price a demand partner must clear to be considered a valid bid.
Auto Refresh Settings(Optional) By default, OpenX applies the auto refresh settings from the parent site for which you are creating the ad unit. If you want to change the default settings, click the link to overwrite them, select the Enabled check box, and set the auto refresh settings for the ad unit as described in Specifying auto refresh settings.
External Identifier(Optional) Enter a free-form reference ID.

Creating Non-linear Video Ad Units

Last updated on April 5, 2017

Click to expand this section


Once you have created a site in OpenX, you need to create ad units for it. One type of ad unit you create for either a mobile or web site is the non-linear video ad unit. Non-linear video ad units represent a space for non-linear video ads to display.

You can learn more about ad units and read creating ad units for more information about types of ad units for different delivery mediums.

To create a non-linear video ad unit:

  1. Open the site for which you are creating an ad unit.

  2. Click Create Ad Unit. The Create Ad Unit form is displayed.

  3. Complete the following fields:

    • Name: Enter a unique name.
    • Ad Unit Type: Select Non-Linear Video.
    • Ad Unit Size: Select a size for the ad unit. This is the width-by-height size of the ad unit’s viewing area.
      • To specify a custom size for the ad unit, select Custom Size in the list, and in the Custom Width and Custom Height fields that appear, type in the ad unit’s custom dimensions (in pixels).
      • If you want to specify multiple sizes for the ad unit (up to 5) so that more ads are eligible to serve to it, see Flexible ad units.
  4. (Optional) Complete the following fields:

    • Position on Player: Select the “screen location” for a non-linear video ad in the ad unit. This is the placement relative to the video player. This can be Bottom or Top.
    • Site Section: Select the section of the site where the ad unit resides. This list contains any sections set up for the site in OpenX.
    • Content Topic: Select a content topic for the ad unit, which describes the main subject of the online content that surrounds the ad unit on the webpage. Start typing in a string, and then select a content topic in the list. You can select multiple content topics for the ad unit.
    • Content Type: Select the content type for the ad unit, which describes the main function of the content around the ad unit in the webpage. By default, OpenX populates this setting with the selected Default Content Type set for the ad unit’s site container.
    • Maximum Ad Duration: Select the maximum length (in seconds) for the non-linear video ad that plays in this ad unit. This can be 5, 10, or 15 seconds, Persistent, or Custom. To specify a custom duration, select Custom in the list, and in the Custom Duration field that appears, type in the ad unit’s custom duration (in seconds).
    • Auto Refresh Settings: Set or change for the ad unit. By default, OpenX applies the auto refresh settings for the container site.
    • External Identifier: Type a free-form reference ID.
  5. Do one of the following to complete ad unit setup:

    • Click Create. The Create Ad Unit screen closes, and a confirmation message for the new ad unit appears above the ad units list.
    • Click Create and Add Another Ad Unit. This opens a new Create Ad Unit screen with a confirmation message for the new ad unit, where you can automatically begin creating another one for this account.
    • Click the drop-down arrow and then Create and Get VAST Ad Tag. This opens the View Ad Unit screen for the new ad unit, and a confirmation message for the new ad unit appears above the ad tag.

Creating Video Companion Ad Units

Last updated on April 4, 2017

Click to expand this section


Once you create a Site in OpenX, you can create video companion ad units. Video companion ad units are designed to display ads in conjunction with a video ad, but outside of the video player.

Create video companion ad units for video-based ad unit groups. These ad unit groups have an Ad Unit Group Type setting of Linear Video or Non-linear Video. They contain a master ad unit that is either a linear or non-linear video ad unit and one or more video companion ad units.

You can learn more about ad units and read creating ad units for more information about types of ad units for different delivery mediums.

To create a video companion ad unit:

  1. Open the Site for which you are creating an ad unit.

  2. Click Create Ad Unit. The Create Ad Unit form is displayed.

  3. Complete the following fields:

    • Name: Enter a unique name.
    • Ad Unit Type: Select Video Companion.
    • Ad Unit Size: Select a size for the ad unit. This is the width-by-height size of the ad unit’s viewing area. Select an IAB standard size in the list or specify a custom size. To do this, select Custom Size in the list, and in the Custom Width and Custom Height fields that appear, type in the ad unit’s custom dimensions (in pixels). To specify multiple sizes for the ad unit (up to 5) so that more ads are eligible to serve to it, see Flexible ad units.
  4. (Optional) Complete the following fields:

    • Relative Position to Player: Select one of the locations for the ad unit, in relation to the video player (for example, Above Player, Below Player, Left of Player, Right of Player, or Skin).
    • Site Section: Select the section of the site where the ad unit resides. This list contains any sections set up for the site in OpenX.
    • Content Topic: Select a content topic for the ad unit, which describes the main subject of the online content that surrounds the ad unit on the webpage. Start typing in a string, and then select a content topic in the list. You can select multiple content topics for the ad unit.
    • Content Type: Select the content type for the ad unit, which describes the main function of the content around the ad unit on the webpage. By default, OpenX populates this setting with the selected Default Content Type set for the ad unit’s site container.
    • Auto Refresh Settings: Set or change this setting for the ad unit. By default, OpenX applies the auto refresh settings for the container site.
    • External Identifier: Type a free-form reference ID.
  5. Do one of the following to complete ad unit setup:

    • Click Create. The Create Ad Unit screen closes, and a confirmation message for the new ad unit appears above the ad units list.
    • Click Create and Add Another Ad Unit. This opens a new Create Ad Unit screen with a confirmation message for the new ad unit, where you can automatically begin creating another one for this account.

    Before you can serve ads to your new video companion ad unit, you must include it in a video-based ad unit group.


Video MIME Types

Last updated on January 16, 2019

Click to expand this section


MIME types describe the type of file you are transmitting in a way that has meaning to the code base via which your video player and ad server communicate. You are probably used to recognizing files based on their filename extensions, such as .mov for a Quicktime file. These filename extensions are associated with MIME types so your ad server or video player can communicate with each other and demand sources who want to serve ads to your linear video ad units.

Your video player is compatible with a particular set of MIME types. You need to identify those and specify the subset of them that is compatible with your ad unit’s inventory type while creating a linear video ad unit. By doing this, you should receive only ads that are compatible with your video player and inventory type.


MIME type syntax

A MIME type’s structure consists of a type and a subtype. The type and subtype are two strings which are separated by a forward slash (/):

type/subtype


Spaces are not permitted, and lowercase is the standard, though MIME types are not case sensitive.

In the case of Video in the OpenX Ad Exchange, you find MIME types with a type of either application or video. For example, the Quicktime file referenced above has a type of video and a subtype of quicktime. The MIME type associated with a Quicktime file looks like this:

video/quicktime

How to choose MIME types

When you create a linear video ad unit, you need to choose MIME types for that ad unit. The MIME types you choose depend on your video player’s compatibility and the inventory type of your linear video ad unit.

It is very important to choose the correct MIME types. Choosing incorrect MIME types will make your ad unit available to incompatible ad types in the OpenX Ad Exchange. Determine which MIME types to select based on two criteria:

  • Video player compatibility
  • Inventory type of your linear video ad unit

The table below provides an overview of MIME type choices.

MIME typeSample filename extensions
application/javascript (requires VPAID 2.0 support).js
application/vnd.apple.mpegurl.m3u, .m3u8
application/x-mpegurl.m3u, .m3u8
video/3gpp.3gp
video/mp4.mp4, .m4a, .m4p, .m4b, .m4r, .m4v
video/mpeg.m1v
video/ogg.ogg
video/quicktime.mov, .qt
video/webm.webm
video/x-m4v.m4v
video/ms-asf.asf, .wma, .wmv
video/x-ms-wmv.wmv
video/x-msvideo.avi

External documentation for supported MIME types

The following external documentation is subject to change without notice to OpenX. When in doubt, please follow documentation for your video player’s latest version.


Flexible Ad Units

Last updated on May 3, 2017

Click to expand this section


You can set up OpenX ad units to accept creatives of more than one size. This is referred to as flexible ad units which can help you to:

  • Increase your revenue from your OpenX inventory. Allowing an ad unit to accept more than one creative size increases the number of potential buyers for a single ad unit, thereby increasing competition for impressions and ultimately, raising the selling price.
  • Add more flexibility to your Private Marketplace deals by allowing you to sell against secondary sizes that provide much higher CPM, but significantly lower fill.

The following diagrams demonstrate how flexible ad units work. This diagram demonstrates the bids a single-size ad unit might get:

In the following diagram, the same ad unit can now accept two sizes. By attracting more demand for this ad unit, you have increased the ad unit’s value.


Common ad unit size pairings

  • 728x90, 970x90, 970x250 (leaderboard, slider)
  • 160x600, 300x600, 120x600 (tower, side rail)
  • 300x250, 300x600, 300x1050 (side rail, MPU, rec5)
  • 320x50, 300x50 (adhesion, sticky)
  • 320x50, 300x250 (in-feed)
  • 320x480, 300x250 (mobile app, interstitial, portrait)
  • 480x320, 300x250 (mobile app, interstitial, landscape)

Flexible ad unit ad tag compatibility

You can use flexible ad units with Image and Javascript tags. Flexible ad units will also work when these tags are served into friendly iframes.

To set up flexible ad units:

  1. Identify an ad unit that can accept multiple creative sizes, making sure that your web page can adjust for those different sizes.

  2. Find and open the ad unit in OpenX. The primary size should be selected in the Ad Unit Size dropdown list.

  3. Add one or more secondary sizes to the ad unit:

    1. In the ad unit, select Include additional ad unit sizes.
    2. In the Additional Ad Unit Sizes box, start typing to find and select the secondary sizes that you want this ad unit to accept.
  4. Save the ad unit.

  5. You need to target all of the sizes of this ad unit when trafficking your OpenX ad tag.

    For example, this may include adding the additional sizes to the line item and creative in your ad server.

    This also means that if you convert an OpenX ad tag from normal to Flex, the ad tag will need to be re-trafficked in your outside ad server.

  6. Make sure your site or app supports the flex sizes you’ve chosen.

  7. If you are using the ad size in your naming conventions, you may want to update the names of your ad units, line items, and creatives accordingly.


Flexible ad unit FAQs

QuestionAnswer
Can I have mobile flexible ad units?Yes, flexible ad units are supported on both mobile web and mobile app ad units.
How can I find out if the ability to host multiple sized ads is enabled on my web page?1. In your browser, open Developer Tools and click Network.
2. Click Filter and enter “gamp”.
3. Click Name and then Headers. Find the Query String Parameters.
4. Look at Prev_u_szs to see what sizes are enabled.
Do I need to set separate floor prices by ad size?No, OpenX Market Rules and Pricing Controls will apply the highest floor price across all ad sizes associated with a flexible ad unit.
Can flexible ad units be set up with iframe tags?You can use flexible ad units with friendly iframes only. Other iframe tags are currently incompatible with flexible ad units.

Editing Ad Units

Click to expand this section


After you create an ad unit, you can change any of its settings except for the Ad Unit Type setting. In addition, you can change the name, status, or ad size for an ad unit directly in the list of ad units or you can change the status of multiple ad units at once. Publisher revenue model or related CPM changes require revenue re-calculation, so they typically do not take effect until the following day.

To edit an ad unit:

  1. Open the view ad unit screen for the ad unit you want to change and then click the edit icon. This opens the edit ad unit screen.

  2. Edit any of the following settings for the ad unit, depending on the selected Ad Unit Type:

    Ad unit typeSettings
    All ad unitsYou can edit:
       • Name
       • Site Section
       • Content Topic
       • Content Type
       • Real-time Bid Floor
       • Publisher Revenue Model (if enabled)
       • External Identifier
    Web ad unitsYou can edit:
       • Ad Unit Size
       • Screen Location
       • Tag Type
    Linear video ad unitsYou can edit:
       • Video Dimensions. Select a new size for the ad unit’s viewing area.
       • Maximum Ad Duration. Select a maximum length for the video ad.
       • Position Within Linear Video Content. Select the placement of the ad unit within the video content.
       • Allowable Delivery Methods. Select the streaming protocol to use for the ad unit.
    Non-linear video ad unitsYou can edit:
       • Ad Unit Site. Select the size of the viewing area for the ad unit.
       • Position on Player. Select the location on the player where the ad unit resides.
       • Maximum Ad Duration. Select the maximum length of the ad unit.
    Video companion ad unitsYou can edit:
       • Ad Unit Size. Select the size for the ad unit.
       • Relative Position to Player. Select the location of the ad unit, relative to the video player.
    Mobile ad unitsYou can change the following ad unit-specific settings:
       • Ad Unit Size. Select the size for the ad unit.
       • Response Format/Tag Type. For mobile application ad units, select a new structured response format; for mobile web ad units, select a different tag type to use.
  3. Click Save.


Viewing Ad Units

Last updated on March 5, 2018

Click to expand this section


View general details for the ad units that you have access to. You do this in the View Ad Unit screen where you can also:

  • View and retrieve the ad tag for the selected ad unit.
  • Track user activity for the ad unit.
  • View and monitor performance information for the selected ad unit.

To view ad unit details:

  1. Open the view site screen for the site. By default, the view site screen opens to the Ad Units tab.

  2. In the list of ad units, click the link for the ad unit you want to view. The screen displays by default information about the ad unit in the top and bottom portions of the screen:

    • Top: Displays the details for the ad unit, including the ad unit name, type, size, status, and ID.
    • Bottom: Displays the ad tag for the ad unit. For web, email, and mobile web ad units, this consists of the ad tag that you need to copy and paste into your website’s source code. For video ad units, this consists of a URL which contains the ad request that your video player needs to send to OpenX. You need to configure your video player to send this request to OpenX. For mobile application ad units, this consists of the ad request URL that your mobile application needs to send to OpenX. You need to configure your mobile application to communicate this structured mobile ad call to OpenX.
  3. (Optional) You can change the information that displays in the bottom portion of the screen by clicking a tab. The tabs available for each ad unit include:

    • Ad Tags/VAST Ad Tag: For web, email, and mobile web ad units, click to display the ad tag for the ad unit. From here, you can copy the ad tag and paste it into the source code for your website. For video or mobile app ad units, click to display the ad request URL. For video, you can use this request in your video player. For mobile, you can configure your mobile application to communicate with OpenX.
    • Performance: Click to view performance information for the ad unit.

Monitoring Ad Units

Last updated on December 23, 2016

Click to expand this section


You can monitor the performance, like sales and revenue, of the ad units you are responsible for. Open the view ad unit screen for the ad unit that you want to monitor, and then click the Performance tab.

By default, the ad unit performance graph shows impressions by day, and revenue by day, collected for the last seven days. Depending on your needs, you can change the type of information that displays in the performance graph, or the time period for which it is collected.

In addition, you can view detailed reports on the Reporting tab.


Deleting Ad Units

Last updated on October 18, 2019

Click to expand this section


Delete the ad units you no longer want to use. Before you delete an ad unit, consider the following:

  • Any ad calls for the ad unit are considered invalid.
  • Forecasts related to the inventory that the deleted ad unit represents will be removed.
  • You will no longer have access to view or manage the deleted ad unit.

You can delete an individual ad unit, or you can delete multiple ad units at once.

To delete an individual ad unit:

  1. Open the View Ad Unit screen for the ad unit you want to remove.

  2. Click the Delete icon.

  3. In the confirmation screen that appears, click OK. This removes the ad unit from the list. Alternatively, click Cancel to quit the delete operation.