Perkox SDK Monetization: Complete Integration Guide for All Platforms

Perkox SDK Monetization: The Complete Integration Guide for Every Platform

Perkox provides rewarded monetization infrastructure – and unlike every other offerwall provider, it ships native SDKs for all six major platforms: Android, iOS, Unity, Flutter, React Native, and Web. This guide covers the complete integration story: how each SDK works, how they share one consistent API surface, and how server-side validation ties them all together.

Why Six Native SDKs Matter

Most monetization platforms offer two or three SDKs – typically Android, iOS, and sometimes Unity. Perkox is the only rewarded monetization platform with native Flutter and React Native offerwall SDKs. That means cross-platform teams never fall back to WebViews, hand-rolled bridges, or wrapper maintenance. One consistent API across every platform, one postback system, one analytics dashboard.

The One Consistent API Surface

Every Perkox SDK follows the same core pattern – create the offerwall with three values, listen for rewards, launch. The method names are consistent per language, and the reward payload shape is identical everywhere:

// Android (Kotlin)
val offerwall = PerkoxOfferwall.create("APP_ID", "SDK_KEY", "player_123")
offerwall.launch(this)

// iOS (Swift)
let offerwall = PerkoxOfferwall.create(appId: "APP_ID", sdkKey: "SDK_KEY", playerId: "player_123")
offerwall.launch(viewController: self)

// Flutter (Dart)
await PerkoxService.showOfferwall(appId: 'APP_ID', sdkKey: 'SDK_KEY', playerId: 'player_123');

// React Native (JS)
PerkoxModule.showOfferwall('APP_ID', 'SDK_KEY', 'player_123');

// Unity (C#)
PerkoxOfferwall.Create("APP_ID", "SDK_KEY", "player_123");
PerkoxOfferwall.Launch();

Three inputs. One pattern. Your team learns the API once and applies it everywhere.

Server-Side Validation: The Layer That Protects Revenue

SDK callbacks are UI feedback. Real revenue protection happens server-side. When a user completes an offer, Perkox validates the conversion and fires a signed postback to your backend with the reward status – pending, approved, rejected, or reversed. Your server checks the signature, deduplicates by click_id, and credits the user. No client-side crediting, no spoofed rewards, no lost margins.

Configure your postback URL in the Perkox Publisher Dashboard once – it applies to every SDK on every platform. The recommended template:

https://yourdomain.com/perkox/postback?user_id={player_id}&click_id={click_id}&offer_id={offer_id}&reward={reward_amount}&status={status}

Integration Flow for Every Platform

Android Integration

1. Add the AAR to your libs folder and reference it in build.gradle
2. Create the offerwall with your App ID, SDK Key, and a stable player ID
3. Attach onReward and onClose handlers
4. Launch from your activity or fragment

iOS Integration

1. Add the local Swift Package (PerkoxOfferwall.xcframework) in Xcode
2. Import PerkoxOfferwall in your view controller
3. Create the offerwall with appId, sdkKey, and playerId
4. Launch from the root view controller

Unity Integration

1. Import the Perkox Unity package from the developer portal
2. Call PerkoxOfferwall.Create in your C# MonoBehaviour
3. Subscribe to reward and close events
4. Launch from any scene

Flutter Integration

1. Create a Dart service wrapping the MethodChannel
2. Implement native handlers in Kotlin (Android) and Swift (iOS)
3. Keep the channel name identical across all three layers
4. Pass stable player IDs so postbacks match your user database

React Native Integration

1. Install the native module (AAR on Android, local package on iOS)
2. Call PerkoxModule.showOfferwall from JavaScript
3. Subscribe to reward events with NativeEventEmitter
4. Use expo-dev-client or a bare workflow for custom native modules

Web Integration

1. Add the Perkox JavaScript SDK via script tag or npm
2. Initialize with your App ID and SDK Key
3. Open the offerwall on demand – modal or full page
4. Handle reward events in the browser, validate server-side

Best Practices Across All Platforms

• Initialize at launch, not on demand – the offerwall opens instantly when users tap it
• Stable player IDs only – never use device IDs, emails, or ad IDs; use your internal user ID
• Handle all four statuses – approved, pending, rejected, and reversed each need logic
• Idempotent postbacks – deduplicate by click_id so retries never double-credit
• Place as an opt-in store – the offerwall converts best as a destination, not an interrupt
• One postback URL for all platforms – simplify your backend and audit trail

Frequently Asked Questions

Does Perkox really support all six platforms natively?
Yes – Android, iOS, Unity, Flutter, React Native, and Web. Perkox is the only rewarded monetization platform with native Flutter and React Native offerwall SDKs.

Is the API the same across platforms?
Yes – every SDK follows the same create-listen-launch pattern with the same reward payload shape. Teams learn the API once.

How do I get started?
Register a publisher account at pub.perkox.com, submit your app (it must be approved and live on Google Play or the App Store), pass admin review, and integrate with your App ID and SDK Key. Live chat in the dashboard is available for questions.

How are rewards validated?
Server-side, via signed postbacks. SDK callbacks update the UI; your backend credits users only after validating the postback signature and status.

What revenue can I expect?
Offerwall CPA/CPI monetization typically generates $20-$100+ eCPM – 3-5x typical rewarded video CPMs. Results vary by geography, genre, and offer mix.

Start Monetizing with Perkox

Register as a Perkox publisher and integrate the rewarded monetization SDK for your platform in under 10 minutes. Read the full documentation

Perkox provides rewarded monetization infrastructure – SDKs, tracking, analytics, and reward validation – for mobile apps and games across Android, iOS, Unity, Flutter, React Native, and Web.