Examples

Copy-paste examples for common CloudX CLI workflows, including sign-in, auction inspection, configuration, reporting, JSON output, and CSV export.

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

Activity Exports

Queue A Completed UTC Day

cloudx export impressions --date 2026-07-16

Wait And Download The Gzip CSV

cloudx export impressions --date 2026-07-16 --output ./impressions-2026-07-16.csv.gz

Filter By App, Country, And Device OS

cloudx export impressions \
  --date 2026-07-16 \
  --app com.example.game \
  --country US \
  --device-os iOS \
  --output ./example-game-us-ios.csv.gz

Validate And Preview The Download

gzip -t ./impressions-2026-07-16.csv.gz
gzip -cd ./impressions-2026-07-16.csv.gz | head

Download Request Activity

cloudx export requests --date 2026-08-10 --output ./requests-2026-08-10.csv.gz

Download Bid Responses Only

cloudx export bids --date 2026-08-10 --bids-only --output ./bids-2026-08-10.csv.gz

Aggregate Report 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

Print Raw Config Data As JSON

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"