Interstitial (v5)

SDK provide interstitial feature from the SDK >= 5.0.5

The module enable you to display a full image screen or a webview to your users. It can be launched automaticly by the SDK at the application startup or manually.

Module configuration

The interstitial component configuration must be properly setted from 4 parameters :

  • "active" must be enabled to allow it use.
  • "auto" allow you to start the module as soon as the online configuration is aquired.
  • "delay" define the waiting time before to launch the interstitial view
  • "display_limit" specify the duration limit from which no more interstitial will be displayed. This is to avoid to spam user at app resume.
"interstitial": {
    "active": true,
    "auto": true,
    "delay": 3,
    "display_limit": 60
}

In this example, an interstital will be launched 3 seconds after application startup (technically after configuration acquired) only if no interstitial has been displayed 60 seconds before.

Manual use

If you do not want SDK to launch automaticly the interstitial, you have to set "auto" configuration to false and call this method :

APInterstitialManager.start()

It could be convenient to display interstitial only from a specific view. For example, you should want to display interstitial for logged users only.

Image

Image is displayed according user screen orientation in maximum size without cropping any edge.
In fact, the module try to display the picture in the best apropriated format :
If the user is in landscape mode, the module will use landscape image url if available else the landscape one. The image will be displayed at it maximum horizontal or vertical size according screen orientation.

If the interstitial specify a redirect url, a simple tap on the picture will redirect user on web browser.

Webview

All links in the webview are overrided to launch it in user external browser.

Closing interstitial

To close interstitial view, you can tap on the top right cross or with return navigation button.