Ad Revenue

The Ad Revenue page shows advertising performance metrics — impressions, revenue, eCPM, and per-placement analytics.

Event Type

Track ad views from your game:

# Rewarded ad (player chose to watch)
QuestData.track("ad_watched", {
  "ad_type": "rewarded",
  "placement": "level_complete_reward",
  "ecpm": 12.50,
  "revenue": 0.0125,
  "currency": "USD"
})

# Interstitial ad (shown between levels)
QuestData.track("ad_watched", {
  "ad_type": "interstitial",
  "placement": "between_levels",
  "ecpm": 6.50,
  "revenue": 0.0065,
  "currency": "USD"
})

Property	Type	Required	Description
ad_type	string	Yes	"rewarded" or "interstitial"
placement	string	Yes	Where the ad was shown (e.g. "level_complete_reward", "main_menu")
ecpm	number	Yes	Effective Cost Per Mille from your ad network
revenue	number	Yes	Actual revenue earned from this impression
currency	string	No	Currency code (default: USD)

KPI Cards

Metric	Description
Impressions	Total ad views in the period
Ad Revenue	Total revenue from all ads
Avg eCPM	Weighted average eCPM across all ad types
Rewarded	Rewarded ad count + revenue
Interstitial	Interstitial ad count + revenue

Daily Ad Revenue Chart

Bar chart showing daily ad revenue over time.

Placement Performance Table

Breakdown by placement location:

• Placement name
• Number of impressions
• Revenue generated
• Average eCPM

API Reference

curl "https://api.questdata.io/v1/stats/ad-revenue?from=2026-01-01&to=2026-04-01" \
  -H "x-game-api-key: YOUR_API_KEY"

Response:

{
  "summary": {
    "total_impressions": 80,
    "total_revenue": 0.95,
    "avg_ecpm": 11.25,
    "rewarded_count": 50,
    "rewarded_revenue": 0.75,
    "interstitial_count": 30,
    "interstitial_revenue": 0.20
  },
  "timeline": [
    { "date": "2026-03-01", "impressions": 15, "revenue": 0.18 }
  ],
  "placements": [
    { "placement": "level_complete_reward", "impressions": 30, "revenue": 0.40, "avg_ecpm": 13.0 }
  ]
}