Offers & Promotions

The Offers page shows how your in-game promotions perform — which offers convert, what discounts work, and how revenue is affected.

Event Types

Track two events for each offer:

# When an offer is shown to the player
QuestData.track("offer_shown", {
  "offer_id": "starter_bundle",
  "original_price": 9.99,
  "discount_price": 4.99,
  "discount_percent": 50,
  "currency": "USD"
})

# When the player purchases the offer
QuestData.track("offer_purchased", {
  "offer_id": "starter_bundle",
  "original_price": 9.99,
  "discount_price": 4.99,
  "discount_percent": 50,
  "currency": "USD"
})

KPI Cards

Metric	Description
Offers Shown	Total times any offer was displayed
Purchased	Total offer purchases
Conversion	Purchase rate (purchased / shown)
Revenue	Total revenue from offer purchases
Avg Discount	Average discount percentage across all offers

Offer Performance Table

Per-offer breakdown:

• Offer name
• Times shown and purchased
• Conversion rate (highlighted green if >= 30%)
• Revenue generated
• Average discount applied

Daily Offers Chart

Stacked bar chart showing daily offers shown (gray) vs purchased (green).

API Reference

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

Response:

{
  "summary": {
    "total_shown": 20,
    "total_purchased": 7,
    "conversion_rate": 35,
    "total_revenue": 52.44,
    "avg_discount": 50
  },
  "offers": [
    {
      "offer_id": "starter_bundle",
      "shown": 3,
      "purchased": 2,
      "conversion_rate": 66.7,
      "revenue": 9.98,
      "avg_discount": 50
    }
  ],
  "timeline": [
    { "date": "2026-03-01", "shown": 5, "purchased": 2 }
  ]
}