Skip to main content
Version: v1.0.0

Platform differences

The plugin reports the same callbacks and result codes on both platforms. Where the native SDKs differ and the plugin can't close the gap, the difference is listed here.

Not available on one platform​

FeatureAndroidiOS
initializeSdk(nonTrackingUrl:)Ignored✓
setSourceApp, setItunesId (SKAdNetwork)Ignored✓
PrebidFullscreenControls.supportSKOverlayIgnored✓ (core and GAM)
PrebidFullscreenControls.isAutoCloseOnCompletionEnabledIgnored✓ (interstitials only)
Rewarded skip controls✓Ignored
Rewarded adFormats (core) and minimum size (PrebidFullscreenControls.minSizePercentage, core and GAM; AdMob and MAX rewarded have none)Ignored✓
Original API pbAdSlot, impOrtbConfig, globalOrtbConfig on a request mixing formats (a PrebidMultiformatAd with two or more of banner, video and native)Ignored: Prebid Android's multiformat PrebidAdUnit has no setters; use PrebidTargeting.setGlobalOrtbConfig. Single-format units send them on both✓
AdMob native impOrtbConfig, globalOrtbConfigIgnored: no setter on Prebid's mediation native unit✓
Native response image width / height (PrebidNativeImage)null✓
Interstitial / rewarded winningBid (core)✓null: Prebid iOS keeps the bid internal
Interstitial / rewarded adPosition (core)Ignored: no setter on Prebid Android's fullscreen units✓
PrebidMobile.setDebugLogFileEnabledIgnored✓
PrebidMobile.getTimeoutMillisDynamicnull: Prebid Android writes Prebid Server's timeout into getTimeoutMillis✓
PrebidTargeting.setBundleName (app.bundle override)✓Ignored: iOS sends the bundle ID or the iTunes ID
PrebidMobile.setLocationUpdatesEnabledIgnored: Android reads the last known location✓
PrebidTargeting.getAppKeywords, getSourceApp, getItunesIdEmpty / null✓
PrebidInstreamVideoAd.generateInstreamUriForGam sizesAny400x300, 640x480 and 320x480 only (others throw)
Banner videoParameters (core, GAM, AdMob, MAX)SDK defaults✓
Interstitial / rewarded videoParametersmaxDuration caps the rendered video✓ every field
App keywords (PrebidTargeting.addAppKeyword and the rest)Logged and ignored: set app.keywords with setGlobalOrtbConfig✓
Original API SKAdNetwork (activateBannerSKAdNetwork, activateInterstitialSKAdNetwork, activateSKOverlay, supportSKOverlay)No-ops✓

Behavior the plugin aligns​

TopicNative differenceWhat you get
Banner auto-refreshiOS refreshes every 60 s by default and clamps 0 to 15 snull / 0 disables refresh on both
Original API auto-refreshPrebid Android's PrebidAdUnit can't refresh; iOS ignores intervals under 30 sRefresh works on both, clamped to 30–120 s
Status check disablediOS reports "skipped"succeeded on both
Empty seat bidAndroid reports successprebidDemandNoBids on both
Requests before initAndroid drops them silentlyonAdFailed / prebidSdkNotInitialized, in every package (GAM native: onFetchDemandFailed('prebidSdkNotInitialized'), then the GAM ad loads alone)
Native impressionFired when a tracker request succeeds (never without trackers)PrebidNativeAdView: viewability, half the view for 1 s, including Flutter's clipping, once per ad. PrebidGamNativeAd keeps Prebid's tracker callback
Banner onAdClickediOS reports a click that leaves the app through a separate callbackonAdClicked for every click, once (core and GAM banners)
Native custom layout clicksPrebid Android clicks a registered view; Prebid iOS has no click APIPrebidNativeAd.performClick on both
Stored auction responsePrebid iOS clears it when a banner is deallocatedKept until you clear it
PrebidTargeting.setAppNamePrebid iOS has no app-name setterSent on both; on iOS through the global OpenRTB config (your own app.name there wins on both)
Creative factory timeoutsiOS stores secondsMilliseconds on both
pbAdSlot on interstitial / rewarded (every package) and on AdMob / MAX bannersPrebid iOS has no setter on these unitsSet on both; on iOS through imp.ext.data.pbadslot in impOrtbConfig (yours wins)
gpid on the core banner, interstitial and rewarded adsNeither SDK has a setter on these unitsSet on both through imp.ext.gpid in impOrtbConfig (yours wins)
PrebidTargeting.setUSPrivacyStringNeither SDK has a setter: both read IABUSPrivacy_String from the IAB storageWritten to the IAB storage (SharedPreferences / UserDefaults), so it persists across launches until cleared with null, like a CMP's value
Google Mobile Ads version checkPrebid checks the GMA version only when the app passes itWith GMA linked, initializeSdk passes it on both (a warning in the log if Prebid doesn't support it)
Log level nonePrebid iOS has no such levelSilent on both
PrebidMobile.setLogListenerAndroid filters by level before its logger; iOS's logger replaces the console oneMessages at or above the log level, instead of the console, on both

Remaining differences​

  • Banner refresh bounds: Prebid clamps the banner interval to 30–120 s on Android and 15–120 s on iOS.
  • Banner impression tracker (Original API): iOS tracks the current bid; Android attaches the GAM view when the next auction starts. See impression tracking.
  • Runtime server switch (iOS): setPrebidServerUrl throws for a malformed URL and leaves the nonTrackingUrl from initializeSdk in place; getPrebidServerUrl returns the URL the current user's auctions use.
  • Rendering API caching (iOS): creating an Original API ad unit turns useCacheForReportingWithRenderingApi on.
  • Native request ext fields: an asset's ext (on its title, img or data object) is sent on both platforms; NativeAsset.assetExt and NativeEventTracker.ext only on Android, because Prebid iOS has no asset-level ext and doesn't serialize the tracker's.
  • Log levels: Android has no verbose or severe: they log at debug and error.
  • Interstitial and rewarded "leaving the app": iOS reports it separately from the click; the plugin reports the click (onAdClicked) on both and doesn't forward it.
  • Result codes: both platforms report the same names for the same outcome. A few exist on one platform only: prebidInvalidContext, prebidInvalidAdObject and prebidInvalidNativeRequest on Android; prebidUnknownError, prebidInvalidResponseStructure, prebidInternalSDKError, prebidWrongArguments, prebidNoVastTagInMediaData and prebidSDKMisuse on iOS.
  • Prebid version: Android pins an exact Prebid version, iOS accepts a range. See Compatibility.

Not exposed, on purpose​

  • PrebidMobile.setPbsConfig (Android): Prebid writes it from Prebid Server's response (ext.prebid.passthrough), overwriting any value the app sets. Set the creative timeouts with setCreativeFactoryTimeout and setCreativeFactoryTimeoutPreRenderContent.
  • BannerView.setStoredAuctionResponse (iOS): it sets the process-wide stored auction response, not one for the banner. Use PrebidMobile.setStoredAuctionResponse.
  • Native getWinEvent / getImpEvent (Android): Prebid fires the win and impression events itself. The Original API returns them in PrebidBidResponse.events for apps that report them on their own.
  • Plugin renderers (registerPluginRenderer): a renderer is a native object, so register it from the app's native code (MainActivity / AppDelegate) before loading ads; Prebid then uses it for the plugin's ads too. The plugin's views don't forward the renderers' own events (PluginEventListener).