Ad Unit Settings

Create an Ad Unit:

  • Click on the “Ad Services” tab on the top toolbar
  • Click “Create New”
  • Select InArticle

1: Ad Unit Settings

  • Click "General"
  • Title: The name of your Ad Unit format
  • Code: The reference to the ad unit (Will default to your Title)
  • Description (optional): Describe what the InArticle will be used for

2: CTA Settings

  • CTA text: Type in your Call to Action text
  • Midplay CTA: Enable CTA text midplay by selecting “Show” option
  • CTA position: Select a Call to Action position
  • Exitscreen CTA: Enable Call to Action on the exit screen by selecting “Show” option in the drop down menu. Use CTA background color and CTA highlight color to customise CTA

3: InArticle Settings

  • Sticky options: Enabling this setting will keep the inArticle video in view by sticking it to either the bottom, top or floating it to one of the bottom corners, thereby increasing viewability and completion rates.
    • Width when floating: The width of the player when floating in pixels. This can be a number or javascript code returning a number. You can use the reference $ (the jQuery library) in your code. Example: $(window).width() / 3
    • Minimum device width to enable floating: This option allows you to only float the player when the device width is greater than this minimum.
    • Always float: The player will not appear within the content and will always float.
    • Hide floating close button: The close button will not appear whilst the player is floating.
  • Responsive Player Sizing: Overrule the width and height and make the player responsive to the block of content the video will open up in.
  • Aspect Ratio: By default, a responsive player will take the width of the player and calculate the height based on the aspect ratio of the video being displayed. With this setting, you can overrule this to always scale the player to a certain aspect ratio. If you do, we recommend 16:9 since it is the most common aspect ratio for video.
  • Width: Use a percentage for a responsive playout (eg 100%). You can set this to pixel width using the drop-down arrow.
  • Maximum width: The Maximum width in pixels that the player will open up in.
  • InView Margin: The percentage of the height of the player that needs to be visible before the player is considered to be "InView”.
  • Placeholder background color: Set up the background color for the placeholder viewers will see when there is no ad playing or after an ad has finished. This is only applicable if you choose to not collapse the player.
  • Placeholder text color: Set up the text color for the placeholder viewers will see when there is no ad playing.
  • Placeholder text: Freeform text that will appear in the centre of the placeholder. You can input HTML here to influence the styling.
  • Allow Skipping: Allow the user to skip the ad after “x” seconds.
  • Autoplay: Ad will play as soon as the VAST has loaded, whether in view or not.

4: Display Settings

  • Controls visibility: By default the control bar is automatically hidden on play with no mouse action and on pause. You can enable the control bar to always show or hide.
  • Show play/pause button: Enable play/pause button on the control bar
  • Show mute/unmute button: Enable mute/unmute button
  • Sow progress bar: By default, the progress bar is enabled. With this setting you can disable the control bar. If you do, previously enabled play/show and/or mute/unmute buttons will remain enabled.
  • Progress bar color: Set up the color of the progress bar
  • Text commercial time remaining: Type text you want to appear next to the remaining time of the commercial
  • Text above player: If you want to have text appear above the player, type it here
  • Text for player close button: If you want to have text above the close button, type it here.

5: In and out view

  • Start Collapsed: Start the player collapsed (closed) and only expand it when media starts playing. Leave unchecked if you would like the player to always start open.
  • Collapse on end: Collapse (close) the player at the end of the content. Leave unchecked to have the player remain open when the ad finishes playing. The endscreen will show an image or the placeholder design depending on how you’ve set this up.
  • In View Action: When the player enters view, determine what action the player will take
  • Out View Action: When the player exits view, determine what action the player will take.

6: Mouse

  • Mouse In Action: When the user hovers their mouse cursor over the player, determine what action the player will take
  • Mouse out Action: When the user hovers their mouse cursor out of the player, determine what action the player will take

7: Placement Options

  • Placement option: With this option, you can place the script anywhere on the page and find the proper place on the page using the "DOM Selector”
    • Default: the player will be placed at the position of the script element. With this option, you can place the script anywhere on the page and find the proper place on the page using the "DOM Selector”
    • After matching DOM element: Place the player directly after the first element matching the DOM-Selector
    • Halfway matching DOM elements: Place the player after the number of items matching the DOM-Selector divided by two, rounded down. Example: When 7 elements match the selector, the banner will be placed after the 3rd element.
    • After matching DOM element below the fold: The placement logic will try to place the player below the webpage “fold”. This means it will place the player after the first element that is not completely visible without scrolling. If none of the elements are below the fold, the player will not be placed.
    • After matching DOM element below the fold, or the last element found: Same as above, with the exception that it will be placed after the last element found, if none of the matching elements is under the fold.
  • Placement DOM selector: This selector uses jQuery and can use anything jQuery can use. See http://api.jquery.com/category/selectors/ for full documentation. The jQuery library is already included in our player.
  • Attempt iFrame Breakout: When the ad unit is placed by another ad system that places it within a friendly iFrame, this option will allow the player to break out of that iFrame in order to perform proper "InView" calculations.
  • Add (css) clear:both to player wrapper: Add the css style 'clear:both' to the player wrapper.

8: Miscellaneous options

  • Preload line items: This option allows you to start calling all VAST URL's in the line items at the first user interaction in order to enable faster playback once the user arrives at the player position. Without this option enabled the first VAST call will be done when the player is "InView". We recommend always checking this option to avoid any latency issues.
  • Custom Javascript Code: Custom javascript code that will be executed when the player is placed. You can use the references $$api (the player API) and $$wrapper (the player wrapper element) in your code.
  • Passback Code: Custom javascript code that will be executed when the player has finished playing an ad or no ad was found. Here you can pass back to either a display or video campaign.

9: The Embed Script

  • The Embed script can be found at the bottom of the Ad Unit settings page after you save the format. This script can either be:
    • Placed in the source of the page or
    • Via an ad container/ad unit already existing on your page.