Skip to main content

prebid_mobile_sdk 1.1.0 copy "prebid_mobile_sdk: ^1.1.0" to clipboard
prebid_mobile_sdk: ^1.1.0 copied to clipboard

Unofficial Flutter plugin for the Prebid Mobile SDK 3.4: banner, interstitial, rewarded, native, multiformat and in-stream ads, targeting and privacy.

Prebid Mobile Flutter #

pub package Flutter CI

Unofficial project. This is an independent, community-maintained Flutter wrapper around the official Prebid Mobile SDKs. It is not affiliated with, endorsed by, or maintained by Prebid.org. Report issues with this plugin in its repository, not to Prebid.

A comprehensive Flutter plugin wrapping the Prebid Mobile SDK for Android and iOS.

Documentation: thanhhaidev.github.io/prebid-mobile-flutter

This plugin focuses on the Prebid Rendered (In-App Bidding) approach — the Prebid SDK handles both the auction and rendering directly, with no external ad server required.


Table of Contents #


Features #

Feature Description
Banner Ads Display and video banners via native PlatformView widgets with auto-refresh support, or preloaded and kept across views for feeds.
Interstitial Ads Fullscreen display and video ads with load/show lifecycle and video parameters.
Rewarded Ads Fullscreen ads that grant users a typed reward on completion.
Native Ads Load native ads and show them with PrebidNativeAdView (native rendering with impression/click tracking); raw assets are also exposed.
Multiformat Ads Request banner, video, and native demand on a single ad unit simultaneously.
In-Stream Video Fetch VAST video demand for integration with your own player or ad server.
Video Parameters Full OpenRTB video configuration — protocols, playback methods, placement, duration limits.
External User IDs Third-party identity modules (UID2, SharedID, LiveRamp, etc.) for improved fill rates.
Privacy & Compliance GDPR, COPPA, TCFv2, CCPA/US Privacy, and GPP consent support.
First-Party Data User/app keywords, user/app ext data, access control list, and global OpenRTB config.
Stored Responses Stored auction and bid responses for deterministic testing without live auctions.

Platform Requirements #

Each release bundles a fixed Prebid Mobile SDK version per platform:

prebid_mobile_sdk Prebid Android Prebid iOS Android iOS Flutter Dart
1.1.0 3.4.1 >= 3.4.1, < 4.0 API 24+ 15.0+ >=3.44.0 ^3.12.0
1.0.0 3.4.0 >= 3.4.1, < 4.0 API 24+ 15.0+ >=3.44.0 ^3.12.0

Android resolves exactly the listed Prebid version. On iOS, CocoaPods and Swift Package Manager pick the newest PrebidMobile release in the range, so a fresh pod install can resolve a newer 3.x patch.

Full mapping: Compatibility.


Installation #

Add the dependency to your pubspec.yaml:

dependencies:
  prebid_mobile_sdk: ^1.1.0

iOS #

Ensure your ios/Podfile specifies platform :ios, '15.0', then run:

cd ios && pod install

Swift Package Manager is supported too (the plugin ships a Package.swift). With Swift Package Manager, Xcode also resolves Google Mobile Ads and AppLovin, because Prebid's Package.swift declares them for its adapter products, even though the core package only links PrebidMobile. An app that pins Google Mobile Ads 12 or AppLovin below 13 can't resolve with Swift Package Manager; CocoaPods doesn't have this issue.

Android #

No additional setup needed. The Prebid Mobile Android SDK is included automatically via Maven.


Getting Started #

1. Initialize the SDK #

Call PrebidMobile.initializeSdk once at app launch, before loading any ads:

import 'package:prebid_mobile_sdk/prebid_mobile_sdk.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await PrebidMobile.initializeSdk(
    prebidServerUrl: 'https://prebid-server-test-j.prebid.org/openrtb2/auction',
    accountId: '0689a263-318d-448b-a3d4-b02e8a709d9d',
    completion: (status, error) {
      if (status == PrebidInitializationStatus.succeeded) {
        debugPrint('Prebid SDK initialized successfully');
      } else {
        debugPrint('Prebid SDK init failed: $error');
      }
    },
  );

  runApp(const MyApp());
}

2. Display a Banner Ad #

PrebidBannerAd(
  configId: 'prebid-demo-banner-320-50',
  width: 320,
  height: 50,
  refreshIntervalSeconds: 30, // Auto-refresh every 30s
  listener: PrebidBannerAdListener(
    onAdLoaded: () => debugPrint('Banner loaded'),
    onAdFailed: (error) => debugPrint('Banner failed: $error'),
    onAdClicked: () => debugPrint('Banner clicked'),
    onAdClosed: () => debugPrint('Banner closed'),
  ),
)

3. Show an Interstitial Ad #

final interstitial = PrebidInterstitialAd(
  configId: 'prebid-demo-display-interstitial-320-480',
  adFormats: {PrebidAdFormat.banner, PrebidAdFormat.video},
  videoParameters: const VideoParameters(
    mimes: ['video/mp4'],
    protocols: [VideoProtocol.vast2_0, VideoProtocol.vast3_0],
    playbackMethods: [VideoPlaybackMethod.autoPlaySoundOff],
  ),
  listener: PrebidInterstitialAdListener(
    onAdLoaded: () async => await interstitial.show(),
    onAdClosed: () async => await interstitial.destroy(),
  ),
);

await interstitial.loadAd();

4. Show a Rewarded Ad #

