Monetization¶

Skill ID: ivx-monetization

name: ivx-monetization description: >- Configure ads, in-app purchases, offerwalls, and monetization strategy for IntelliVerseX SDK games. Use when the user says "monetize my game", "add ads", "set up offerwall", "add IAP", "wire rewarded ads", "set up LevelPlay", "configure AdMob", "Appodeal setup", "add season pass", "configure interstitials", "banner ads", "rewarded video", "Pubscale", "Xsolla offerwall", "ad unit IDs", or needs help with any revenue integration. version: "1.0.0" author: "IntelliVerse-X team@intelli-verse-x.ai" allowed-tools: - Read - Write - Edit - Glob - Grep - Shell

Overview¶

The SDK supports three monetization pillars: Ads, In-App Purchases (IAP), and Offerwalls. Each has a dedicated config ScriptableObject, manager, and server-side validation path.

When to Use¶

Ask your AI agent any of these:

• "Monetize my casual puzzle game"
• "Set up LevelPlay ads with rewarded video"
• "Add Pubscale offerwall and wire it to the wallet"
• "Configure IAP for a coins pack"
• "Add server-side reward validation for rewarded ads"
• "Set up AdMob banner and interstitial ads"
• "Configure ad waterfall priority"

What the Agent Does¶

flowchart TD
    A[You: "Monetize my game"] --> B[Agent loads ivx-monetization skill]
    B --> C{What type of game?}
    C -->|Hypercasual| D[Interstitials + Rewarded]
    C -->|Casual| E[Rewarded + IAP + Banner]
    C -->|Midcore| F[IAP + Season Pass]
    C -->|Hardcore| G[Subscription + IAP]
    D --> H[Configure ad provider]
    E --> H
    F --> I[Configure IAP products]
    G --> I
    H --> J[Set up IVXAdsConfig]
    I --> K[Set up IVXIAPConfig]
    J --> L[Wire reward callbacks]
    K --> L
    L --> M[Enable server validation]

1. Ad Providers¶

Supported Networks¶

Per-Provider Setup¶

LevelPlay (ironSource)¶

1. Create an account at is.com.
2. Register your app and note the App Key.
3. Import the LevelPlay Unity SDK via their integration manager.
4. In IVXAdsConfig, set Provider = LevelPlay and enter the App Key.

Appodeal¶

1. Register at appodeal.com.
2. Create your app and note the App Key.
3. Import the Appodeal SDK via their Unity plugin.
4. In IVXAdsConfig, set Provider = Appodeal and enter the App Key.

AdMob¶

1. Register at admob.google.com.
2. Create ad units for each format and note the Ad Unit IDs.
3. Import GoogleMobileAds via UPM or .unitypackage.
4. In IVXAdsConfig, set Provider = AdMob and enter the per-format IDs.

2. Ad Unit Configuration¶

IVXAdsConfig ScriptableObject¶

Create via Create > IntelliVerseX > Ads Configuration.

Test IDs¶

Use these during development to avoid invalid traffic flags:

Waterfall & Failover¶

IVXAdsWaterfallManager manages failover between providers:

// Priority order — falls through on load failure
waterfallManager.SetPriority(new[] {
    AdProvider.LevelPlay,
    AdProvider.Appodeal,
    AdProvider.AdMob,
});

If the primary provider fails to fill, the next provider in the waterfall is tried automatically.

3. Showing Ads¶

using IntelliVerseX.Monetization;

// Banner
IVXAdsManager.Instance.ShowBanner(BannerPosition.Bottom);
IVXAdsManager.Instance.HideBanner();

// Interstitial
if (IVXAdsManager.Instance.IsInterstitialReady())
{
    IVXAdsManager.Instance.ShowInterstitial(
        onClosed: () => Debug.Log("Interstitial closed"),
        onFailed: (err) => Debug.LogWarning($"Interstitial failed: {err}")
    );
}

