com.facebook.ads

Interface NativeAdBase.NativeAdLoadConfigBuilder

All Superinterfaces:

Ad.LoadConfigBuilder

Enclosing class:

NativeAdBase

public static interface NativeAdBase.NativeAdLoadConfigBuilder
extends Ad.LoadConfigBuilder

Builder that allows to configure an ad loading.

Since:

5.5

Field Summary

Fields

Modifier and Type	Field and Description
static int	UNKNOWN_IMAGE_SIZE Constant for withPreloadedIconView(int, int) that means that preloaded bitmap will have default size.

Method Summary

Modifier and Type	Method and Description
NativeAdBase.NativeLoadAdConfig	build() Builds a NativeAdBase.NativeLoadAdConfig that can be used to load an ad.
NativeAdBase.NativeAdLoadConfigBuilder	withAdListener(NativeAdListener adListener) Sets an InterstitialAdListener to be notified on events in control lifecycle.
NativeAdBase.NativeAdLoadConfigBuilder	withBid(java.lang.String bidPayload) Allow to loads an ad from the payload supplied with a bid.
NativeAdBase.NativeAdLoadConfigBuilder	withMediaCacheFlag(NativeAdBase.MediaCacheFlag mediaCacheFlag) This method allows to disable pre-caching for the ads while NativeAdBase.loadAd() pre-cache ad assets by default.
NativeAdBase.NativeAdLoadConfigBuilder	withPreloadedIconView(int width, int height) Allow to pre-load an native ad icon image into memory that allows instantly populate the image into MediaView or android.widget.ImageView during ad loading (if cache is enabled) or during NativeAdBase.downloadMedia() call (if cache is disabled).

Field Detail

UNKNOWN_IMAGE_SIZE

static final int UNKNOWN_IMAGE_SIZE

Constant for withPreloadedIconView(int, int) that means that preloaded bitmap will have default size. Note. For optimal performance you should avoid using this value and pass exact size of MediaView or android.widget.ImageView.

See Also:

Constant Field Values

Method Detail

withAdListener

NativeAdBase.NativeAdLoadConfigBuilder withAdListener(NativeAdListener adListener)

Sets an InterstitialAdListener to be notified on events in control lifecycle.

Parameters:

adListener - the listener

Since:

5.6

withBid

NativeAdBase.NativeAdLoadConfigBuilder withBid(java.lang.String bidPayload)

Allow to loads an ad from the payload supplied with a bid.

Specified by:

withBid in interface Ad.LoadConfigBuilder

Parameters:

bidPayload - The payload supplied with the bid

Returns:

NativeAdBase.NativeAdLoadConfigBuilder

Since:

5.5

withMediaCacheFlag

NativeAdBase.NativeAdLoadConfigBuilder withMediaCacheFlag(NativeAdBase.MediaCacheFlag mediaCacheFlag)

This method allows to disable pre-caching for the ads while NativeAdBase.loadAd() pre-cache ad assets by default.

However, please be aware that once you disable pre-caching, there is a risk that ad assets might not be loaded in time when an ads is shown at some cases like unstable internet connection, etc. As an impression will not be logged until ad media contents are properly shown, failure to load ad assets in time might result in lagging an impression even if adView is visible (and possibly not getting an impression at worst case).

In order to check if an impression is logged or not, please look at AdListener.onLoggingImpression(Ad)

Parameters:

mediaCacheFlag - pre-cache option for ad assets.

Returns:

NativeAdBase.NativeAdLoadConfigBuilder

Since:

5.5

withPreloadedIconView

NativeAdBase.NativeAdLoadConfigBuilder withPreloadedIconView(int width,
                                                             int height)

Allow to pre-load an native ad icon image into memory that allows instantly populate the image into MediaView or android.widget.ImageView during ad loading (if cache is enabled) or during NativeAdBase.downloadMedia() call (if cache is disabled).

Parameters:

width - width of the icon view or UNKNOWN_IMAGE_SIZE

height - height of the icon view or UNKNOWN_IMAGE_SIZE

Returns:

NativeAdBase.NativeAdLoadConfigBuilder

Since:

5.5

See Also:

NativeAdLoadConfigBuilder#withMediaCacheFlag(MediaCacheFlag), NativeAdBase.downloadMedia()

build

NativeAdBase.NativeLoadAdConfig build()

Builds a NativeAdBase.NativeLoadAdConfig that can be used to load an ad.

Specified by:

build in interface Ad.LoadConfigBuilder

Since:

5.6