Skip to main content

​
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

​
Validate A Local Config File

cloudx config validate config.yaml

​
Validate A Draft As JSON

cloudx config validate --id draft_123 --json

​
Create A Draft Line Item

cloudx config edit create-line-item \
  --name "US Rewarded" \
  --priority 2 \
  --bidfloor 1.5 \
  --ad-unit-id au_123 \
  --bidder meta \
  --bidder unityAds

​
Pause A Line Item

cloudx config edit update-line-item --id li_123 --status paused

​
Change A Line Item Floor And Fail On Warnings

cloudx config edit update-line-item --id li_123 --bidfloor 1.5 --strict

​
Delete A Line Item From A Draft

cloudx config edit delete-line-item --id li_123 --summary "Remove old rewarded line item"

​
Publish A Draft Config

cloudx config publish --id draft_123 --version-label "May floor update"

​
Adjust A Bid Floor And Publish

cloudx config edit update-line-item --id li_123 --bidfloor 1.5 --summary "Raise US rewarded floor"
cloudx config validate --id draft_123
cloudx config publish --id draft_123 --version-label "Raise US rewarded floor"

​
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
cloudx config validate config.yaml --strict
cloudx config edit update-line-item --id li_123 --bidfloor 1.5
cloudx config publish --id draft_123 --version-label "Raise US rewarded floor"