AMP - Advertising

Document created by Herberth Alvarado Employee on Apr 13, 2016Last modified by Herberth Alvarado Employee on Jul 16, 2017
Version 15Show Document
  • View in full screen mode

Mantainer: Herberth Alvarado

This document is part of Adaptive Media Player Web User Guide

 

 

Feature: Ad Configuration: DFP/IMA/VAST

AMP Premier supports DFP Premium with its integration of the IMAv3 SDK for Flash and for HTML5. From https://developers.google.com/interactive-media-ads/ :

 

"The Google Interactive Media Ads (IMA) SDK enables publishers to display linear, non-linear, and companion ads in interactive media content such as videos and games. Publishers can use the IMA SDK to request and display ads served by DoubleClick for Publishers (DFP), the Google AdSense network, or any VAST-compliant ad server. Common scenarios for using the IMA SDK include displaying pre-rolls or overlays in video content."

 

The IMA3 SDK, when used with DFP ad serving, leverages DFP Premium’s “Ad Rules” feature which allows central control for ad operations personnel to implement various ad policies. If your ad operations group has not formally implemented DFP Premium integration, it is highly recommended to contact your DFP team to do so.

For on-demand content:

  • pre-rolls, mid-rolls, companions, and overlays are controlled by the single initial ad call up front and are outlined in the ad response.
  • mid-roll ad markers in the timeline are drawn by information in the ad response which assumes that a content feed is provided to the ad server ahead of time.
  • optionally, mid-roll ad markers in the timeline (please make a request of the AMP team for this).

For live content:

  • pre-rolls, companions are controlled by the single initial ad call up front and are outlined in the ad response
  • mid-rolls (Flash only) are triggered by cuepoints (see further detail in the chapter)
  • overlays may require a custom build (please make a request of the AMP team for this)

 

Basic sample

ima: {

   resources: [

      {

         type: "text/javascript",

         src: "//imasdk.googleapis.com/js/sdkloader/ima3.js",

         debug: "//imasdk.googleapis.com/js/sdkloader/ima3_debug.js"

      }

   ],

   enabled: true,

   version: 3,

   adTagUrl: "//pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/ad_rule_samples&ciu_szs=300x250&ad_rule=1&impl=s&gdfp_req=1&env=vp&output=xml_vmap1&unviewed_position_start=1&cust_params=sample_ar%3Dpremidpostpod&cmsid=496&vid=short_onecue&correlator=",

   disableCompanionAds: false,

   ppid: "ABCDE123456789012345678901234567",

   vpaidMode: "enabled",

   companions: [

      {

         id: "companion-container",

         width: 300,

         height: 250

      }

   ]

},

Sample: AMP Premier - Samples - IMA

 

Feature: Ad Configuration: Freewheel

AMP Premier supports Freewheel with its integration of the SDK For Flash and for HTML5.

Freewheel sample

freewheel: {

   enabled: true,

   resources: [

      {

         type: "text/javascript",

         src: "//adm.fwmrm.net/p/vitest-js/AdManager.js"

      }

   ],

   plugin: {

      swf: "//adm.fwmrm.net/p/vitest-as3/AdManager.swf?logLevel=VERBOSE"

   },

   networkId: 96749,

   serverUrl: "//demo.v.fwmrm.net/ad/g/1",

   profileId: "global-js",

   siteSectionId: "DemoSiteGroup.01",

   videoAssetId: "DemoVideoGroup.01",

   prerollSlotId: "Preroll_1",

   midrollSlotId: "Midroll_1",

   postrollSlotId: "Postroll_1"

},

Sample: AMP Premier - Samples - FreeWheel

 

Feature: Ads: MidRoll Ads for VOD

On-demand midrolls are supported.The timeline will display as follows:

 


 

For IMA, midroll markers are drawn and enforced by the ad response. The media-scenes node should appear in the content feed:

 

"media-scenes" node

"media-scenes": {

   "media-scene": [

   {

      "sceneTitle": "Scene 1",

      "sceneDescription": "Scene 1 - Description",

      "sceneStartTime": "00:00:00",

      "sceneEndTime": "00:00:30"

   }, {

      "sceneTitle": "Scene 2",

      "sceneDescription": "Scene 2 - Description",

      "sceneStartTime": "00:00:30",

      "sceneEndTime": "00:01:00"

   }, {

      "sceneTitle": "Scene 3",

      "sceneDescription": "Scene 3 - Description",

      "sceneStartTime": "00:01:00",

      "sceneEndTime": "00:01:30"

   }, {

      "sceneTitle": "Scene 4",

      "sceneDescription": "Scene 4 - Description",

      "sceneStartTime": "00:01:30",

      "sceneEndTime": "00:01:48"

   }]

},

Samples: AMP Premier - Samples - MRSS Feed - JSON  and AMP Premier - Samples - MRSS Feed Menu

Feed as JSON: http://projects.mediadev.edgesuite.net/customers/akamai/mdt-html5-core/premier/2.47.0.0009/resources/feeds/vod-feed.json

 

Feature: Ads: “MidRoll” Ads for Live (Client Side)

AMP Premier support client side playback of ads during breaks for Flash mode only. During such a break:

  • the live non-ad content continued to play but is muted.
  • the ad call is made when cuepoint is observed, and ad playback will occur based on the ad response
  • ads can be killed from an appropriate kill cuepoint

 

For client-side ad insertion for commercial breaks, the inbound stream should be RTMP and contain cuepoints at the start of the breaks. There are currently two formats supported in AMP Premier for this use case:

  • For both formats:
    • onCuePoint
    • type: event
    • name: AdMarker
  • Format 1 (older)
    • AdOut:1 means start ad
    • AdIn:1 means immediate return to programming (kill ad)
  • Format 2 (newer, compatible with upcoming server-side ad-insertion)
    • BreakID:0x1000000c
      • If the first Hex digit is a 1 “0x1” then then start ad break National
      • If the first Hex digit is a 2 “0x2” then then start ad break is Local
      • If the first Hex digit is anything else “0x5” the cue is a ‘return to programming’ immediately, kill any playing ads
    • DurationMsec:100000 (duration of ad break in msec for us to tell the ad provider in the ad call)

 

Testing cuepoint implementation

In these Akamai support players:

  1.   for HDS use http://mediapm.edgesuite.net/edgeflash/public/zeri/debug/Main.html
  2.   for HDN1 use http://mediapm.edgesuite.net/edgeflash/public/debug/HDPlayer.html
  3.   for RTMP use http://support.akamai.com/flash/

 

You will see something like this in the trace

  [194373] Script data message received.

  Name: onCuePoint with properties:

  parameters:

  DurationMsec:195000

  TimeMsec:941165592

  BreakID:0x10001219

  AdOut:1

  name:AdMarker

  type:event

  time:941166.1916277778

 

Useful links:

See also Adobe ActionScript 3.0 * Using cue points and metadata

 

 

This document is part of Adaptive Media Player Web User Guide

Attachments

    Outcomes