audienzz_sdk_flutter

✨ New

• Manual banner pause/resume is now honored on iOS. pauseAutoRefresh() / resumeAutoRefresh() (and the all-ads variants) previously no-opped on iOS — the visibility poll would auto-resume within half a second. They now suppress the poll while paused, so a same-route overlay (dialog / OverlayEntry) that the native geometry check can't see correctly pauses refresh. Android already honored these.

🐛 Fixes

Revenue & bidding

• iOS banners were dropping every bid signal. bannerParameters / videoParameters (API frameworks, protocols, placement, playback, bitrate, duration) were assigned into an uninitialized object and silently discarded. They now reach the bid request.
• iOS rewarded video was sending maxduration = 1s (a copy-paste assigned maxDuration twice); minDuration is now set correctly, so SSPs stop no-bidding the slot.
• iOS interstitial no longer overwrites your impOrtbConfig. The multisize workaround used to replace the publisher config (dropping deals / floors / first-party data); the sizes are now merged into it. Interstitial video requests also carry API / bitrate / duration signals.
• Schain-less remote config no longer throws during decode (schain is optional).

Reliability & lifecycle

• Remote-config cold start no longer strands a session with zero ads. When the first config fetch failed with no usable cache, the native SDK was never initialized — even after connectivity returned. Background polling now completes initialization once config becomes available.
• Disposed banners stop auctioning. Dispose now stops auto-refresh and tears down the banner view/timers on both platforms; iOS full-screen ads no longer leak their view, handler, and GAM ad on every load.
• A failed native ad load no longer registers the ad forever. Previously the entry stuck around and retries silently no-opped; the failure now surfaces through onAdFailedToLoad.
• Ad lookups no longer collide two identically-configured ads — the registry keys by object identity.

Error handling & robustness

• Full-screen show/present failures are surfaced on both platforms instead of hanging or being misreported as load failures; single-use ads are guarded against a silent second show.
• Android showAdWithoutView no longer crashes with IllegalStateException (it replied twice on a failed show).
• iOS rootViewController resolution no longer force-crashes scene-based / add-to-app hosts.
• AudienzzStickyAdWrapper no longer crashes when used outside a scrollable.
• getUserExt() and external-ID decoding no longer throw on the platform map type.
• Unloaded show() / getPlatformAdSize() now throw a real StateError (instead of a release-stripped assert), and a missing reward is logged rather than thrown inside the channel handler.
• The remote-config cache is namespaced by publisher id + URL, so switching publisher/endpoint can't serve a stale config.

⬆️ Dependencies

• iOS: AudienzziOSSDK ~> 0.2.7 (Google Mobile Ads SDK 13, min iOS 15)
• Android: com.audienzz:sdk 0.1.7

• Honor pauseAutoRefresh() / resumeAutoRefresh() (and the all-ads variants) on iOS: a manual pause — e.g. when a same-route overlay covers the banner, which the native geometry poll can't detect — is no longer auto-resumed by the visibility poll within half a second (Android already honored these)
• Fix remote-config cold start: when the initial config fetch failed with no usable cache, the native SDK was never initialized (zero ads for the whole session even after connectivity returned) — background polling now completes initialization once config becomes available
• Fix iOS banner ads dropping all bid signals: bannerParameters / videoParameters (API frameworks, protocols, placement, playback, bitrate, duration) were assigned into an uninitialized object and silently discarded — they now reach the bid request
• Fix iOS rewarded video sending maxduration = 1s (a copy-paste set maxDuration twice); minDuration is now set correctly
• Fix iOS interstitial overwriting the publisher's impOrtbConfig with the multisize workaround — the sizes are now merged into the publisher config instead of replacing it; interstitial video requests also carry API/bitrate/duration signals
• Fix a schain-less remote config throwing during decode (schain is optional)
• Fix ad lookup colliding two identically-configured ads (registry now keys by object identity)
• Fix a failed native ad load leaving the ad registered forever and silently no-opping retries — the failure now surfaces through onAdFailedToLoad
• Fix Android showAdWithoutView replying twice on a failed show (raised IllegalStateException); failed full-screen shows are now surfaced instead of silently reported as success, with a single-use guard against a second show
• Fix disposed banners continuing to run Prebid auctions: dispose now stops auto-refresh and tears down the banner view/timers on both platforms; iOS full-screen ads no longer leak their view/handler/GAM ad
• Fix StickyAdWrapper crashing when used outside a scrollable
• Fix getUserExt() and external-ID decoding throwing on the platform map type
• Namespace the remote-config cache by publisher id + URL so switching publisher/endpoint can't serve a stale config
• Surface show/present failures for full-screen formats on both platforms instead of hanging or misreporting them; iOS rootViewController resolution no longer force-crashes scene-based / add-to-app hosts
• Bump native dependencies to AudienzziOSSDK 0.2.7 and com.audienzz:sdk 0.1.7, which carry the corresponding native audit fixes

