# Win/Loss

Metrics describe the auction before a win or even a bid has taken place.  Broken out by strategy, exchange, and deal dimensions and available by hour.
### Fields
| Field | Time Windows | Rollups |
|  --- | --- | --- |
| **Dimensions** |  |  |
| `agg_timestamp` | `current_day`, `last_X_hours`, `yesterday`, `last_X_days`, `month_to_date` | `by_hour`, `by_day`, `by_week`, `by_month` |
| `advertiser_id`<br> | Any | Any |
| `advertiser_name`<br> | Any | Any |
| `agency_id`<br> | Any | Any |
| `agency_name`<br> | Any | Any |
| `campaign_archived`<br> | Any | Any |
| `campaign_conversion_type`<br> | Any | Any |
| `campaign_conversion_variable_minutes`<br> | Any | Any |
| `campaign_created_on`<br>Campaign Creation Time | Any | Any |
| `campaign_currency_code`<br>Campaign Currency Code | Any | Any |
| `campaign_custom_attribution_source`<br> | Any | Any |
| `campaign_dynamic_budget_allocation_type`<br> | Any | Any |
| `campaign_end_date`<br>(GMT) Campaign End Date | Any | Any |
| `campaign_end_date_campaign_tz`<br>(CTZ) Campaign End Date | Any | Any |
| `campaign_frequency_amount`<br>Campaign Frequency Amount | Any | Any |
| `campaign_frequency_interval`<br>Campaign Frequency Interval | Any | Any |
| `campaign_frequency_optimization`<br>Campaign Frequency Optimization | Any | Any |
| `campaign_frequency_type`<br>Campaign Frequency Type | Any | Any |
| `campaign_goal_type`<br> | Any | Any |
| `campaign_goal_value`<br> | Any | Any |
| `campaign_has_custom_attribution`<br> | Any | Any |
| `campaign_id`<br> | Any | Any |
| `campaign_impression_cap_amount`<br> | Any | Any |
| `campaign_impression_cap_automatic`<br> | Any | Any |
| `campaign_impression_cap_type`<br> | Any | Any |
| `campaign_initial_start_date`<br>(GMT) Campaign Initial Start Date | Any | Any |
| `campaign_initial_start_date_campaign_tz`<br>(CTZ) Campaign Initial Start Date | Any | Any |
| `campaign_io_name`<br> | Any | Any |
| `campaign_io_reference_num`<br> | Any | Any |
| `campaign_is_programmatic_guaranteed`<br>Campaign Is Programmatic Guaranteed | Any | Any |
| `campaign_name`<br> | Any | Any |
| `campaign_pc_window_minutes`<br> | Any | Any |
| `campaign_political`<br> | Any | Any |
| `campaign_pv_pct`<br> | Any | Any |
| `campaign_pv_window_minutes`<br> | Any | Any |
| `campaign_service_type`<br>Campaign Service Type, a.k.a. Managed Service Flag / managed_service_flag | Any | Any |
| `campaign_spend_cap_amount`<br> | Any | Any |
| `campaign_spend_cap_automatic`<br> | Any | Any |
| `campaign_spend_cap_daily_cap`<br> | Any | Any |
| `campaign_spend_cap_type`<br> | Any | Any |
| `campaign_start_date`<br>(GMT) Campaign Start Date | Any | Any |
| `campaign_start_date_campaign_tz`<br>(CTZ) Campaign Start Date | Any | Any |
| `campaign_status`<br>Active Status | Any | Any |
| `campaign_total_budget`<br> | Any | Any |
| `campaign_total_impression_budget`<br>Campaign Impressions Budget | Any | Any |
| `campaign_updated_on`<br>Campaign Update Time | Any | Any |
| `campaign_zone_name`<br>Campaign Time Zone, a.k.a time_zone | Any | Any |
| `deal_external_id`<br> | Any | Any |
| `deal_group_id`<br> | Any | Any |
| `deal_group_name`<br> | Any | Any |
| `deal_id`<br> | Any | Any |
| `deal_name`<br> | Any | Any |
| `deal_price_type`<br> | Any | Any |
| `deal_publisher_id`<br>Deal Publisher ID | Any | Any |
| `exchange_id`<br> | Any | Any |
| `exchange_name`<br> | Any | Any |
| `organization_id`<br> | Any | Any |
| `organization_name`<br> | Any | Any |
| `strategy_archived`<br> | Any | Any |
| `strategy_audience_segment_exclude_op`<br> | Any | Any |
| `strategy_audience_segment_include_op`<br> | Any | Any |
| `strategy_bid_aggressiveness`<br> | Any | Any |
| `strategy_bid_price_is_media_only`<br> | Any | Any |
| `strategy_budget`<br> | Any | Any |
| `strategy_channel`<br> | Any | Any |
| `strategy_created_on`<br> | Any | Any |
| `strategy_description`<br> | Any | Any |
| `strategy_end_date`<br> | Any | Any |
| `strategy_exchange_type_for_run_on_all`<br> | Any | Any |
| `strategy_frequency_amount`<br> | Any | Any |
| `strategy_frequency_interval`<br>Campaign Frequency Interval | Any | Any |
| `strategy_frequency_optimization`<br> | Any | Any |
| `strategy_frequency_type`<br>Campaign Frequency Type | Any | Any |
| `strategy_goal_type`<br> | Any | Any |
| `strategy_goal_value`<br> | Any | Any |
| `strategy_group_created_on`<br> | Any | Any |
| `strategy_group_description`<br> | Any | Any |
| `strategy_group_external_identifier`<br> | Any | Any |
| `strategy_group_id`<br> | Any | Any |
| `strategy_group_impression_cap_amount`<br> | Any | Any |
| `strategy_group_impression_cap_type`<br> | Any | Any |
| `strategy_group_name`<br> | Any | Any |
| `strategy_group_spend_cap_amount`<br> | Any | Any |
| `strategy_group_spend_cap_type`<br> | Any | Any |
| `strategy_group_updated_on`<br> | Any | Any |
| `strategy_groups`<br> | Any | Any |
| `strategy_id`<br> | Any | Any |
| `strategy_impression_pacing_amount`<br> | Any | Any |
| `strategy_impression_pacing_interval`<br> | Any | Any |
| `strategy_impression_pacing_type`<br> | Any | Any |
| `strategy_max_bid`<br> | Any | Any |
| `strategy_max_bid_wm`<br> | Any | Any |
| `strategy_min_bid`<br> | Any | Any |
| `strategy_name`<br> | Any | Any |
| `strategy_pacing_amount`<br> | Any | Any |
| `strategy_pacing_interval`<br> | Any | Any |
| `strategy_pacing_optimization_amount`<br> | Any | Any |
| `strategy_pacing_optimization_type`<br> | Any | Any |
| `strategy_pacing_type`<br> | Any | Any |
| `strategy_roi_target`<br> | Any | Any |
| `strategy_site_restriction_transparent_urls`<br> | Any | Any |
| `strategy_start_date`<br> | Any | Any |
| `strategy_status`<br>Active Status | Any | Any |
| `strategy_targeting_segment_exclude_op`<br> | Any | Any |
| `strategy_targeting_segment_include_op`<br> | Any | Any |
| `strategy_updated_on`<br> | Any | Any |
| `strategy_use_campaign_end`<br> | Any | Any |
| `strategy_use_campaign_start`<br> | Any | Any |
| `strategy_use_mm_freq`<br> | Any | Any |
| `strategy_use_optimization`<br> | Any | Any |
| **Metrics** |  |  |
| `average_bid_amount_cpm`<br> | Any | Any |
| `average_win_amount_cpm`<br> | Any | Any |
| `bid_rate`<br> | Any | Any |
| `bids`<br> | Any | Any |
| `matched_bid_opportunities`<br> | Any | Any |
| `max_bid_amount_cpm`<br> | Any | Any |
| `max_win_amount_cpm`<br> | Any | Any |
| `min_bid_amount_cpm`<br> | Any | Any |
| `min_win_amount_cpm`<br> | Any | Any |
| `pacing_matched_bid_opportunities`<br> | Any | Any |
| `total_bid_amount_cpm`<br> | Any | Any |
| `total_win_amount_cpm`<br> | Any | Any |
| `win_rate`<br> | Any | Any |
| `wins`<br> | Any | Any |

### Pageable
Yes
### Time Windows
`current_day`, `last_X_hours`, `yesterday`, `last_X_days`, `month_to_date`
### Rollups
`all`, `by_hour`, `by_day`, `by_week`, `by_month`
### Data Retention / Lookback Window
1 year

Endpoint: POST /win-loss
Version: 1.0.0
Security: Auth0

## Response 200 fields (application/json):

  - `meta` (object)

  - `meta.items_count` (integer)

  - `meta.page_index` (integer)

  - `meta.status` (string)
    Enum: "OK"

  - `meta.total_items_count` (integer)

  - `meta.total_pages` (integer)

  - `results` (array)

## Response 400 fields (application/json):

  - `error_code` (string)

  - `message` (string)

  - `request_id` (string)

## Response 401 fields (application/json):

  - `error_code` (string)

  - `message` (string)

  - `request_id` (string)

## Response 5XX fields (application/json):

  - `error_code` (string)

  - `message` (string)

  - `request_id` (string)