Home / Getting Started / Quick Start

Quick Start (5 Minutes)

Get your game monetized in 5 minutes. Follow these simple steps to integrate BZZE Ads and start earning revenue.

📋 What You'll Need:
  • A game or app (web-based)
  • 5 minutes of your time
  • Basic HTML/JavaScript knowledge

Step 1: Create a Free Account

Sign up for a BZZE Ads publisher account. It's free and takes 30 seconds.

  1. Go to ads.bzze.com
  2. Click "Sign Up" and enter your details
  3. Verify your email address
  4. Complete your profile (company name, website, etc.)
✅ Account Created! You'll be redirected to the Publisher Dashboard.

Step 2: Add Your Game/App

Register your game in the Publisher Dashboard to get your credentials.

  1. Navigate to "My Games" section
  2. Click "Add New Game"
  3. Fill in:
    • Name: Your game name
    • Platform: Web (HTML5)
    • URL: Where your game is hosted
    • Category: Game genre
  4. Click "Create Game"
✅ Game Added! You'll receive your App ID and API Key.

Step 3: Install the SDK

Add one line to your HTML file to load the BZZE Ads SDK.

HTML 
<script src="https://ads.bzze.com/sdk/rewarded.min.js"></script>

Add this line in your <head> or before the closing </body> tag.

Step 4: Initialize the SDK

Initialize the SDK with your credentials from Step 2.

JavaScript 
RewardedAd.init({
    appId: "YOUR_APP_ID",      // From Publisher Dashboard
    apiKey: "YOUR_API_KEY",    // From Publisher Dashboard
    userId: "user_123",        // Your user's unique ID
    onReward: function(reward) {
        console.log('✅ Ad completed! Grant reward to user.');
        // Grant reward in your game (coins, gems, etc.)
    },
    onNoFill: function() {
        console.log('⚠️ No ads available');
    },
    onError: function(error) {
        console.error('❌ Ad error:', error);
    }
});

Step 5: Show a Rewarded Ad

Call showAd() when the user clicks your "Watch Ad" button.

HTML + JavaScript 
<!-- Add this button to your game -->
<button onclick="showRewardedAd()">Watch Ad for 100 Coins</button>

<script>
function showRewardedAd() {
    RewardedAd.showAd({
        rewardPreview: "100 coins"  // Show user what they'll earn
    });
}
</script>
✅ Integration Complete! Your game is now monetized. Test it by clicking the button!

Complete Example

Here's a complete working example you can copy and paste:

Complete Example 
<!DOCTYPE html>
<html>
<head>
    <title>My Game</title>
    <script src="https://ads.bzze.com/sdk/rewarded.min.js"></script>
</head>
<body>
    <h1>My Awesome Game</h1>
    <p>Coins: <span id="coins">0</span></p>
    <button onclick="showRewardedAd()">Watch Ad for 100 Coins</button>

    <script>
    let coins = 0;

    // Initialize SDK
    RewardedAd.init({
        appId: "YOUR_APP_ID",
        apiKey: "YOUR_API_KEY",
        userId: "user_" + Date.now(),
        onReward: function(reward) {
            // Grant reward to user
            coins += 100;
            document.getElementById('coins').textContent = coins;
            alert('✅ You earned 100 coins!');
        },
        onNoFill: function() {
            alert('⚠️ No ads available right now');
        },
        onError: function(error) {
            alert('❌ Error: ' + error.message);
        }
    });

    // Show ad
    function showRewardedAd() {
        RewardedAd.showAd({
            rewardPreview: "100 coins"
        });
    }
    </script>
</body>
</html>

Testing Your Integration

⚠️ Before Going Live:
  • Test on localhost: SDK works on any domain
  • Check console: Enable Debug Mode for detailed logs
  • Verify rewards: Ensure users receive rewards after completing ads
  • Test no-fill: Handle cases when no ads are available

See Test Checklist for detailed testing guide.

Next Steps

Need Help?