Fixes several iOS-only issues that caused ads to fill on Android but rarely on iOS:

• External user IDs (EIDs) now sent correctly on iOS — they were being dropped from the bid request, starving demand.
• Banner ads now set a root view controller before loading — prevents failed loads and missing impressions on iOS.
• Lazy load no longer defaults on by accident on iOS.
• Fixed malformed schain JSON generated during remote initialization.
  No integration changes required — upgrade to 0.1.8 and run flutter pub get (+ pod install). No native SDK update needed.

• Fix iOS external user IDs (EIDs) never reaching the bid request: the values were stored under the uniqueIds key but the native SDK reads uids, so user.ext.eids went out with no IDs on iOS (Android was unaffected). EIDs now serialize correctly, restoring iOS demand/fill for publishers using external identity
• Fix iOS banner ads not setting a rootViewController on the GMA banner before load, which could cause failed loads and unrecorded impressions/clicks
• Fix iOS isLazyLoad defaulting to true when the argument was absent (now false, matching the Dart default) — an accidental lazy load never fetches inside a Flutter platform view on iOS
• Fix invalid schain JSON generated during remote initialization: asi/sid string values were interpolated unquoted, producing malformed JSON

New

• pauseAllAutoRefresh() / resumeAllAutoRefresh() — pause and resume auto-refresh across all loaded banner ads with one call. Use it when you present a full-screen surface the SDK can't detect on its own (a custom overlay, a native modal, a web view) so off-screen ads stop refreshing while hidden.
• Automatic same-route overlay detection — a smart-refresh banner covered by an OverlayEntry or dialog on the same route now pauses its auto-refresh automatically, via hit-testing, with no publisher code required. This complements the existing scroll-, route-, and lifecycle-based visibility handling.

Docs

• README now documents the consent → init → load order: obtain user consent before initializing the SDK and requesting ads.

