1. Overview of all VisxCallbacks
2. Setting Keyword Targeting
3. Setting Advertising Label (Banner only)
4. Disable Resizing (Banner only)
5. Header Bidding, Lazy Loading

Overview of all VisxCallbacks

The following VisxCallbacks are available for both banner and interstitial placements You can use them for adding logic from your app between an ad call, ad rendering and disposal.

var visxCallback = VisxCallbacks() {
	override fun onAdRequestStarted(visxAdManager: VisxAdManager?) {
		Log.i("onAdRequestStarted()")
	}

	override fun onAdResponseReceived(visxAdManager: VisxAdManager, price: Double, currency: String) {
		Log.i("onAdResponseReceived()")
	}

	override fun onAdLoadingStarted(visxAdManager: VisxAdManager?) {
		Log.i("onAdLoadingStarted()")
	}

	override fun onAdLoadingFinished(visxAdManager: VisxAdManager?, message: String?) {
		Log.i("onAdLoadingFinished() $message")
		Log.i("Ad is ready to be displayed")
	}

	override fun onAdLoadingFailed(message: String?, errorCode: Int, isFinal: Boolean) {
		Log.i("onAdLoadingFailed() $message errorCode: $errorCode")
	}

	override fun onAdSizeChanged(width: Int, height: Int) {
		Log.i("onAdSizeChanged()")
	}

	override fun onAdClicked() {
		Log.i("onAdClicked()")
	}

	override fun onAdLeftApplication() {
		Log.i("onAdLeftApplication()")
	}

	override fun onAdResumeApplication() {
		Log.i("onAdResumeApplication()")
	}

	override fun onVideoFinished() {
		Log.i("onVideoFinished()")
	}

	override fun onEffectChange(effect: String?) {
		Log.i("onEffectChange() -> effect: $effect")
	}

	override fun onLandingPageOpened(inExternalBrowser: Boolean) {
		Log.i("onLandingPageOpened. inExternalBrowser = $inExternalBrowser")
	}

	override fun onLandingPageClosed() {
		Log.i("onLandingPageClosed()")
	}

	override fun onInterstitialWillBeClosed() {
		Log.i("onInterstitialWillBeClosed()")
	}

	override fun onInterstitialClosed() {
		Log.i("onInterstitialClosed()")
	}

	override fun onAdClosed() {
		Log.i("onAdClosed()")
	}
}

Setting Keyword Targeting

The VIS.X® SDK allows setting individual key-value targeting for placements. This can be useful, among other things, if contextually different blocklists or floor prices are used for one ad unit (e.g., channel targeting).

For these targetings to be effective, an individual agreement with the account manager is necessary so that they can also be implemented on the YOC backend configuration.

Key-values are structured as a HashMap<String, String>. The first parameter represents the key, and the second parameter is the value. You can send the key values using the .customTargetParams() from the Builder of VisxAdManager.

var customTargetingParams = HashMap<String, String>()
customTargetingParams.put("age","20-30,30-50")
customTargetingParams.put("sport-cars","Porsche,Audi")
customTargetingParams.put("channel","Finance")

The following constraints apply when using custom key-value targeting:

For Keys:

• Keys must consist of [\w_-\d] Unicode word characters, incl. [0-9_-]
• Up to 5 keys are accepted in a single ad call
• Keys are OR combined
• Keys must have at least one value. Pure key targeting is not accepted
• Keys must not use breakable and non-breakable spaces

For Values:

• Values must consist [\w_-\d] Unicode word characters, incl. [0-9_-]
• Multiple values are accepted, they need to be comma-separated
• Values are OR combined
• Values must not use breakable and non-breakable spaces
• Values associated with a key will be overridden if a key is pushed again

Setting Advertisement Label (Banner only)

The EU Directive 2000/31/EC declares “[..] commercial communication shall be identifiable as such”. Non-EU countries may also require similar identifiability of advertising. Advertising should be labeled and visually separated from editorial content. The VIS.X® SDK offers the setup of an Advertising Label above all our creatives, using the .setAdvertisingLabel() from the Builder of VisxAdManager.

Disable Resizing (Banner only)

To play high-impact ad formats from YOC, VIS.X ad units must be able to adjust the size of the adContainer by default. However, there are positions in the app where this is simply not possible. In this case, the resizing can be restricted with the Builder Method .fixedSize(). As it will heavily affect monetization, it is advised to use .fixedSize() only if needed and report usage to your YOC account manager, to remove high-impact ads for that ad unit.

Header Bidding, Lazy Loading

The default life cycle of ads in the SDK is split into two steps:

1. The app requests an ad, VIS.X® will respond with an ad and prepare the ad to be displayed, by creating a WebView immediately
2. The app will listen to onAdLoadingFinished, pick up the VisxAdView and add it as a SubView into the ViewHierachy

This workflow is based on the assumption that the publisher asks for an ad whenever they need one. However, there are also scenarios where the app wants to ask an ad, but not necessarily render them, e.g. in a header bidding scenario or when prefetching ads is performed to increase the overall speed of the app.

For this kind of scenario, the VIS.X® SDK can split the delivery into three steps:

1. The app requests an ad, VIS.X® will respond with an ad and call onAdResponseReceived with a Price and a CurrencyThe app decides to initiate the render process by calling renderAd method, initiating the WebView
2. The app will listen to onAdLoadingFinished, pick up the VisxAdView and add it as a SubView into the ViewHierachy

To enable this feature use the builder method headerBidding in your ad request.

override fun onAdResponseReceived(visxAdManager: VisxAdManager, price: Double, currency: String) {
	// ad is received and ready to be rendered as a webView
	visxAdManager.renderAd()
	// when the ad is finally rendered onAdLoadingFinished is called
}