You can configure some aspects of the advertising request behavior of a Brightcove player by editing the player's JavaScript or ActionScript publishing code. This can be helpful when you need the same player instance to behave differently in two different places. If you are using JavaScript, you do this by including configuration parameters between the <object> tags in the player publishing code. The JavaScript player configuration parameters take this form:
<param name="adServerURL" value="http://someadserver" />
If you are using ActionScript, you do this by including configuration parameters in the init function in the player publishing code. The ActionScript player configuration parameters take this form:
config["adServerURL"] = "http://someadserver";
The following table lists the supported player configuration parameters for advertising operations. For a list of all supported player configuration parameters, see Player configuration paramaters. Note that all of these parameter names are case-sensitive.
| parameter | type | description |
|---|---|---|
| additionalAdTargetingParams | String | Additional values to append to the URL on each ad request to the ad server. |
| adServerURL | String | The URL of an ad server to use instead of the default ad server. This URL can also be set in the Advertising module. |
| overrideAds | Boolean | If set to true, the player will not make calls to the default ad server. Instead, the player continues to determine when an ad should be requested based on its ad logic but instead of calling to an external server, it halts playback; instead of passing the ad formats to the external code, it passes the player context (for example, title and lineupId) and allows your code to serve ads accordingly. The same result can be achieved by using the Advertising API method enableOverrideAds. |
| externalAds | Boolean | If set to true, the player will broadcast the 'externalAd' event if an unknown ad type is returned from an ad server. The same result can be achieved by using the API method enableExternalAds. |
| playlistTargeting | String | Additional playlist value to append to the URL on each ad request to the ad server. This parameter works only with DoubleClick DART for Publishers. It allows for ad targeting to or reporting on playlists by setting the playlist as a zone for ad targeting purposes. This string value can be either "playlistName" to target using the display name of a playlist, "playlistID" to target using the Brightcove-generated playlist ID, or "playlistRefID" to target using the publisher-specified playlist reference ID. Since the ad request will contain your playlist reference ID, you should avoid using as part of your reference IDs question marks (?), semi-colons (;), or any other character that might be used as a parameter delimiter. See the usage examples. |