Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt

Use this file to discover all available pages before exploring further.

Examples

This page collects practical examples for the cloudx CLI. For command details and flag support, see Reporting Commands, Auction Inspection, and Configuration.

Reporting Basics

Dashboard Summary For Today By Default

cloudx report dashboard

Dashboard Summary Filtered By Country And Device OS

cloudx report dashboard --period last_7d --country US --device-os iOS

Dashboard Summary Across CloudX And External Mediators

cloudx report dashboard --period last_7d --source all

Dashboard Chart By UTC Hour

cloudx report dashboard --period 2026-04-01 --granularity hourly

Dashboard JSON Output For A Custom Date Range

cloudx report dashboard --period 2026-04-01..2026-04-07 --json

Longer Timeout For A Heavy Report

cloudx --timeout 90s report export --period 2026-04-01..2026-04-07

Breakdown Reports

Revenue And eCPM By Day And Country

cloudx report breakdown --period last_7d --by day,country --metrics revenue,impressions,ecpm

Hourly Fill Rate By App

cloudx report breakdown --period 2026-04-01 --granularity hourly --by hour,app --metrics requests,impressions,fill_rate

Top Ad Units By Revenue

cloudx report breakdown --by app,ad_unit --metrics revenue,ecpm --top 10

Breakdown JSON With A Metric Filter

cloudx report breakdown --by country --metrics revenue,impressions --having 'revenue > 10' --json

Bidder Reports

Bidder Performance For Today By Default

cloudx report bidders

Include Both Production And Test Traffic

cloudx report bidders --period last_30d --test-mode all --country US

Bidder Report As JSON

cloudx report bidders --period yesterday --json

App Reports

App Performance For Today By Default

cloudx report apps

Filter By Device OS

cloudx report apps --period last_30d --device-os Android

Compare CloudX With AppLovin By App

cloudx report apps --period last_30d --source cloudx,applovin

Single-Day App Report As JSON

cloudx report apps --period 2026-04-01 --json

Ad Unit Reports

Ad Unit Performance For Today By Default

cloudx report ad-units

Filter By App And Ad Unit Type

cloudx report ad-units --app com.example.game --ad-unit-type BANNER

Include External Mediator ILRD For One App’s Ad Units

cloudx report ad-units --app com.example.game --source all

Ad Unit Report As JSON

cloudx report ad-units --period last_7d --country US --device-os iOS --json

Export

Export Today As CSV To Standard Output

cloudx report export

Export CSV Filtered By Country And Device OS

cloudx report export --period last_30d --country US --device-os iOS

Export CSV With UTC Hour Buckets

cloudx report export --period 2026-04-01 --granularity hourly

Export JSON Instead Of CSV

cloudx report export --period 2026-04-01..2026-04-07 --json

Save CSV To A File

cloudx report export --period last_7d > report.csv

Auction Inspection

List Auctions For Today

cloudx auction list --period today --test-mode all

List Auctions With CloudX ILRD

cloudx auction list --period yesterday --has-ilrd

List Auctions With External Mediator ILRD

cloudx auction list --period today --has-external-ilrd --mediator applovin

List Auctions With Inventory And Device Filters

cloudx auction list --period today --app com.example.game --ad-unit-id adunit_interstitial_1 --country GB --device-os Android --limit 10
cloudx auction show auc_123 --with rounds,bids,ilrd,external-ilrd --json

Inspect Rounds For One Auction

cloudx auction rounds --auction-id auc_123

Aggregate Round Metrics

cloudx auction rounds --period today --metric skip-reason --test-mode all

List Bids By Effective Floor Source

cloudx auction bids --period today --floor-source dynamic --country US --json

Configuration

Show The Live Config

cloudx config show

Show A Published Config Version

cloudx config show --version 12

Show A Config Draft With Metadata

cloudx config show --draft --with-metadata
cloudx config show --id cfg_123 --json

Combined Workflow

cloudx report dashboard
cloudx report breakdown --period last_7d --by day,country --metrics revenue,impressions,ecpm
cloudx report bidders --period last_7d --country US
cloudx report apps --period last_7d --source cloudx,applovin
cloudx report ad-units --app com.example.game --source all
cloudx report export --period last_7d > report.csv
cloudx auction list --period last_7d --has-external-ilrd
cloudx auction show auc_123 --with rounds,bids,ilrd
cloudx config show --version 12