Controls
UI elements overlaid on the ad are enabled with the controls parameter (in WebView) or the settings.controls field (in the browser). Elements are disabled by default.
| Value | Element | Android | Android TV | iOS | Browser |
|---|---|---|---|---|---|
ad-skip-btn | Skip button | ✓ | ✓ | ✓ | ✓ |
ad-click-btn | Click-through button to the advertiser's site | ✓ | ✓ | ✓ | |
ad-more-menu | "Learn more" menu: ERID and advertiser | ✓ | ✓ | ||
ad-disable-btn | "Disable ads" button | ✓ | ✓ | ✓ | |
ad-info | ERID and advertiser shown on screen | ✓ | |||
ad-notice | Caption explaining the ad, in a screen corner | ✓ | |||
all | All elements available on the platform | ✓ | ✓ | ✓ | ✓ |
In the browser, the play/pause button, volume control, progress bar, remaining time, and ERID are always shown.
ad-skip-btn
Appears once the ad becomes skippable. Clicking it skips the ad: the SDK sends AdSkipped.
ad-click-btn
Opens the advertiser's site; the SDK sends AdClick with the link. Shown only if the creative has a click-through link. The button text comes from the VAST linkTxt extension; the default is "Learn more" (this text is localized, based on the lang parameter).
ad-more-menu
An expandable menu with ERID and advertiser information. Shown only if the VAST contains an AdTune extension with show: 1.
ad-disable-btn
Button that disables ads. The SDK doesn't handle the click itself — it sends the AdDisable event. The app carries out any follow-up action (for example, showing a subscription-purchase screen).
ad-info
Android TV only. ERID and advertiser information stay visible on screen.
ad-notice
Android TV only. A caption noting that ads keep the service free.