// Rewarded Video
if (IVXAdsManager.Instance.IsRewardedReady())
{
    IVXAdsManager.Instance.ShowRewarded(
        onRewarded: (reward) => GrantReward(reward),
        onClosed: () => Debug.Log("Rewarded closed"),
        onFailed: (err) => Debug.LogWarning($"Rewarded failed: {err}")
    );
}

Rewarded Ads Server Validation¶

For high-value rewards, validate server-side via the rewarded_ads Nakama RPC:

var result = await IVXAdsManager.Instance.ShowRewardedWithServerValidation(
    placement: "double_coins",
    userId: currentUserId
);
if (result.Validated) GrantReward(result.Reward);

The server verifies the callback from the ad network before granting currency.

4. Offerwall Setup¶

IVXOfferwallConfig ScriptableObject¶

Create via Create > IntelliVerseX > Offerwall Configuration.

Showing the Offerwall¶

using IntelliVerseX.Monetization;

IVXOfferwallManager.Instance.ShowOfferwall(OfferwallProvider.Pubscale);

IVXOfferwallManager.Instance.OnOfferCompleted += async (offer) =>
{
    await IVXWalletManager.Instance.GrantCurrencyAsync(
        "coins", offer.RewardAmount
    );
};

5. In-App Purchases (IAP)¶

IVXIAPConfig ScriptableObject¶

Create via Create > IntelliVerseX > IAP Configuration.

Define products:

Purchase Flow¶

using IntelliVerseX.Monetization;

var result = await IVXIAPManager.Instance.PurchaseAsync("gems_100");

switch (result.Status)
{
    case PurchaseStatus.Success:
        // Server validated receipt — gems already granted
        RefreshUI();
        break;
    case PurchaseStatus.Cancelled:
        Debug.Log("Purchase cancelled by user");
        break;
    case PurchaseStatus.Failed:
        Debug.LogWarning($"Purchase failed: {result.Error}");
        break;
}

Flow: Client purchase -> receipt sent to Nakama RPC iap_validate -> server validates with Apple/Google -> server grants items -> client receives confirmation.

6. Monetization Strategy by Genre¶

Recommended Defaults¶

• Always use rewarded video for premium currency shortcuts.
• Place interstitials at natural break points (level end, menu transition) — never mid-gameplay.
• Banners only in menus or non-gameplay screens.
• Validate all high-value rewards server-side.

Platform-Specific Monetization¶

VR Platforms (Meta Quest / SteamVR / Vision Pro)¶

VR monetization strategy: Focus on IAP and premium pricing. Rewarded mechanics can use in-game reward systems (daily login, challenges) instead of ad-based rewards. Season passes and cosmetic DLC work well in VR.

Console Platforms (PS5 / Xbox / Switch)¶

Console IAP: Each console has its own proprietary store API (NDA-protected). The IVXIAPManager delegates to the platform's native purchasing API through platform-specific build targets. Product IDs must be registered in each console's developer portal separately.

Console certification: All monetization must pass platform certification (Sony TRC, Microsoft XR, Nintendo Lotcheck). Key requirements: clear pricing display, purchase confirmation dialogs, restore purchases functionality, and parental controls.

WebGL / Browser¶

WebGL monetization: Traditional mobile ad SDKs (LevelPlay, Appodeal, AdMob) do not work in WebGL. Use browser-native ad solutions. For IAP, integrate web payment processors directly.

Checklist¶

• Ad provider SDK imported and configured
• IVXAdsConfig created with correct IDs (test IDs for dev builds)
• UseTestAds enabled during development
• Rewarded ads grant rewards via server validation
• Offerwall config set up if using Pubscale/Xsolla
• IAP products defined with matching store product IDs
• Purchase flow tested end-to-end with sandbox accounts
• Ad waterfall priority configured
• VR store policies reviewed if targeting Quest/Steam/Vision Pro
• Console store products registered if targeting PS5/Xbox/Switch
• WebGL ad solution configured if targeting browser