Interacting with an ad

Functions

Calling new OwAd() will return a javascript object which you can later use to control and interact with the displayed ad. The object has the following functions you can call to achieve the interaction:

Function Description
refreshAd
  • Refresh ad and load a new one
  • Please note that this will cause the ad to scroll into view (if not visible)
removeAd
  • Removes the current ad from the DOM

 

Events

You can use the Overwolf ad object (the one created by calling new OwAd()) to listen to events related to the displayed ad. Registering for an event can be done by calling the function addEventListener on the ad object. Like many other libs, the first param sent to addEventListener is the name of the event, and the second is a handler function for the event.

The following events are supported:

Event Name Fired when
player_loaded
  • Ad video player was successfully loaded on the page *
display_ad_loaded
  • Display ad was served instead of a video ad
play
  • Ad started playing *
impression
  • Video “impression” – Depends on the advertiser, the impression event gets triggered after 0-6 seconds *
complete
  • Video ad was played until its end *
error
  • Error occurred while trying to load ad *

* – Only relevant for video ads

 

Showing multiple ads

If for some reason you wish to show more than one ad on your app, you can easily do so by creating multiple instances of OwAd. Just make sure you pass a different container element for each instance.