{"id":3444,"date":"2012-08-13T09:31:09","date_gmt":"2012-08-13T05:31:09","guid":{"rendered":"http:\/\/blog.denivip.ru\/?p=3444"},"modified":"2013-08-05T14:10:56","modified_gmt":"2013-08-05T10:10:56","slug":"ios-player-with-vast-video-ad-support","status":"publish","type":"post","link":"http:\/\/blog.denivip.ru\/index.php\/2012\/08\/ios-player-with-vast-video-ad-support\/?lang=en","title":{"rendered":"iOS Player with VAST Video Ad Support"},"content":{"rendered":"

\"apple-advertising\"<\/a><\/center><\/p>\n

Ads based monetization has been widely adopted by the developers of free-of-charge iOS applications. To support banner ads in such applications, Apple offers a ready solution. However if your application is built around a video player, you may prefer inline ads shown in video pauses. As far as we know, no widely used free solution yet exists for this. In this post, we’ll tell you how you can easily add video ads to your app. For this purpose, you’ll have to add our free iOS VAST Player<\/a> library to the OpenX ad server. <\/p>\n

The server part of our video ad solution for iOS applications constitutes the OpenX Source ad server and an ad plugin we wrote for it. To get started with OpenX Source, please first download its source code, deploy it on your server and create an ad campaign in the administrator’s Web interface. To learn how to do this, please read our previous posts:<\/p>\n

    \n
  1. Displaying Ads in OpenX<\/a><\/li>\n
  2. Creating a High Load Ads Delivery System Based on OpenX<\/a><\/li>\n
  3. More on OpenX Features<\/a><\/li>\n<\/ol>\n

    However, there is an aspect to be kept in mind that has not been underscored in the above posts: video ads should be in a format playable on the Apple mobile devices. This may be either a separate MP4 file compressed with H.264 and AAC or an HTTP Live Streaming playlist.<\/p>\n

    The client part is a video player based on the AVFoundation framework (see our previous post Video Playback in iOS Applications<\/a>). The iOS VAST Player <\/a> library empowers developers with a ready<\/p>\n

    1
    <\/div><\/td>
    DVIABPlayer<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n

    iOS class enhancing the standard<\/p>\n

    1
    <\/div><\/td>
    AVPlayer<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n

    component with loading of VAST templates and scheduled video ad playback. The schedule specifies ad time and type, i.e. pre-roll, post-roll or mid-roll.<\/p>\n

    To connect the library to your project, follow these steps:<\/p>\n

      \n
    1. Add AVFoundation and CoreMedia to the list of frameworks used by the application.<\/li>\n
    2. Drag the library folder to your Xcode project.<\/li>\n
    3. Download and add the KissXML<\/a> library to the project. You’ll need it to parse VAST templates.<\/li>\n<\/ol>\n

      The library comes with a sample project to demonstrate its use. Let’s discuss this sample in detail. The sample has a single View Controller element containing a view container for the player layer, several information labels and playback control buttons.<\/p>\n

      The<\/p>\n

      1
      <\/div><\/td>
      DVIABPlayer<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n

      class is used similarly to<\/p>\n

      1
      <\/div><\/td>
      AVPlayer<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n

      : using the<\/p>\n

      1
      <\/div><\/td>
      viewDidLoad<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n

      player class, we initialize it and link it to the view container. Then we initialize it and link to the player an<\/p>\n

      1
      <\/div><\/td>
      AVPlayerItem<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n

      containing a link to the main content. On change of the<\/p>\n

      1
      <\/div><\/td>
      status<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n

      property of this item, automatic playback is launched. <\/p>\n

      \"\"<\/a><\/center><\/p>\n

      The differences from the<\/p>\n

      1
      <\/div><\/td>
      AVPlayer<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n

      are as follows. First, the<\/p>\n

      1
      <\/div><\/td>
      playerLayer<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n

      property is used to store the video playback layer. It is necessary, as for each played back video,<\/p>\n

      1
      <\/div><\/td>
      DVIABPlayer<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n

      creates a new<\/p>\n

      1
      <\/div><\/td>
      AVPlayer<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n

      within itself. Second, you have to set the ad schedule<\/p>\n

      1
      <\/div><\/td>
      DVVideoMultipleAdPlaylist<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n

      containing the list of inline ads and relevant references to the VAST templates:<\/p>\n

      \n\n
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      <\/div><\/td>
      DVVideoMultipleAdPlaylist *adPlaylist =
      \n    [[DVVideoMultipleAdPlaylist alloc] init];
      \nadPlaylist.playBreaks = [NSArray arrayWithObjects:
      \n    [DVVideoPlayBreak playBreakBeforeStartWithAdTemplateURL:
      \n     OPENX_AD_TAG_WITH_ZONE(18)],
      \n    [DVVideoPlayBreak playBreakAtTimeFromStart:CMTimeMake(10, 1)
      \n     withAdTemplateURL:OPENX_AD_TAG_WITH_ZONE(19)],
      \n    [DVVideoPlayBreak playBreakAfterEndWithAdTemplateURL:
      \n     OPENX_AD_TAG_WITH_ZONE(20)],
      \n    nil];
      \nself.player.adPlaylist = adPlaylist;<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n\n<\/pre>\n
      The<\/p>\n
      1
      <\/div><\/td>
      OPENX_AD_TAG_WITH_ZONE<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n
      macro submits to OpenX a link to the VAST descriptions of the ad created for a zone with a preset identifier.<\/p>\n
      This is a sequence of actions needed to enable OpenX inline ads within your main video content.<\/p>\n
      \"\"<\/a><\/center><\/p>\n
      Moreover, your View Controller can implement some optional methods of the<\/p>\n
      1
      <\/div><\/td>
      DVIABPlayerDelegate<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n
      protocol to alert of ad playback events. The current version of the protocol provides the following methods:<\/p>\n