Ads Configuration¶

Configure advertising networks - LevelPlay (ironSource), Appodeal, and AdMob.

Overview¶

The IntelliVerseX SDK supports three advertising platforms:

LevelPlay (ironSource) Setup¶

1. Dashboard Setup¶

1. Create account at LevelPlay
2. Add your app
3. Note your App Key
4. Configure ad networks in mediation

2. SDK Configuration¶

In IntelliVerseX > Game Config under Ads Configuration:

3. Ad Unit IDs¶

For LevelPlay, configure placements:

Appodeal Setup¶

1. Dashboard Setup¶

1. Create account at Appodeal
2. Add your app
3. Note your App Key
4. Configure networks in dashboard

2. SDK Configuration¶

In IntelliVerseX > Game Config under Ads Configuration:

3. Consent Configuration¶

Appodeal requires additional consent setup:

// GDPR consent
Appodeal.updateGDPRUserConsent(GDPRUserConsent.Personalized);

// CCPA
Appodeal.updateCCPAUserConsent(CCPAUserConsent.OptIn);

AdMob Setup¶

1. Dashboard Setup¶

1. Create account at AdMob
2. Add your app
3. Create ad units
4. Note your App ID and Ad Unit IDs

2. Platform Configuration¶

Android¶

Add to Assets/Plugins/Android/res/values/strings.xml:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="admob_app_id">ca-app-pub-XXXXXXXXXXXXXXXX~XXXXXXXXXX</string>
</resources>

iOS¶

Add to Info.plist:

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-XXXXXXXXXXXXXXXX~XXXXXXXXXX</string>

3. SDK Configuration¶

Test Ads¶

Enable Test Mode¶

Always use test ads during development:

// In IntelliVerseXConfig
// Enable Dev Test Ads: true

Test Device IDs¶

Add your device as a test device:

// AdMob test devices
// Configure in IntelliVerseXConfig:
// Test Device IDs: ["your-device-id"]

Banner Configuration¶

Position¶

Configure banner position:

public enum BannerPosition
{
    Top,
    Bottom,
    TopLeft,
    TopRight,
    BottomLeft,
    BottomRight,
    Center
}

// In config or code:
IVXAdsManager.SetBannerPosition(BannerPosition.Bottom);

Size¶

Interstitial Configuration¶

Show Frequency¶

Control how often interstitials appear:

// In IntelliVerseXConfig:
// Show Interstitial Every N Actions: 3
// Minimum Seconds Between Ads: 60

Capping¶

// Daily cap
// Max Interstitials Per Day: 10

// Session cap
// Max Interstitials Per Session: 5

Rewarded Video Configuration¶

Reward Settings¶

Configure rewards in IntelliVerseXConfig:

// Default reward amount: 100
// Reward currency: "Coins"
// Double reward for ads: true

Reward Verification¶

For server-side verification:

// Enable Server Verification: true
// Verification Endpoint: Your server URL

// Server receives callback with:
// - User ID
// - Transaction ID
// - Reward amount
// - Signature

GDPR & Privacy¶

Consent Flow¶

Configure consent collection:

// In IntelliVerseXConfig:
// Auto Show Consent: true
// Consent Region: EU only / All users

Programmatic Consent¶

// Check if consent needed
if (IVXAdsManager.IsConsentRequired())
{
    // Show your consent UI
    bool userConsented = await ShowConsentDialog();

    // Update SDK
    IVXAdsManager.SetUserConsent(userConsented);
}

ATT (iOS 14.5+)¶

// App Tracking Transparency handled automatically
// Or manual control:
#if UNITY_IOS
IVXAdsManager.RequestTrackingAuthorization((status) =>
{
    Debug.Log($"ATT Status: {status}");
});
#endif

Waterfall Configuration¶

Mediation Partners¶

Configure in ad platform dashboard, not in SDK.

Priority Settings¶

Most platforms auto-optimize, but you can:

// Set ad network priority
// Higher eCPM networks first
// Done in dashboard, not code

IVXAdNetworkConfig Field Reference¶

