Advertising Plug-Ins

From KickApps Documentation

App Studio Advertising Plug-Ins enable you to run ads in your video players from a number of ad networks and other ad providers. This list is always growing, so please contact us if you need support for an ad provider that's not listed here.

Contents 1 Run ads in your video player 2 Disable player controls during ad playback 3 Advertising Plug-Ins 3.1 24/7 OAS 3.2 CODE 3.3 Adap.tv 3.4 Atlas 3.5 DoubleClick for Publishers 3.6 Google AdSense for Video 3.7 Pre-roll 3.8 Post-roll

Run ads in your video player

To run ads in a video player, drag one of the Advertising Plug-Ins from the Advertising panel onto your video player. You can then configure the advertising in the ad plug-in's properties panel, which will appear in the right column of the App Studio. Details on configuring each Advertising Plug-In are available below.

Disable player controls during ad playback

You probably don't want player controls to be functional while an ad is playing (so that the user can skip the ad, play another video over the ad, etc.). To effectively disable the rest of your widget while a video ad is running, we recommend the following:

1. Create rectangle components that cover your entire widget area except for the video player.
2. Set all of them to transparent by turning down the opacity control at the top right of the stage to 0.
3. Group these rectangles into a new Container component.
4. Move this Container to the top layer of your widget.
5. Use the video player's "Video ad start" and "Video ad end" events to trigger a show/hide actions on this Container.

Advertising Plug-Ins

24/7 OAS

Our 24/7 Advertising Plug-In supports the following features:

• In-stream video ads that can be played before, after, or at any point during the playback of the current video.
• Run an unlimited number of video ads before, after, or at any point during the playback of a content video
  • Click-through URL available on each video ad
  • Video ad tags are applied to a video player with a frequency setting to determine how many content videos will play between each video ad slot (i.e., 'play 2 videos between each ad slot')
• 5 different slots for companion ads. When the player receives the XML from 24/7 it will pass an array of companion ad objects for each of these slots to a JS function on the page called KATwentyFourSevenCompanionAd. The JS objects will look like this:

{position, width, height, imageURL, clickURL, title}

• Tracking tags for
  • user clicked on video ad
  • video ad start
  • video ad middle
  • video ad end
• Video player can pass the ID of the current video to 24/7 if you include [mediaId] in your ad tag, like so:

http://oascentral.blahblahblah/RealMedia/ads/adstream_sx.ads/blahblahblah/blah?mediaid=[mediaId]

To use the 24/7 advertising plug-in,

1. Configure your 24/7 account to output XML in the following format:
   

CODE

<?xml version="1.0" encoding="UTF-8"?>
<!-- 24/7 Real Media XML Template for KickApps Widget -->
<!-- Last Update : 02/10/2009 -->
<VideoXML>
    <!-- URL to count XML download -->
    <CoD_URL/>
    <Keyword/>
    <!-- Instream Ad Setup Begins -->
    <Playlist>
        <!-- Pre-roll Setup Begins -->
        <!-- duration = length in sec, playafter = delay in sec -->
        <Track id="" duration="" playafter="">
            <!-- Pre-roll URL-->
            <videoURL/>
            <!-- Video click-through URL -->
            <videoClickURL/>
			<!-- URL to count click-throughs -->
			<TrackVideoClickURL/>
            <!-- URL to count pre-roll start -->
            <TrackStartURL/>
            <!-- URL to count pre-roll mid -->
            <TrackMidURL/>
            <!-- URL to count pre-roll end -->
            <TrackEndURL/>
        </Track>
        <!-- Pre-roll Setup Ends -->
        <Track id="" duration="" playafter="">
            <videoURL/>
            <videoClickURL/>
            <TrackStartURL/>
            <TrackMidURL/>
            <TrackEndURL/>
        </Track>
    </Playlist>
    <!-- Instream Ad Setup Ends -->
    <CompanionAd position="sponsor" width="" height="">
        <ImageURL/>
        <ClickURL/>
        <Title/>
    </CompanionAd>
    <!-- Top Companion Ad Begins -->
    <CompanionAd position="top" width="" height="">
        <ImageURL/>
        <ClickURL/>
        <Title/>
    </CompanionAd>
    <!-- Top Companion Ad Ends -->
    <!-- Right Companion Ad Begins -->
    <CompanionAd position="right" width="" height="">
        <ImageURL/>
        <ClickURL/>
        <Title/>
    </CompanionAd>
    <!-- Right Companion Ad Ends -->
    <!-- Bottom Companion Ad Begins -->
    <CompanionAd position="bottom" width="" height="">
        <ImageURL/>
        <ClickURL/>
        <Title/>
    </CompanionAd>
    <!-- Bottom Companion Ad Ends -->
    <!-- Left Companion Ad Begins -->
    <CompanionAd position="left" width="" height="">
        <ImageURL/>
        <ClickURL/>
        <Title/>
    </CompanionAd>
    <!-- Left Companion Ad Ends -->
</VideoXML>

