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
| Feature | Android | iOS |
|---|---|---|
initializeSdk(nonTrackingUrl:) | Ignored | ✓ |
setSourceApp, setItunesId (SKAdNetwork) | Ignored | ✓ |
PrebidFullscreenControls.supportSKOverlay | Ignored | ✓ (core and GAM) |
PrebidFullscreenControls.isAutoCloseOnCompletionEnabled | Ignored | ✓ (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, globalOrtbConfig | Ignored: 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.setDebugLogFileEnabled | Ignored | ✓ |
PrebidMobile.getTimeoutMillisDynamic | null: 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.setLocationUpdatesEnabled | Ignored: Android reads the last known location | ✓ |
PrebidTargeting.getAppKeywords, getSourceApp, getItunesId | Empty / null | ✓ |
PrebidInstreamVideoAd.generateInstreamUriForGam sizes | Any | 400x300, 640x480 and 320x480 only (others throw) |
Banner videoParameters (core, GAM, AdMob, MAX) | SDK defaults | ✓ |
Interstitial / rewarded videoParameters | maxDuration 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
| Topic | Native difference | What you get |
|---|---|---|
| Banner auto-refresh | iOS refreshes every 60 s by default and clamps 0 to 15 s | null / 0 disables refresh on both |
| Original API auto-refresh | Prebid Android's PrebidAdUnit can't refresh; iOS ignores intervals under 30 s | Refresh works on both, clamped to 30–120 s |
| Status check disabled | iOS reports "skipped" | succeeded on both |
| Empty seat bid | Android reports success | prebidDemandNoBids on both |
| Requests before init | Android drops them silently | onAdFailed / prebidSdkNotInitialized, in every package (GAM native: onFetchDemandFailed('prebidSdkNotInitialized'), then the GAM ad loads alone) |
| Native impression | Fired 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 onAdClicked | iOS reports a click that leaves the app through a separate callback | onAdClicked for every click, once (core and GAM banners) |
| Native custom layout clicks | Prebid Android clicks a registered view; Prebid iOS has no click API | PrebidNativeAd.performClick on both |
| Stored auction response | Prebid iOS clears it when a banner is deallocated | Kept until you clear it |
PrebidTargeting.setAppName | Prebid iOS has no app-name setter | Sent on both; on iOS through the global OpenRTB config (your own app.name there wins on both) |
| Creative factory timeouts | iOS stores seconds | Milliseconds on both |
pbAdSlot on interstitial / rewarded (every package) and on AdMob / MAX banners | Prebid iOS has no setter on these units | Set on both; on iOS through imp.ext.data.pbadslot in impOrtbConfig (yours wins) |
gpid on the core banner, interstitial and rewarded ads | Neither SDK has a setter on these units | Set on both through imp.ext.gpid in impOrtbConfig (yours wins) |
PrebidTargeting.setUSPrivacyString | Neither SDK has a setter: both read IABUSPrivacy_String from the IAB storage | Written to the IAB storage (SharedPreferences / UserDefaults), so it persists across launches until cleared with null, like a CMP's value |
| Google Mobile Ads version check | Prebid checks the GMA version only when the app passes it | With GMA linked, initializeSdk passes it on both (a warning in the log if Prebid doesn't support it) |
Log level none | Prebid iOS has no such level | Silent on both |
PrebidMobile.setLogListener | Android filters by level before its logger; iOS's logger replaces the console one | Messages 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):
setPrebidServerUrlthrows for a malformed URL and leaves thenonTrackingUrlfrominitializeSdkin place;getPrebidServerUrlreturns the URL the current user's auctions use. - Rendering API caching (iOS): creating an Original API ad unit turns
useCacheForReportingWithRenderingApion. - Native request
extfields: an asset'sext(on itstitle,imgordataobject) is sent on both platforms;NativeAsset.assetExtandNativeEventTracker.extonly on Android, because Prebid iOS has no asset-levelextand doesn't serialize the tracker's. - Log levels: Android has no
verboseorsevere: they log atdebuganderror. - 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,prebidInvalidAdObjectandprebidInvalidNativeRequeston Android;prebidUnknownError,prebidInvalidResponseStructure,prebidInternalSDKError,prebidWrongArguments,prebidNoVastTagInMediaDataandprebidSDKMisuseon 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 withsetCreativeFactoryTimeoutandsetCreativeFactoryTimeoutPreRenderContent.BannerView.setStoredAuctionResponse(iOS): it sets the process-wide stored auction response, not one for the banner. UsePrebidMobile.setStoredAuctionResponse.- Native
getWinEvent/getImpEvent(Android): Prebid fires the win and impression events itself. The Original API returns them inPrebidBidResponse.eventsfor 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).