Market pillar · v0.8.1
monetization Monetization
Monetization entity describing how a product generates revenue.
$id · https://corpospec.com/schemas/v0.8.1/monetization.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| id | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| model | RevenueModel | yes | Canonical revenue model (typed enum). Distinct from `Pricing.model` (`PricingModel`): `RevenueModel` classifies *how money is made* at the business-model level (ad-based, subscription, marketplace…), while `Pricing.model` describes *how the price is structured* (freemium, tiered, usage-based…). Both can coexist. |
| ad_strategy | AdStrategy? | — | |
| description | string? | — | |
| name | string? | — | Human-readable name. Recommended but optional for backward compatibility. |
| pricing | Pricing? | — | Pricing configuration. Shares the same `Pricing` struct used by `GtmStrategy.pricing` — a monetization and its GTM must agree on tiers, prices, and usage-based unit. |
| referral_program | ReferralProgram? | — | |
| related_decisions | PathRef[] | — |
Definitions
Shared types referenced within this schema.
AdFormat
Ad format type.
enum: "banner", "interstitial", "rewarded", "native"
AdPlacement
Placement of an ad within the product.
type: object
AdStrategy
Ad monetization strategy.
type: object
DiscountProgram
Discount program within pricing.
type: object
IsoCurrency
ISO 4217 currency code.
pattern: ^[A-Z]{3}$
MonetaryAmount
A monetary value with currency.
type: object
PathRef
Path-based cross-reference relative to .corpospec/ root.
Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
Pricing
Pricing configuration.
type: object
PricingModel
Pricing model type.
enum: "freemium", "freemium-plus-usage", "subscription", "subscription-plus-usage", "usage-based", "enterprise", "hybrid", "retail", "per-unit", "project-based", "licensing", "hourly-rate", "auction", "cost-plus-pricing"
PricingTier
A single pricing tier.
type: object
ReferralProgram
Referral reward program configuration.
type: object
ReferralTier
A tier in a referral reward program.
type: object
RevenueModel
Revenue model type.
enum: "ad-based", "subscription", "in-app-purchase", "freemium", "freemium-plus-usage", "marketplace", "transaction-fee", "hybrid", "professional-services", "retainer", "hourly", "cost-plus", "commission", "royalty", "franchise-fee", "rental", "donation-grant", "management-fee"
UsageBasedPricing
Usage-based pricing configuration.
type: object
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.8.1/monetization.schema.json