final rewarded = PrebidRewardedAd(
  configId: 'prebid-demo-video-rewarded-320-480',
  listener: PrebidRewardedAdListener(
    onAdLoaded: () async => await rewarded.show(),
    onUserEarnedReward: (reward) {
      debugPrint('Earned: ${reward.count}x ${reward.type}');
    },
    onAdClosed: () async => await rewarded.destroy(),
  ),
);

await rewarded.loadAd();

5. Set External User IDs #

await PrebidMobile.setExternalUserIds([
  ExternalUserId(source: 'uidapi.com', identifier: 'uid2-abc-123', atype: 3),
  ExternalUserId(source: 'sharedid.org', identifier: 'shared-xyz', atype: 1),
]);

6. Configure Privacy #

// GDPR
await PrebidTargeting.setSubjectToGDPR(true);
await PrebidTargeting.setGDPRConsentString('BOEFEAyOEFEAyAHABDENAI4AAAB9...');

// CCPA / US Privacy
await PrebidTargeting.setUSPrivacyString('1YNN');

// COPPA
await PrebidTargeting.setSubjectToCOPPA(false);

Error Handling #

Ad load, show and render failures are not thrown: they arrive through the listener's onAdFailed callback with the native SDK's error message.

PrebidInterstitialAdListener(
  onAdFailed: (error) => debugPrint('Interstitial failed: $error'),
)

Every other call returns a Future that completes once the native SDK has applied it. It fails when the platform call itself fails (for example a PlatformException when the plugin isn't registered, or when iOS rejects the URL given to setPrebidServerUrl), and with an ArgumentError for a request that can't get bids, such as a multiformat fetchDemand() without any format.

Await PrebidMobile.initializeSdk() before loading ads. Prebid Android drops requests made before initialization completes; the plugin reports them as onAdFailed, or as the prebidSdkNotInitialized result code from fetchDemand().



Documentation #

The guides on the documentation site cover every option; the API reference documents every class, listener and enum.

Topic Guide
SDK options, timeouts, external user IDs, stored responses Configuration
GDPR, TCF, CCPA / US Privacy, GPP, COPPA Privacy
Keywords, first-party data, OpenRTB config, app info Targeting
PrebidBannerAd and its controller Banner
PrebidInterstitialAd, PrebidRewardedAd Interstitial & rewarded
PrebidNativeAd, PrebidNativeAdView, native assets Native
VideoParameters, PrebidInstreamVideoAd Video
Listeners, result codes, failures Events & errors
Ad server handoff, PrebidMultiformatAd Original API
Logs, the bid event listener, test responses Debugging
What differs between Android and iOS Platform differences

Ad Server Integration #

The ads above use Prebid Rendered (In-App Bidding): Prebid runs the auction and renders the winner, with no ad server. To make Prebid demand compete in your ad server instead:

  • Original API: Prebid only runs the auction and returns targeting keywords, which you pass to your ad server request yourself (PrebidBannerAdUnit, PrebidInterstitialAdUnit, PrebidRewardedAdUnit, PrebidNativeAdUnit, PrebidMultiformatAd). This package doesn't depend on google_mobile_ads; see Original API.
  • GAM rendering, AdMob and MAX: the companion packages prebid_mobile_sdk_gam, prebid_mobile_sdk_admob and prebid_mobile_sdk_max wrap Prebid's event handlers and mediation adapters. They are separate packages because they bundle the ad server SDKs natively, so In-App-only apps stay lean. See Choosing an integration.
import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:prebid_mobile_sdk/prebid_mobile_sdk.dart';

// 1. Run the Prebid auction (Original API: keywords only, no rendering).
final response = await PrebidBannerAdUnit(
  configId: 'your-config-id',
  sizes: const [Size(300, 250)],
).fetchDemand();

// 2. Hand the winning keywords to Google Ad Manager, which renders the winner.
await AdManagerBannerAd(
  adUnitId: '/1234567/your-gam-ad-unit',
  sizes: [AdSize(width: 300, height: 250)],
  request: AdManagerAdRequest(
    customTargeting: response.targetingKeywords ?? const {},
  ),
  listener: AdManagerBannerAdListener(),
).load();

Example App #

The example/ directory contains a full-featured demo app including:

  • 90+ test cases across Banner, MRAID, Interstitial, Rewarded, Native, In-Stream Video and Multiformat for In-App, GAM rendering, GAM Original API, AdMob and MAX — mirroring Prebid's PrebidInternalTestApp
  • Every callback per test case: counters, a timestamped event log and the last bid response
  • Fullscreen controls dialog and banner controller (load / stop refresh)
  • Bid Inspector showing each bid request / response (PrebidMobile.setEventListener)
  • Settings for every SDK option (timeouts, bidding flags, EIDs placement, SharedID, privacy), applied at startup
  • Targeting data page for keywords, ext data, OpenRTB config, OMID partner and location
cd example
flutter pub get
flutter run

See example/README.md for detailed documentation.


Contributing #

Contributions are welcome: see CONTRIBUTING.md and the Code of Conduct.


License #

MIT License

1
likes
160
points
743
downloads

Documentation

Documentation
API reference

Publisher

unverified uploader

Weekly Downloads

Unofficial Flutter plugin for the Prebid Mobile SDK 3.4: banner, interstitial, rewarded, native, multiformat and in-stream ads, targeting and privacy.

Homepage
Repository (GitHub)
View/report issues
Contributing

Topics

#ads #prebid #advertising #header-bidding #monetization

License

MIT (license)

Dependencies

flutter, meta

More

Packages that depend on prebid_mobile_sdk

Packages that implement prebid_mobile_sdk