Skip to content

t1k:marketing:monetization:cloudx

FieldValue
Modulemonetization
Version1.16.9
Efforthigh
Tools—
/t1k:marketing:monetization:cloudx

CloudX mediation setup and revenue reporting integration (per-demand-source dashboards).

  • Pulling CloudX mediation revenue via the reporting API
  • Building per-demand-source (bidder) revenue breakdowns
  • Ingesting CloudX revenue into ad_revenue_daily → marketing-hub unified_metrics_daily

CloudX is an ad-network MEDIATION / aggregator (publisher-side reporting), not a single demand source.

  • Base: https://provisioning.cloudx.io/api/v1
  • Auth: Authorization: Bearer <reportKey> — key format sk_…, a single global account key (NOT per-app, NOT OAuth).
  • Endpoint: GET /report/breakdown.
ParamValue
start_time / end_timeUnix SECONDS, inclusive. Range ≤ 31 days per call.
bydimension CSV — any of day,country,os,app,ad_unit,format,bidder
metricsCSV — any of revenue,impressions,ecpm,requests,clicks,ctr,fill_rate
granularitydaily
test_modeproduction
{
"dimensions": [],
"metrics": [],
"rows": [ { "dimensions": { "k": "str" }, "metrics": { "k": 0.0 } } ],
"row_count": 0
}
  • rows capped at ≤ 100k.
  • dimensions values are strings; metrics values are numbers.
  • revenue is decimal USD — NOT micros. Never divide by 1e6.
  • Sample volume ~$53–68/day.
  • Gross-vs-net not yet confirmed with the vendor — assume gross USD; confirm before trusting totals.

Per-demand-source dimension — bidder (no two-call conflict)

Section titled “Per-demand-source dimension — bidder (no two-call conflict)”
  • by=bidder gives the per-demand-source breakdown — CloudX’s AD_SOURCE equivalent (cf. AdMob AD_SOURCE, AppLovin network).
  • CloudX reporting is publisher-side: there is no per-buyer “responses / filled” count. fill_rate is reported, but there is no responses base behind it.
  • Range ≤ 31 days → chunk longer backfills into ≤31-day windows.
  • All periods are UTC.
  • The day dimension is already formatted YYYY-MM-DD (no epoch math on output rows).
  • As a MEDIATION, isolate CloudX’s own-mediation revenue when aggregating to avoid double-counting against any overlapping MAX demand (mirror the AdMob MEDIATION_GROUP rule documented in the admob skill). CloudX’s mediated total already spans its demand sources — do not also add a network that CloudX itself mediates.
  • apps/cloudx-api (peer of mintegral-monet-api), port 17402.
  • Ingests into ad_revenue_daily → marketing-hub unified_metrics_daily with source='cloudx'.
  • CloudX reporting (live-verified 2026-06-24): GET https://provisioning.cloudx.io/api/v1/report/breakdown (Bearer sk_…).