• Add pauseAllAutoRefresh() / resumeAllAutoRefresh() to pause and resume auto-refresh across all loaded banner ads (e.g. when showing a full-screen overlay the SDK can't see)
• Auto-detect same-route overlay occlusion via hit-test: a smart-refresh banner covered by an OverlayEntry/dialog on the same route now pauses its auto-refresh without any publisher code
• Document consent/init order in the README — obtain user consent before initializing the SDK and loading ads

iOS: upgraded to AudienzziOSSDK 0.2.6 — no more PrebidMobile fork.

• Bumped AudienzziOSSDK to 0.2.6, which builds against stock PrebidMobile. The patched Prebid fork that 0.2.5 required is gone — integrators no longer pin audienzz-ios-prebid-sdk-fork. This fixes the CocoaPods install failure (could not find compatible versions for "AudienzziOSSDK" / fork resolution errors).
• iOS ads are now muted by default (via isApplicationMuted, backend-overridable) — carried in 0.2.6.

• Handle smart-refresh banner visibility entirely inside the SDK (scroll geometry, route changes, and app lifecycle) — no publisher-side visibility handling required
• Bump iOS native dependency to AudienzziOSSDK 0.2.6 (Google Mobile Ads SDK 13)
• Guard against isLazyLoad: true without smartRefresh: true on Flutter (off-screen ads would never load); lazy load is disabled with a log message for that combination

SmartRefresh is now handled by the SDK. AdWidget automatically pauses/resumes auto-refresh based on scroll visibility, route occlusion, and app lifecycle for any BannerAd with smartRefresh: true — no per-screen visibility code needed. You can delete your own pause/resume logic.

iOS upgraded to AudienzziOSSDK 0.2.5 (Google Mobile Ads 13, min iOS 15). Enables native setBridgeTargeting / updateGlobalTargeting and backend sticky-ad config.

Ads muted by default.

⚠️ iOS integration
AudienzziOSSDK 0.2.5 requires Audienzz's PrebidMobile fork — pin it in your Podfile, and set your app's iOS target to ≥ 15:

pod 'PrebidMobile', :git => 'https://github.com/audienzz/audienzz-ios-prebid-sdk-fork.git', :tag => '3.3.1-audienzz.1'
pod 'PrebidMobileGAMEventHandlers', :git => 'https://github.com/audienzz/audienzz-ios-prebid-sdk-fork.git', :tag => '3.3.1-audienzz.1'

Run flutter clean after changing pod pins.

• Mute GMA ads by default: bump native dependencies to AudienzziOSSDK 0.2.5 and com.audienzz:sdk 0.1.5, which set the GMA mute flag when the backend-driven app volume is 0

• Updated native dependencies — iOS bridge now requires AudienzziOSSDK 0.2.2+, Android bridge requires Audienzz SDK 0.1.3+
• Fixed OMID partner name and version not being set on Android (affects Open Measurement viewability measurement)
• Added au_flutter_v GAM targeting key so Flutter SDK traffic can be identified and targeted separately in ad reporting

• Fix initial delay and improve performance.

• Fix issue with isLazyLoad is being true by default

New Features

• Lazy loading — demand fetch is deferred until the ad approaches the viewport (isLazyLoad, default true)

• Smart refresh — auto-refresh pauses when the ad is off-screen and resumes with stale-aware timing when it returns (smartRefresh, default false; always on for RemoteBannerAd)

• Prefetch distance — configurable margin that triggers the demand fetch before the ad fully enters the viewport (prefetchMargin, default 200 dp/pt)
  Bug Fixes

• Fixed infinite loading when lazy loading is enabled

• Fixed iOS build failure on Xcode 16 (PrebidMobile pinned to ~> 3.0.0)

• Fixed static/dynamic hybrid linking conflict between Google-Mobile-Ads-SDK and PrebidMobile
  Dependencies

• iOS: AudienzziOSSDK 0.2.1

• Android: com.audienzz:sdk 0.1.1

New Features

• Lazy loading — demand fetch is deferred until the ad approaches the viewport (isLazyLoad, default true)
• Smart refresh — auto-refresh pauses when the ad is off-screen and resumes with stale-aware timing when it returns (smartRefresh, default false; always on for RemoteBannerAd)
• Prefetch distance — configurable margin that triggers the demand fetch before the ad fully enters the viewport (prefetchMargin, default 200 dp/pt)

Bug Fixes

• Fixed infinite loading when lazy loading is enabled
• Fixed iOS build failure on Xcode 16 (PrebidMobile pinned to ~> 3.0.0)
  ; Fixed static/dynamic hybrid linking conflict between Google-Mobile-Ads-SDK and PrebidMobile

Dependencies

• iOS: AudienzziOSSDK 0.2.1
• Android: com.audienzz:sdk 0.1.1

• Add lazy loading support for banner ads (defers demand fetch until ad enters the viewport)
• Add smart refresh support for banner ads (pauses auto-refresh when ad is off-screen, resumes with stale-aware timing when it returns)
• Add prefetch distance support: configurable margin (default 200 dp/pt) that triggers demand fetch before the ad enters the viewport
• Bump iOS native dependency to AudienzziOSSDK 0.2.1
• Fix infinite loading when lazy load is enabled (AdWidget now always rendered in the widget tree)

• Fix crash on network error during initialization
• Implement fallback polling for initialization

• Implement sticky ads header
• Bump native dependencies: iOS SDK 0.1.7, Android SDK 0.0.13
• Fix static/dynamic hybrid linking issue
• Update README with sticky ads documentation

• Added remote configuration feature
• Updated Readme with new documentation

• Added default values for API
• Added automatic PPID feature
• Update Audienzz native dependencies to latest version

• Add method to set Schain object
• Update Audienzz native dependencies to latest version

• Update Audienzz native dependencies to latest version
• Add support for targeting configuration

• Hotfix for multisize feature on iOS platform

• Update Audienzz native dependencies to latest version
• Add support for imp level ORTB config
• Add support for multiple ad sizes configuration

• Update Audienzz native dependencies to latest version
• Remove deprecated parameters 'appContent', 'keyword' and 'keywords'

• Initial release of the sdk wrapper. Supports Banner, Interstitial and Rewarded ad formats.