CloudX source
The CloudX source connector syncs daily monetization performance data from the CloudX API.
Setup
- In CloudX, open Settings > API Keys and create an API key with the
reports:readpermission. - In your workspace, add a new CloudX source.
- Enter the API key and connect the source.
Authentication
CloudX uses Bearer token authentication. Extract validates the API key with GET /auth/status before syncing data.
Configuration
| Field | Scope | Required | Description |
|---|---|---|---|
| API key | Source | Yes | CloudX API key with the reports:read permission. |
| Backfill (Days) | Connection | Yes | Number of recent report days re-synced on each run. Defaults to 7. |
Sync behavior
Each report is requested one day at a time and stored using date as its partition key. After the initial sync, Extract advances the stream cursor while re-reading the configured backfill window so late reporting changes are refreshed.
The app, ad unit, and bidder reports use UTC days and default to production traffic. Test-mode traffic and caller-defined report breakdowns are not currently exposed by this connector.
The optional network_report stream retrieves reports from networks connected in CloudX under Settings > Data Sources. In addition to reports:read, your CloudX account must have network reporting enabled; contact your CloudX account manager if access is denied. After the stream becomes available, refresh your connection catalog and explicitly enable it.
Network reports include every documented breakdown: network and account identifiers, app, placement, country, platform, ad format, source timezone, and currency. day is the date in the network's source_timezone; date is an identical partition key. These dates are not converted to UTC. Revenue stays in the reported currency, which can be unknown (null). Count metrics remain decimal strings to preserve large values; missing metrics remain null, and zero remains zero.
Extract reads network reports one day at a time, using snapshot pagination so updates cannot mix results from different versions of the same day. If upstream network coverage is missing or a collection failed, Extract writes the available rows and logs a warning. The backfill window refreshes recent dates. Missing or revised data older than that window requires a historical rerun.
Data streams
ad_units_report
apps_report
bidders_report
network_report
Schema ERD
Explore the interactive entity relationship diagram for CloudX.