...
Code Block | ||
---|---|---|
| ||
myPlacement = new avDisplay(placementConfig);
myPlacement.play(); |
Putting it all together
Code Block | ||
---|---|---|
| ||
<div id="aniplayer"></div> <script type="text/javascript" id="aniviewJS"> (function() { var myPlacement; var placementConfig = { publisherId: '[Publisher_ID]', channelId: '[Channel_ID]', ref1: '', width: 300, height: 250, errorLimit: 5, position : 'aniplayer' }; (new Image).src = "https://track1.aniview.com/track?pid="+placementConfig.publisherId+"&cid="+placementConfig.channelId+"&e=playerLoaded"+"&cb="+Date.now(); var placementUrl = 'https://player.aniview.com/script/webm/ads.js'+'?v=1&type=s&pid='+placementConfig.publisherId; function downloadScript(src,adData) { var scp = document.createElement('script'); scp.src = src; scp.onload = function() { myPlacement = new avDisplay(placementConfig); myPlacement.play(); }; document.getElementsByTagName('head')[0].appendChild(scp); }; downloadScript(placementUrl,placementConfig); })(); </script> |
...
Name | Mandatory | Default Value | Values | Description | |||
publisherId | Yes | String | Aniview publisher id | ||||
channelId | Yes | String | Aniview channel id from the same account of the publisher id used | ||||
position | Yes | String | the div id where the player should be created | ||||
width | yes | Number | The player width in pixels If width = 100 and height = 0, width is auto detected based on containing element | ||||
height | yes | Number | The player height in pixels If width = 100 and height = 0, height is auto detected based on containing element and is calculated as width / 1.777 | ||||
creativeDimensions | No | [{ w: Number, h: Number }] | Specific dimensions for the creatives to be rendered to this placement. | ||||
autoStart | No | true | Boolean | Immediately start showing an ad after the initialization | |||
refresh | No | Object | refresh Refresh policy config | ||||
strategy | No | Interval | String | AutoStart, Interval, None | interval interval | “interval”, “none” | Auto-refresh an ad or manually control it via API |
minViewTime | No | 5 000 | Number | Minimum time in milliseconds an ad should be in view before the next refresh | |||
minRenderTime | No | 30 000 | Number | Minimum time in milliseconds (30 000 / 60 000 / 90 000 miliseconds) between refreshes | |||
noNewInventory | No | false | Boolean | Don’t send inventory reporting | |||
maxRun | No | 9999 | Number | Maximum number of waterfall runs in the player session | |||
maxImp | No | 9999 | Number | Maximum number of impressions per player session | |||
errorLimit | No | 5 | Number | Maximum number of (1 + vastRetry) runs of the waterfall that do not generate impression. This means (1 + vastRetry) * (1 + errorLimit) - max number of consecutive waterfall runs that do not generate impression If there is an impression the counter reset to 0 | |||
ref1 | No | String | Macro list ref1: “AV_MACRO1=value1&AV_MACRO2=value2“ Values should be URL encoded | ||||
clickThrough | No | Object | Show or not the skip button | ||||
url | No | String | Clickthrough url when clicking on the ad |
...
Returns the ad height in pixels inside the placement.
next(force: boolean)
Start/resume the placement instance, including ad flow. force
flag means you want to kill the current refresh.minViewTime
and refresh.minRenderTime
timers and force the next ad to be requested instead of showing again the current ad if these timers didn’t pass yet.
stop()
Stop the placement, including ad flow.
requestBids()
Allows manually request bids if the refresh strategy is “none”.
renderAd()
Allows manually render the next winning bid’s HTML if the refresh strategy is “none”.
showAd()
Shows the ad inside the placement.
...
Event name | Description | ||
---|---|---|---|
AdImpression | Called when there is an impression, regardless of creative type.
| ||
AdError | Called by the player every time it finish running 1 + vastRetry waterfall runs without impression Called also whenever the player decides that it should stop running, for example when maxImp or maxRun is reached, in this case the event will pass a parameter: {errorlimit: true} to indicate the player is stopping calls for ads | ||
Inventory | Called when the player is initialized | ||
InventoryRequest | Called every time the player starts a waterfall run | ||
AdShow | Will be triggered on each | ||
AdHide | Will be triggered on each |
Sample Events
Player Initialized Event
...
Code Block | ||
---|---|---|
| ||
player.on("Inventory", function () { // Player is initialized }); |
...
Code Block | ||
---|---|---|
| ||
player.on("AdImpression", function () { // Ad impression occured }); |
...
Code Block | ||
---|---|---|
| ||
player.on("AdError", function (resevent) { if(res && res (event.detail.errorlimit) { // Player stopped } }); |
Placement Behavior
The player support advanced behaviors such as In Article, Floating, Sticky and many customizations.
...
The player is created inside the position div with a unique id
Starting Template
In order to start running a template with the below configuration options, it is required to call startTemplate passing the element of the parent of the position passed in position. In this case it will be the aniBox element
Code Block |
---|
player.startTemplate(document.getElementById(placementConfig.position).parentNode) |
Templates Configuration
The templates configuration ads additional configurations to placementConfigThose configurations are used only if startTemplate is called .
Name | Mandatory | Default Value | Values | Description |
---|---|---|---|---|
reqOnView | true | Boolean | If set to true, the player will run the waterfall and call ad sources only when in view. When out of view, when its time to call the ad sources, the player will verify that its in view and if not it will wait till the player is in view | |
startOnView | true | Boolean | If set to true, the player will start only when in view. This means that inventory will be sent only when in view and the player loads | |
vitab | false | Boolean | If set to true, tab viewability is taken into account when checking viewability |