When to Use
"IAP", "ads", "revenue", "purchase", "subscription", "ad", "monetization", "coins", "gems"
Economy Stack
QVNWalletManager → Nakama wallet (server-authoritative)
├── Currencies: Coins, Gems, Energy, XP
├── ShopScreen → IAP purchases
├── IVXAdsBootstrap → Ad SDK init
├── AdVisibilityController → Banner visibility
└── NotEnoughPopup → upsell flow
Key GameObjects
WalletManagerGO →QVNWalletManagerAdsBootstrapGO →IVXAdsBootstrapAdVisibilityControllerGO → banner togglePopup_Canvas/NoadsPop→NoAdsPopupUI(premium upsell)
Rules
- All reward grants must be server-authoritative (Nakama)
- Premium users: skip all ads (
NoAdsPopupUIcheck) - Rewarded ads: always have fallback if ad not loaded
- ILRD (Impression Level Revenue Data) must report to analytics
Context Files (load only if needed)
- Economy API:
docs/context/micro/ECONOMY_INTERFACE.md(1.5 KB) - Persona:
.agents/personas/monetization-specialist.md