Pubstar #

PubStar Flutter Mobile AD SDK is a comprehensive software development kit designed to empower developers with robust tools and functionalities for integrating advertisements seamlessly into Flutter mobile applications. Whether you're a seasoned developer or a newcomer to the world of app monetization, our SDK offers a user-friendly solution to maximize revenue streams while ensuring a non-intrusive and engaging user experience.

TOC #

• Features
• Platform Support
• Requirements
• Installation
• Configuration
• Usage
• API
• Release Notes
• ID Test Ad
• Support

Features #

• ✅ Display native ads on Android & iOS with Pubstar API.
• ✅ Full-featured API: load, show, loadAndShow, and handle ad events.
• ✅ Easy-to-use Flutter widget: PubstarAdView and PubstarVideoAdView.
• ✅ Structured ad event callback for type-safe event handling.

Platform Support #

Requirements #

• iOS >= 13.0
• Min Dart SDK >= 3.7

Installation #

Add the dependency in your pubspec.yaml file:

dependencies:
  pubstar_io

Then run:

flutter pub get

Configuration #

iOS #

1. Configure Pod.

1. Navigate to your iOS project directory.

2. Install the dependencies using pod install.

pod install

3. Open your project in Xcode with the .xcworkspace file.

2. Update your Info.plist

Update your app's Info.plist file to add several keys:

• A GADApplicationIdentifier key with a string value of your AdMob app ID found in the AdMob UI.

• A io.pubstar.key key with a string value of your Pubstar ad ID found in the Pubstar Dashboard.

• SKAdNetworkItems in Google AdMob refers to the necessary configuration within your iOS app's Info.plist file to support Apple's SKAdNetwork for conversion tracking, particularly when using the Google Mobile Ads SDK for AdMob found in the AdMob privacy.

<key>GADApplicationIdentifier</key>
<string>Your AdMob app ID</string>
<key>SKAdNetworkItems</key>
	<array>
		<dict>
			<key>SKAdNetworkIdentifier</key>
			<string>cstr6suwn9.skadnetwork</string>
		</dict>

        ...

        <dict>
			<key>SKAdNetworkIdentifier</key>
			<string>3qcr597p9d.skadnetwork</string>
		</dict>
    </array>
<key>NSUserTrackingUsageDescription</key>
<string>We use your data to show personalized ads and improve your experience.</string>
<key>io.pubstar.key</key>
<string>Your Pubstar app ID</string>

Android #

1. Add Pubstar Key to AndroidManifest.

Open AndroidManifest.xml and add inside <application>:

<meta-data
  android:name="io.pubstar.key"
  android:value="pub-app-id-XXXX" />

Replace pub-app-id-XXXX with your actual Pubstar App ID.

Usage #

Initialize the SDK #

Initializes the Pubstar IO Ads SDK.

Must be called once before loading or showing any ad.

import 'package:pubstar_io/pubstar_io.dart';

void main() async {
  await PubstarIo.init();  <--- init Pubstar

  runApp(MyApp());
}

API #

The example app in this repository shows an example usage of every single API, consult the example app if you have questions, and if you think you see a problem make sure you can reproduce it using the example app before reporting it, thank you.

init() #

Initialization Pubstar SDK.

Pubstar.init();

loadAd() #

Load Pubstar ads by adId to application.

Event

LoadListener

Example

PubstarIo.loadAd(
  adId,
  LoadListener(
    onLoaded: () => print("FLUTTER - app: onLoaded loadAd"),
    onError:
        (error) => print(
          "FLUTTER - app: onError loadAd, code: ${error.code} - rawCode: ${error.name}",
        ),
  ),
);

showAd() #

Show ad had loaded before.

Event

ShowListener

Example

PubstarIo.showAd(
  adId,
  ShowListener(
    onShowed: () => print("FLUTTER - app: onShowed showAd"),
    onHide:
        (reward) => print(
          "FLUTTER - app: onHide showAd  - type: ${reward?.type ?? ""} - amount: ${reward?.amount ?? 0}",
        ),
    onError:
        (error) => print(
          "FLUTTER - app: onError showAd, code: ${error.code} - name: ${error.name} - message: ${error.message}",
        ),
  ),
);

loadAndShow() #

Load and immediately show an ad by ID.

Event

LoadAndShowNoViewListener

Example

PubstarIo.loadAndShow(
  adId,
  LoadAndShowNoViewListener(
    onError:
        (error) => print(
          "FLUTTER - app: onError loadAndShow, code: ${error.code} - rawCode: ${error.name}",
        ),
    onHide:
        (reward) => print(
          "FLUTTER - app: onHide loadAndShow  - type: ${reward?.type ?? ""} - amount: ${reward?.amount ?? 0}",
        ),
    onLoaded: () => print("FLUTTER - app: onLoaded loadAndShow"),
    onShowed: () => print("FLUTTER - app: onShowed loadAndShow"),
  ),
);

PubstarAdView #

Load ad then show ad, using for Banner ad and Native ad.

API

Example

PubstarAdView(
  adId: adId,
  size: PubstarAdSize.small,
  type: PubstarAdType.banner,
  mode: PubstarAdViewMode.loadAndShow,
  onError:
      (error) => print(
        "FLUTTER - app: onError banner, code: ${error.code} - rawCode: ${error.name}",
      ),
  onHide:
      (reward) => print(
        "FLUTTER - app: onHide banner  - type: ${reward?.type ?? ""} - amount: ${reward?.amount ?? 0}",
      ),
  onLoaded: () => print("FLUTTER - app: onLoaded banner"),
  onShowed: () => print("FLUTTER - app: onShowed banner"),
)

PubstarVideoAdView #

Load video ad then show video ad, using for Video ad.

API

Example

PubstarVideoAdView(
  adId: adId,
  media:
      'https://storage.googleapis.com/gvabox/media/samples/stock.mp4',
  onError:
      (error) => print(
        "FLUTTER - app: onError video, code: ${error.code} - rawCode: ${error.name}",
      ),
  onHide:
      (reward) => print(
        "FLUTTER - app: onHide video  - type: ${reward?.type ?? ""} - amount: ${reward?.amount ?? 0}",
      ),
  onLoaded: () => print("FLUTTER - app: onLoaded video"),
  onShowed: () => print("FLUTTER - app: onShowed video"),
)

Release Notes #

See the CHANGELOG.md.

ID Test AD #

App ID : pub-app-id-1233
Banner Id : 1233/99228313580
Native ID : 1233/99228313581
Interstitial ID : 1233/99228313582
Open ID : 1233/99228313583
Rewarded ID : 1233/99228313584
Video ID : 1233/99228313585

Support #

Email: [email protected]

Raise an issue on GitHub for bugs or feature requests.

License #

Pubstar is released under the Apache License 2.0.

License agreement is available at LICENSE.