1. In the App Studio, drag and drop the 24/7 plug-in from the Advertising panel onto your video player.
2. Generate a 24/7 ad tag URL that will return XML in the format above. Paste that tag into the 24/7 properties panel at the top of the rightmost column.

Sample ad tag

http://flexonrails.net/bits/twofourseven.xml

Adap.tv

1. Drag the adap.tv plug-in onto your video player.
2. Enter your Publisher ID in the adap.tv properties panel at the top of the rightmost column and click Apply.
3. Ensure that the "Adap.tv ads enabled" checkbox is selected.

Atlas

Microsoft Atlas is built on the VAST IAB ad standard, so you can use this plug-in to run any VAST-compliant ads, not just those delivered by Microsoft.

To use the Atlas plug-in,

1. Drag the Atlas plug-in from the Advertising panel onto your video player.
2. Enter one or more ad tags in the Atlas properties panel at the top of the rightmost column.

• Pre-roll and Post-roll tabs
  • Select the Pre-roll tab to define pre-roll ads to be run before content videos in the selected video player; Select the Post-roll ad to define post-roll ads to be run after content videos in the selected video player.
• Frequency
  • Define how many content videos should play before a pre- or post-roll ad.
• Plus sign icon
  • Click the plus sign icon to define a new pre- or post-roll ad
• Tag URL
  • Enter the Atlas ad tag URL that will return your video ad.
• Trash can icon
  • To delete an ad, click a row in the list above, then click this icon.

Please note: If you enter multiple pre- or post-roll ads, the plug-in will randomly select one ad from your list of ads when it needs to make an ad request.

Sample Atlas ad tag

http://api.atdmt.com/adserv.api/viewad/sa=ndgtrpnb0110000195ado;sf=VAST_PreRoll_XML_V2;pf=FLV;br=500;strm=1

Passing the ID of the current video to Atlas or another VAST-compliant ad server The KickApps video player can pass the ID of the current video in with your ad request if you include [mediaId] in your ad tag, like so:

http://api.atdmt.com/adserv.api/viewad/sa=ndgtrpnbado;sf=VAST_PreRoll_XML_V2;pf=FLV;br=500;strm=1?mediaid=[mediaId]

DoubleClick for Publishers

1. Drag the DoubleClick plug-in from the Advertising panel onto your video player.
2. Enter one or more ad tags in the DoubleClick properties panel at the top of the rightmost column.

• Pre-roll and Post-roll
  • Select the Pre-roll tab to define pre-roll ads to be run before content videos in the selected video player; Select the Post-roll ad to define post-roll ads to be run after content videos in the selected video player.
• Frequency
  • Define how many content videos should play before a pre- or post-roll ad.
• Plus sign icon
  • Click the plus sign icon to define a new pre- or post-roll ad
• Tag URL
  • Enter the DoubleClick ad tag URL that will return your video ad.
• Companion
  • Enter the URL to a companion display ad. Just before the Doubleclick plug-in plays the video ad that corresponds to this companion ad, it will make this companion ad URL available to a JavaScript function on the page on which the player is embedded.
• Trash can icon
  • To delete an ad, click a row in the list above, then click this icon.

Please note: If you enter multiple pre- or post-roll ads, the plug-in will randomly select one ad from your list of ads when it needs to make an ad request.

Google AdSense for Video

1. Drag the Google plug-in from the Advertising panel onto your video player.
2. Enter your Pub ID, Host, and Channel in the Google properties panel at the top of the rightmost column and click Apply.
3. Ensure that the "Google ads enabled" checkbox is selected.

Pre-roll

The Pre-roll Advertising Plug-In enables you to run pre-roll ads against the videos in the selected video player. You define a pre-roll ad by entering a video URL for the ad, and, optionally, a click-through URL.

• Frequency
  • Define how many content videos should play in your player before a pre-roll ad should play.
• Video
  • Enter a URL of your video ad. The URL should return an .flv, .mp4, .mov, .m4v, or rtmp stream.
• Link
  • Enter a URL for use as a click-through link. When viewers click on the video player while the corresponding pre-roll ad is playing, they will be redirected to this URL.

Please note: If you enter multiple pre- or post-roll ads, the plug-in will randomly select one ad from your list of ads when it needs to make an ad request.

You can also use the "video ad start" and "video ad end" events to trigger other behavior, like requesting a tracking pixel before and after your ad runs.

Post-roll

The Post-roll Advertising Plug-In enables you to run post-roll ads against the videos in the selected video player. You define a post-roll ad by entering a video URL for the ad, and, optionally, a click-through URL.

• Frequency
  • Define how many content videos should play in your player before a post-roll ad should play.
• Video
  • Enter a URL of your video ad. The URL should return an .flv, .mp4, .mov, .m4v, or rtmp stream.
• Link
  • Enter a URL for use as a click-through link. When viewers click on the video player while the corresponding post-roll ad is playing, they will be redirected to this URL.

Please note: If you enter multiple pre- or post-roll ads, the plug-in will randomly select one ad from your list of ads when it needs to make an ad request.

You can also use the "video ad start" and "video ad end" events to trigger other behavior, like requesting a tracking pixel before and after your ad runs.