# report/demand-comparison/ad-units field reference > Field and value reference for GET /report/demand-comparison/ad-units. ## Demand Comparison ad-unit reference This endpoint rolls up the full requested calendar-date window for one partner source. It does not expose day, country, platform, mediator, or raw partner-report rows. Its date and timezone rules match the Demand Comparison summary endpoint. `demand_source` is required and accepts exactly one of `digitalturbine`, `inmobi`, `liftoff`, `meta`, or `moloco`. `provider_business_id`, `provider_property_id`, and `cloudx_ad_unit_id` are optional comma-separated filters. They accept live provider or CloudX identifiers, not closed enums. Provider IDs identify the partner account or property. CloudX IDs identify CloudX ad units. `view` is `mapped` or `unmapped`, and defaults to `mapped`. `mapped` returns partner ad-unit aggregates with a current CloudX mapping. `unmapped` returns partner rows with no current CloudX mapping or ambiguous attribution. `limit` is `1` through `1000` and defaults to `1000`. The response has no pagination cursor. Use filters when `truncated` is `true`. The response contains `rows`, `row_count`, `limit`, and `truncated`. `row_count` is the number of rows returned, not the total available. `limit` is the applied maximum. `truncated` is `true` when more matching rows exist. Every row has these CloudX metrics: | Field | Meaning | | -------------------- | ------------------------------------------------------------------------------- | | `cloudx_revenue` | CloudX-recognized revenue. | | `cloudx_ecpm` | `cloudx_revenue * 1000 / cloudx_impressions`, or `0` when impressions are zero. | | `cloudx_impressions` | CloudX impression count. | The following partner and delta fields are numbers only when partner data is available for the row. An absent field means unavailable. It does not mean zero. Provider suppression can leave revenue unavailable even when report dates are covered. In the unmapped view, read `excluded_partner_revenue` and `excluded_partner_impressions` for excluded activity, not the mapped comparison metrics. | Field | Meaning | | -------------------------- | ---------------------------------------------------------------------------------------------------------------- | | `partner_revenue` | Partner-reported revenue. | | `revenue_delta` | `cloudx_revenue - partner_revenue`. | | `revenue_delta_percent` | Revenue delta as a percentage of partner revenue. Absent when partner revenue is below `0.005`. | | `partner_ecpm` | `partner_revenue * 1000 / partner_impressions`, or `0` when impressions are zero. Requires both partner metrics. | | `ecpm_delta` | `cloudx_ecpm - partner_ecpm`. | | `ecpm_delta_percent` | eCPM delta as a percentage of partner eCPM. Absent when partner eCPM is below `0.005`. | | `partner_impressions` | Partner-reported impression count. | | `impression_delta` | `cloudx_impressions - partner_impressions`. | | `impression_delta_percent` | Impression delta as a percentage of partner impressions. Absent when partner impressions are below `1`. | | Field | Meaning | | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | `demand_source` | The selected supported demand-source enum value. | | `status` | `comparable`, `not_connected`, `no_partner_data`, `unmapped_partner_data`, `stale_partner_data`, or `unmapped`. `unmapped` applies to the unmapped view. | | `provider_business_id` | Dynamic provider business ID. | | `provider_property_id` | Dynamic provider property ID. | | `partner_ad_unit_id` | Dynamic partner ad-unit ID. | | `partner_ad_unit_name` | Partner ad-unit name. | | `provider_endpoint` | Mapping-derived endpoint string, or comma-and-space-separated endpoint strings. May be empty; not a closed API enum. | | `demand_type` | Mapping-derived demand classification string, or comma-and-space-separated classifications. May be empty; not a closed API enum. | | `partner_ad_formats` | Provider format strings, not a closed API enum. May be an empty array when the provider does not supply a format. | | `cloudx_ad_unit_ids` | Associated dynamic CloudX ad-unit IDs. | | `excluded_partner_revenue` | In the unmapped view, partner revenue excluded from mapped comparison. It may be absent. | | `excluded_partner_impressions` | In the unmapped view, partner impressions excluded from mapped comparison. It may be absent. | CloudX applies `cloudx_ad_unit_id` after forming a partner-ad-unit aggregate. If any associated ID matches, the response keeps the aggregate's full metrics and complete `cloudx_ad_unit_ids` list. ### JSON example ```json { "rows": [ { "cloudx_revenue": 14.25, "partner_revenue": 13.9, "revenue_delta": 0.35, "revenue_delta_percent": 2.5179856115107913, "cloudx_ecpm": 11.875, "partner_ecpm": 11.583333333333334, "ecpm_delta": 0.2916666666666661, "ecpm_delta_percent": 2.5179856115107864, "cloudx_impressions": 1200, "partner_impressions": 1200, "impression_delta": 0, "impression_delta_percent": 0, "demand_source": "meta", "status": "comparable", "provider_business_id": "business-demo", "provider_property_id": "property-demo", "partner_ad_unit_id": "partner-unit-demo", "partner_ad_unit_name": "Sample banner", "provider_endpoint": "meta", "demand_type": "standard", "partner_ad_formats": [], "cloudx_ad_unit_ids": ["ad-unit-home"] } ], "row_count": 1, "limit": 1000, "truncated": false } ```