Skip to main content

​
Reporting

Available commands:
  • cloudx report dashboard for summary and daily metrics
  • cloudx report bidders for bidder performance
  • cloudx report apps for app performance
  • cloudx report ad-units for ad unit performance
  • cloudx report export for CSV or JSON export

​
Shared Flags

The reporting commands share a common set of flags.
FlagRequiredDescription
--periodNoTime range. Defaults to today. Supports today, yesterday, last_7d, last_30d, YYYY-MM-DD, or YYYY-MM-DD..YYYY-MM-DD.
--test-modeNoTest filter. Allowed values: production, test, all. Default: production.
--appNoApp bundle filter. Only supported by report ad-units.
--ad-unit-typeNoAd unit type filter. Only supported by report ad-units. Allowed values: BANNER, INTERSTITIAL, REWARDED, MREC, NATIVE.
--countryNoISO-2 country code, for example US or GB.
--device-osNoDevice platform filter. Allowed values: iOS, Android.
--jsonNoEmit structured JSON instead of human-readable output.

​
Flag Support By Command

FlagDashboardBiddersAppsAd UnitsExport
--period✅✅✅✅✅
--test-mode✅✅✅✅❌
--app❌❌❌✅❌
--ad-unit-type❌❌❌✅❌
--country✅✅✅✅✅
--device-os✅✅✅✅✅
--json✅✅✅✅✅

​
Period Values

Period parsing is UTC-based. If you omit --period, every reporting command uses today.
ValueMeaning
todayCurrent UTC day
yesterdayPrevious UTC day
last_7dCurrent UTC day plus the previous 6 days
last_30dCurrent UTC day plus the previous 29 days
2026-04-01Single UTC day
2026-04-01..2026-04-07Inclusive UTC date range
Validation rules:
  • End date must not be earlier than start date.
  • --country must be a two-letter uppercase ISO-2 code after normalization.
  • --device-os must be exactly iOS or Android.
  • --test-mode must be production, test, or all.

​
Output Format

​
Human-Readable

Most commands print a metadata block first, then a table. Example metadata block: 
Period:      last_30d
Test mode:   production
Country:     US
Device OS:   iOS

​
JSON

Pass --json to return structured JSON: 
cloudx report dashboard --json
All command examples are collected on the Examples page.

​
cloudx report dashboard

Shows summary metrics and daily chart rows.

​
Usage

cloudx report dashboard [--period <value>] [flags]

​
Example

$ cloudx report dashboard
Period:      today
Test mode:   production

Requests:     1.5M
Impressions:  1.2M
Revenue:      $14.9K
Fill Rate:    78.0%
eCPM:         $12.7
Clicks:       35.1K
CTR:          3.0%
Users:        42K

DATE        REQUESTS  IMPRESSIONS  REVENUE  CLICKS
2026-03-29  210K      163.8K       $2.1K    4.9K

​
cloudx report bidders

Shows bidder-level performance for the selected time period.

​
Usage

cloudx report bidders [--period <value>] [flags]

​
Example

$ cloudx report bidders
Period:      today
Test mode:   production

BIDDER  REQUESTS  BIDS  BID RATE  IMPRESSIONS  WIN RATE  REVENUE  ECPM
meta    850K      629K  74.0%     314.5K       50.0%     $5.6K    $17.7

​
cloudx report apps

Shows app-level performance for the selected time period.

​
Usage

cloudx report apps [--period <value>] [flags]

​
Example

$ cloudx report apps
Period:      today
Test mode:   production

APP ID            NAME          PLATFORM  IMPRESSIONS  FILL RATE  REVENUE  ECPM
com.example.game  Example Game  iOS       1.8M         78.0%      $8.4K    $4.7

​
cloudx report ad-units

Shows ad-unit-level performance for the selected time period.

​
Usage

cloudx report ad-units [--period <value>] [flags]
This is the only reporting command that currently supports both --app and --ad-unit-type.

​
Example

$ cloudx report ad-units
Period:      today
Test mode:   production

AD UNIT ID  NAME                APP NAME      APP BUNDLE        TYPE    IMPRESSIONS  FILL RATE  REVENUE  ECPM
abc123      Home Screen Banner  Example Game  com.example.game  BANNER  450K         55.0%      $2.1K    $4.7

​
cloudx report export

Exports report data in CSV format by default.

​
Usage

cloudx report export [--period <value>] [flags]

​
Example

$ cloudx report export
date,network_name,country
2026-03-29,meta,US

​
JSON Output

With --json, the response includes:
  • columns
  • rows
  • row_count