Skip to content
T1KTheOneKit

t1k:marketing:monetization:unity-ads

FieldValue
Modulemonetization
Version1.16.9
Efforthigh
Tools—

How to invoke

Section titled “How to invoke”
/t1k:marketing:monetization:unity-ads

Unity Ads

Section titled “Unity Ads”

Unity Ads monetization, placements, and revenue reporting integration.

When to Use

Section titled “When to Use”
  • Integrating the Unity Ads SDK; configuring rewarded/interstitial/banner placements
  • Tuning placements alongside Unity LevelPlay mediation
  • Pulling operate/monetization stats via the Monetization Stats API

Reporting API — endpoint & auth

Section titled “Reporting API — endpoint & auth”
  • Monetization Stats API: GET https://monetization.api.unity.com/stats/v1/operate/organizations/{organizationId}
  • Auth: API key from the Unity Monetization Dashboard (Setup > API Access > Monetization Stats API).
  • Returns CSV. Params: start, end, scale (day/hour), groupBy, fields.

Dimensions & metrics

Section titled “Dimensions & metrics”
  • groupBy: country, placement, platform, game (and source/store depending on report). NOTE: Unity Ads is a single ad source (Unity’s own network) — there is no cross-network mediation dimension here. The cross-network breakdown lives in Unity LevelPlay (ex-ironSource — see the ironsource skill), not in the Unity Ads Stats API.
  • fields: adrequest_count, available_sum, revenue_sum, start_count, view_count, match_rate, ecpm.

Quirks

Section titled “Quirks”
  • 60-second server timeout — splitting across many groupBy dimensions grows the CSV exponentially and times out large pulls; narrow the date range or dimensions.
  • Revenue (revenue_sum) is estimated; finalizes later.
  • For a unified per-network view across Unity + other networks, query the LevelPlay reporting API, not this one.

References

Section titled “References”

Gotchas

Section titled “Gotchas”
  • Unity Ads ↔ LevelPlay overlap — if LevelPlay is the mediator, do NOT also call Unity Ads SDK directly; double-counting + ad serving conflicts result.
  • Unity LevelPlay events fire on a different thread than Unity main — marshal to main before mutating GameObjects or Time.timeScale.
  • Rewarded video has a floor on session count before a network considers it fillable — do not test on a fresh device and conclude no fill is broken.