pubscale_offerwall_plugin

A Flutter plugin to integrate Pubscale Offerwall SDK into your Android and iOS apps. This plugin enables in-app monetization through offerwalls—allowing users to earn rewards by completing offers.

🔧 Installation

Add the plugin to your pubspec.yaml:

dependencies:
  pubscale_offerwall_plugin: ^0.0.4

Then run:

flutter pub get

🛠️ Platform Setup

Android

Min SDK Version
Ensure minSdkVersion is set to 21 or higher in android/app/build.gradle.

Permissions
Add internet permission in AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET"/>

iOS

Deployment Target
Set the platform version to at least 11.0 in ios/Podfile.

IDFA Permission (Optional)
Add to Info.plist:

<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to personalize offers.</string>

Run:
```
cd ios
pod install
```

🚀 Usage

1. Import

import 'package:pubscale_offerwall_plugin/pubscale_offerwall_plugin.dart';

2. Initialize

final plugin = PubscaleOfferwallPlugin();

plugin.initializeOfferwall(
  'YOUR_APP_ID',        // from Pubscale dashboard
  'UNIQUE_USER_ID',     // user identifier
  sandbox: false,       // true for testing
  fullscreen: false,    // true for full-screen mode
);

3. Listen to Events

plugin.offerwallEvents.listen((event) {
  switch (event['event']) {
    case 'offerwall_init_success':
      print('Initialized');
      break;
    case 'offerwall_reward':
      print('Reward: ${event['amount']} ${event['currency']}');
      break;
    case 'offerwall_launch_failed':
      print('Launch failed: ${event['error']}');
      break;
  }
});

4. Launch the Offerwall

plugin.launchOfferwall();

📡 Event Types

Event	Description
`offerwall_init_success`	Initialization succeeded
`offerwall_init_failed`	Initialization failed (with `error`)
`offerwall_showed`	Offerwall launched successfully
`offerwall_closed`	User closed the offerwall
`offerwall_reward`	User earned a reward (amount, currency, token)
`offerwall_launch_failed`	Launch failed (with `error`)

📱 Example App

You can find a working demo under the example/ directory. Run it with:

flutter run

📣 About Pubscale

Pubscale provides monetization solutions via SDKs and APIs to boost app revenues through gamified experiences. Visit pubscale.com for more info.

📄 License

MIT