Documentation / Mobile Overview

Mobile & WebView Overview

BZZE Ads SDK works seamlessly on Android and iOS devices. Learn about platform support and deployment options.

Good News: Your existing BZZE Ads SDK works on mobile devices without any modifications! This page explains how and when to use it.

Does BZZE Ads Work on Mobile?

Yes! The BZZE Ads JavaScript SDK works on both Android and iOS devices in the following scenarios:

Mobile Web Browsers

Safari, Chrome, Firefox on iOS/Android

Fully Supported

HTML5 Games

Games built with Phaser, Godot, Construct 3

Fully Supported

Hybrid Apps

Cordova, Capacitor, Ionic, PhoneGap

Fully Supported

WebView Apps

Native apps embedding web content

Fully Supported

Progressive Web Apps

PWAs installed on mobile devices

Fully Supported

Native Apps

Pure Java/Kotlin (Android) or Swift/Objective-C (iOS) apps

Not Supported

Why Does It Work?

BZZE Ads is a JavaScript-based SDK that runs in web browsers and WebView environments. Modern mobile browsers and WebView components support all the web technologies our SDK uses:

  • JavaScript ES6+ - Modern JavaScript features
  • HTML5 iframe - For displaying ads
  • postMessage API - For communication between frames
  • localStorage - For frequency capping and analytics
  • IntersectionObserver - For viewability tracking
  • Fetch API - For network requests
No Extra Setup Required!
If you've already integrated BZZE Ads SDK in your HTML5 game, it will automatically work when you deploy to mobile web or wrap it in a hybrid app framework.

Mobile Deployment Options

Option 1: Mobile Web (Easiest)

Simply host your HTML5 game on a web server and users access it via mobile browsers:

Bash 
# No special setup needed
# Just ensure your game is mobile-responsive
https://yourgame.com/play

Pros

  • No app store approval needed
  • Instant updates
  • Works across all platforms
  • No download required

Cons

  • Requires internet connection
  • Less discovery (no app store listing)
  • No push notifications
  • Limited device API access

Option 2: Hybrid Apps (Recommended)

Wrap your HTML5 game in a native app shell using Cordova, Capacitor, or Ionic:

Bash 
# Example with Capacitor
npm install @capacitor/core @capacitor/cli
npx cap init
npx cap add android
npx cap add ios
npx cap open android  # Open in Android Studio
npx cap open ios      # Open in Xcode

Pros

  • App store distribution
  • Offline capabilities
  • Access to native APIs
  • Push notifications
  • Better user engagement

Cons

  • App store approval process
  • Slower update cycle
  • More complex setup
  • Larger download size

Option 3: Progressive Web Apps (PWA)

Make your game installable on mobile devices without going through app stores:

JavaScript 
// manifest.json
{
  "name": "My Awesome Game",
  "short_name": "MyGame",
  "start_url": "/",
  "display": "standalone",
  "icons": [
    {
      "src": "icon-192.png",
      "sizes": "192x192",
      "type": "image/png"
    }
  ]
}

Pros

  • No app store approval
  • Installable on home screen
  • Offline support with Service Workers
  • Automatic updates

Cons

  • Limited iOS support (improving)
  • No app store visibility
  • Restricted device API access

Platform-Specific Considerations

Android

  • WebView Engine: Chromium-based (same as Chrome)
  • Minimum Version: Android 5.0+ (API 21+) recommended
  • Compatibility: Excellent - Modern Chrome features supported
  • Permissions: Internet permission required in AndroidManifest.xml

iOS

  • WebView Engine: WKWebView (same as Safari)
  • Minimum Version: iOS 12+ recommended
  • Compatibility: Very good - Safari features supported
  • Limitations: Some storage limitations in Private Browsing mode
  • App Store: Must follow Apple's advertising guidelines
iOS App Store Policy: If you're publishing to the iOS App Store, ensure you comply with Apple's advertising guidelines. Your app must clearly disclose that it contains ads, and ads must be appropriate for your app's age rating.

Testing on Mobile Devices

Remote Debugging

Bash 
# Android (Chrome DevTools)
1. Enable USB Debugging on your Android device
2. Connect device via USB
3. Open chrome://inspect in desktop Chrome
4. Click "inspect" next to your game

# iOS (Safari Web Inspector)
1. Enable Web Inspector in Settings > Safari > Advanced
2. Connect device via USB
3. Open Safari > Develop > [Your Device] > [Your Page]

Enable Debug Mode

JavaScript 
// Add this to your game for mobile testing
RewardedAd.init({
    appId: "YOUR_APP_ID",
    apiKey: "YOUR_API_KEY",
    userId: "test_user",
    debug: true  // ← Shows detailed logs in mobile console
});

Quick Start for Mobile

  1. Build your HTML5 game with mobile-responsive design
  2. Integrate BZZE Ads SDK following the Quick Start Guide
  3. Test on desktop and verify ads show correctly
  4. Test on mobile browsers (Safari iOS, Chrome Android)
  5. Choose deployment: Mobile web, hybrid app, or PWA
  6. Deploy and monitor analytics in Publisher Dashboard

Next Steps

Cordova / Capacitor Guide

Learn how to wrap your game in a hybrid app

Mobile Best Practices

Optimize your game for mobile devices

Debug Mode

Troubleshoot issues on mobile devices

Need Help?

Having trouble getting BZZE Ads working on mobile? We're here to help!

View FAQ Contact Support