Complete mapping of every field in the IVXAdsConfig ScriptableObject:

General Settings¶

Banner Settings¶

Interstitial Settings¶

Rewarded Video Settings¶

LevelPlay Settings¶

Appodeal Settings¶

AdMob Settings¶

Privacy & Consent Settings¶

Test Ad Unit IDs¶

Use these test IDs during development to avoid invalid traffic flags:

AdMob Test Ad Units¶

LevelPlay Test App Keys¶

Appodeal Test App Keys¶

IVXAdsWaterfallManager¶

The IVXAdsWaterfallManager provides automatic failover between ad networks. If the primary provider fails to fill, the SDK falls back to the next provider in the priority chain.

How It Works¶

graph TD
    A[Ad Request] --> B{Primary Provider}
    B -->|Fill| C[Show Ad]
    B -->|No Fill| D{Secondary Provider}
    D -->|Fill| C
    D -->|No Fill| E{Tertiary Provider}
    E -->|Fill| C
    E -->|No Fill| F[No Ad Available]

Configuring Waterfall Priority¶

Set the failover order in your IVXAdsConfig:

Waterfall Enabled:     ✅
Waterfall Priority:    [LevelPlay, Appodeal, AdMob]
Waterfall Timeout Ms:  5000

Waterfall Behavior¶

Code Example¶

// Waterfall is transparent — use IVXAdsManager as normal
IVXAdsManager.Instance.ShowInterstitial();

// To check which provider filled an ad:
IVXAdsManager.OnAdShown += (adInfo) =>
{
    Debug.Log($"Ad filled by: {adInfo.NetworkName} (waterfall position: {adInfo.WaterfallIndex})");
};

Revenue Impact¶

Using a waterfall typically increases fill rate by 15–30%:

Analytics Integration¶

Revenue Tracking¶

// Enable ad revenue tracking
IVXAdsManager.OnAdRevenue += (revenue) =>
{
    // revenue.Amount
    // revenue.Currency
    // revenue.NetworkName
    // revenue.AdType

    // Send to your analytics
    IVXAnalyticsManager.TrackAdRevenue(revenue);
};

Platform-Specific Settings¶

Android¶

// Android-specific in config:
// Use Immersive Mode: true (hides nav bar)
// Orientation Lock: None / Portrait / Landscape

iOS¶

// iOS-specific in config:
// SKAdNetwork: true
// App Store ID: Your app ID

WebGL¶

Common Configurations¶

Casual Game¶

Banners: Bottom, SmartBanner
Interstitials: Every 3 level completions
Rewarded: 2x coins, extra lives
COPPA: Check if kids' game

Hardcore Game¶

Banners: Disabled
Interstitials: Minimal, story breaks only
Rewarded: Premium items, continues
Frequency Cap: 30 ads/day

Hypercasual¶

Banners: Always on
Interstitials: Every action (aggressive)
Rewarded: Every opportunity
Frequency: High

Debugging¶

Enable Debug Mode¶

// Show ad mediation debug window
IVXAdsManager.ShowMediationDebugger();

// Log all ad events
IVXAdsManager.SetDebugLogging(true);

Test Checklist¶

• Test ads load in editor
• Test ads work on device
• Rewarded callbacks fire correctly
• Revenue events tracked
• Consent UI shows properly

Best Practices¶

1. User Experience¶

// DON'T show ads during:
// - Tutorials
// - Critical gameplay
// - Purchases
// - Loading

// DO show ads:
// - Between levels
// - Natural breaks
// - User-initiated (rewarded)

2. Performance¶

// Preload ads
IVXAdsManager.PreloadInterstitial();
IVXAdsManager.PreloadRewardedVideo();

// Check if ready before showing
if (IVXAdsManager.IsInterstitialReady())
{
    IVXAdsManager.ShowInterstitial();
}

3. Revenue Optimization¶

// A/B test ad placements
// Monitor fill rates by network
// Adjust frequency based on retention
// Use rewarded > interstitials > banners ratio

Troubleshooting¶

See Runtime Issues for more solutions.