> ## 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

> 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](/en/cli/reporting), [Auction Inspection](/en/cli/auction-inspection), and [Configuration](/en/cli/configuration).

## Reporting Basics

### Dashboard Summary For Today By Default

```bash theme={null}
cloudx report dashboard
```

### Dashboard Summary Filtered By Country And Device OS

```bash theme={null}
cloudx report dashboard --period last_7d --country US --device-os iOS
```

### Dashboard Summary Across CloudX And External Mediators

```bash theme={null}
cloudx report dashboard --period last_7d --source all
```

### Dashboard Chart By UTC Hour

```bash theme={null}
cloudx report dashboard --period 2026-04-01 --granularity hourly
```

### Dashboard JSON Output For A Custom Date Range

```bash theme={null}
cloudx report dashboard --period 2026-04-01..2026-04-07 --json
```

### Longer Timeout For A Heavy Report

```bash theme={null}
cloudx --timeout 90s report export --period 2026-04-01..2026-04-07
```

## Breakdown Reports

### Revenue And eCPM By Day And Country

```bash theme={null}
cloudx report breakdown --period last_7d --by day,country --metrics revenue,impressions,ecpm
```

### Hourly Fill Rate By App

```bash theme={null}
cloudx report breakdown --period 2026-04-01 --granularity hourly --by hour,app --metrics requests,impressions,fill_rate
```

### Top Ad Units By Revenue

```bash theme={null}
cloudx report breakdown --by app,ad_unit --metrics revenue,ecpm --top 10
```

### Breakdown JSON With A Metric Filter

```bash theme={null}
cloudx report breakdown --by country --metrics revenue,impressions --having 'revenue > 10' --json
```

## Bidder Reports

### Bidder Performance For Today By Default

```bash theme={null}
cloudx report bidders
```

### Include Both Production And Test Traffic

```bash theme={null}
cloudx report bidders --period last_30d --test-mode all --country US
```

### Bidder Report As JSON

```bash theme={null}
cloudx report bidders --period yesterday --json
```

## App Reports

### App Performance For Today By Default

```bash theme={null}
cloudx report apps
```

### Filter By Device OS

```bash theme={null}
cloudx report apps --period last_30d --device-os Android
```

### Compare CloudX With AppLovin By App

```bash theme={null}
cloudx report apps --period last_30d --source cloudx,applovin
```

### Single-Day App Report As JSON

```bash theme={null}
cloudx report apps --period 2026-04-01 --json
```

## Ad Unit Reports

### Ad Unit Performance For Today By Default

```bash theme={null}
cloudx report ad-units
```

### Filter By App And Ad Unit Type

```bash theme={null}
cloudx report ad-units --app com.example.game --ad-unit-type BANNER
```

### Include External Mediator ILRD For One App's Ad Units

```bash theme={null}
cloudx report ad-units --app com.example.game --source all
```

### Ad Unit Report As JSON

```bash theme={null}
cloudx report ad-units --period last_7d --country US --device-os iOS --json
```

## Impression-Level Revenue Exports

### Queue A Completed UTC Day

```bash theme={null}
cloudx report impressions export --date 2026-07-16
```

### Wait And Download The Gzip CSV

```bash theme={null}
cloudx report impressions export --date 2026-07-16 --output ./impressions-2026-07-16.csv.gz
```

### Filter By App, Country, And Device OS

```bash theme={null}
cloudx report impressions export \
  --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

```bash theme={null}
gzip -t ./impressions-2026-07-16.csv.gz
gzip -cd ./impressions-2026-07-16.csv.gz | head
```

## Export

### Export Today As CSV To Standard Output

```bash theme={null}
cloudx report export
```

### Export CSV Filtered By Country And Device OS

```bash theme={null}
cloudx report export --period last_30d --country US --device-os iOS
```

### Export CSV With UTC Hour Buckets

```bash theme={null}
cloudx report export --period 2026-04-01 --granularity hourly
```

### Export JSON Instead Of CSV

```bash theme={null}
cloudx report export --period 2026-04-01..2026-04-07 --json
```

### Save CSV To A File

```bash theme={null}
cloudx report export --period last_7d > report.csv
```

## Auction Inspection

### List Auctions For Today

```bash theme={null}
cloudx auction list --period today --test-mode all
```

### List Auctions With CloudX ILRD

```bash theme={null}
cloudx auction list --period yesterday --has-ilrd
```

### List Auctions With External Mediator ILRD

```bash theme={null}
cloudx auction list --period today --has-external-ilrd --mediator applovin
```

### List Auctions With Inventory And Device Filters

```bash theme={null}
cloudx auction list --period today --app com.example.game --ad-unit-id adunit_interstitial_1 --country GB --device-os Android --limit 10
```

### Show One Auction With Related Rows

```bash theme={null}
cloudx auction show auc_123 --with rounds,bids,ilrd,external-ilrd --json
```

### Inspect Rounds For One Auction

```bash theme={null}
cloudx auction rounds --auction-id auc_123
```

### Aggregate Round Metrics

```bash theme={null}
cloudx auction rounds --period today --metric skip-reason --test-mode all
```

### List Bids By Effective Floor Source

```bash theme={null}
cloudx auction bids --period today --floor-source dynamic --country US --json
```

## Configuration

### Show The Live Config

```bash theme={null}
cloudx config show
```

### Show A Published Config Version

```bash theme={null}
cloudx config show --version 12
```

### Show A Config Draft With Metadata

```bash theme={null}
cloudx config show --draft --with-metadata
```

### Print Raw Config Data As JSON

```bash theme={null}
cloudx config show --id cfg_123 --json
```

### Validate A Local Config File

```bash theme={null}
cloudx config validate config.yaml
```

### Validate A Draft As JSON

```bash theme={null}
cloudx config validate --id draft_123 --json
```

### Create A Draft Line Item

```bash theme={null}
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

```bash theme={null}
cloudx config edit update-line-item --id li_123 --status paused
```

### Change A Line Item Floor And Fail On Warnings

```bash theme={null}
cloudx config edit update-line-item --id li_123 --bidfloor 1.5 --strict
```

### Delete A Line Item From A Draft

```bash theme={null}
cloudx config edit delete-line-item --id li_123 --summary "Remove old rewarded line item"
```

### Publish A Draft Config

```bash theme={null}
cloudx config publish --id draft_123 --version-label "May floor update"
```

### Adjust A Bid Floor And Publish

```bash theme={null}
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

```bash theme={null}
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"
```

## Related

* [CloudX CLI Overview](/en/cli)
* [Installation](/en/cli/installation)
* [Authentication Commands](/en/cli/authentication)
* [Reporting Commands](/en/cli/reporting)
* [Auction Inspection](/en/cli/auction-inspection)
* [Configuration](/en/cli/configuration)