restrict outstream w/o renderer to PBS

[sumit116]

Type of change

• Bugfix
• Feature
• New bidder adapter
• Code style update (formatting, local variables)
• Refactoring (no functional changes, no api changes)
• Build related changes
• CI related changes
• Does this change affect user-facing APIs or examples documented on http://prebid.org?
• Other

Description of change

• test parameters for validating bids

[{
      'code': 'div-gpt-ad-1460505748561-0',
      'sizes': [640, 480],
      'mediaTypes': {
        'video': {
          playerSize: [[ 640, 480 ]],
          context: 'outstream',
          mimes: ['video/mp4']
        },
        banner: { sizes: [[300, 250]] }
      },
      'transactionId': '4ef956ad-fd83-406d-bd35-e4bb786ab86c',
      'bids': [
        {
          'bid_id': '123',
          'bidder': 'appnexus',
          'params': { 'placementId': '12349520' }
        }
      ]
    },
    {
      code: 'video1',
      mediaTypes: {
        video: {
          playerSize: [640, 480],
          context: 'outstream',
          mimes: ['video/mp4']
        }
      },
      bids: [
          {
              bidder: 'appnexus',
              params: {
                  placementId: 13232385,
                  video: {
                      skippable: true,
                      playback_method: ['auto_play_sound_off']
                  }
              }
          }
      ],
      renderer: {
        url: 'http://cdn.adnxs.com/renderer/video/ANOutstreamVideo.js',
        render: function (bid) {
            ANOutstreamVideo.renderAd({
                targetId: bid.adUnitCode,
                adResponse: bid.adResponse,
            });
        }
      }
    }
  ];

Be sure to test the integration with your adserver using the Hello World sample page.

[jsnellbaker]

When I setup an outstream video bid and sent it to PBS, the ORTB request still went out and returned with a 400 Bad Request response because of the following error:

Invalid request: request.imp[0] must contain at least one of "banner", "video", "audio", or "native"

If there are no other valid bids to make, then the request shouldn't go out and prebid should return some type of error message indicating that the request for that adunit was rejected.

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[sumit116]

@jsnellbaker ,
The below adResponse object is required to pass in the renderer.render() to display an outstream video add through Prebid Server.

bid.adResponse = {
	"ad": {
		"video": {
			content: bid.vastXml,
                        player_height: bid.playerHeight,
                        player_width: bid.playerWidth
		}
	}
}

So, now the renderer object would look like:

renderer: {
                 url: 'http://cdn.adnxs.com/renderer/video/ANOutstreamVideo.js',
                 render: function (bid) {
                    adResponse = {
                        ad: {
                            video: {
                                content: bid.vastXml,
                                player_height: bid.playerHeight,
                                player_width: bid.playerWidth
                            }
                        }
                    }
                    bid.renderer.push(() => {
                        ANOutstreamVideo.renderAd({
                            targetId: bid.adUnitCode, // target div id to render video
                            adResponse: adResponse
                        });
                    });
                  }
              }

Can you please review this PR now?

[jsnellbaker]

@sumit116 I think these updates look good.

Can you put together a docs PR for the updated sample adUnit render code (for when serving from PBS)? The additions would be helpful to note down.

[sumit116]

@sumit116 I think these updates look good.

Can you put together a docs PR for the updated sample adUnit render code (for when serving from PBS)? The additions would be helpful to note down.

Thanks @jsnellbaker . Docs PR added: prebid/prebid.github.io#1385.

[spormeon]

how do you get this "renderer" thing to work with multi boxes? the docs are non existant and the examples dont show how to do it?

[sumit116]

boxes

@jsnellbaker , do you have any idea about this?

[jsnellbaker]

@spormeon Can you please clarify a little further on what you mean?

[spormeon]

how do you get a renderer to work with "multi boxes" it just doesnt seem to work?

[jsnellbaker]

@spormeon Do you have a page setup where you're trying to get this to work that I can see? I don't understand the term 'multi boxes' in this context. Do you mean just having multiple outstream video placements serving together?

[spormeon]

prebid "multi-format" my test pages are behind login, so unless i can Pm you its hard to give you it
http://prebid.org/dev-docs/show-multi-format-ads.html

no mention of a 'renderer" anywhere or how to add one and throw in some bidders being S2S and got a mess, with no docs or info on how to do it?