Skip to content
/
Win/Loss

Win/Loss

Request

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

FieldTime WindowsRollups
Dimensions
agg_timestampcurrent_day, last_X_hours, yesterday, last_X_days, month_to_dateby_hour, by_day, by_week, by_month
advertiser_id
AnyAny
advertiser_name
AnyAny
advertiser_status
Active Status		AnyAny
agency_id
AnyAny
agency_name
AnyAny
agency_status
Active Status		AnyAny
campaign_archived
AnyAny
campaign_conversion_type
AnyAny
campaign_conversion_variable_minutes
AnyAny
campaign_created_on
Campaign Creation Time		AnyAny
campaign_currency_code
Campaign Currency Code		AnyAny
campaign_custom_attribution_source
AnyAny
campaign_dynamic_budget_allocation_type
AnyAny
campaign_end_date
(GMT) Campaign End Date		AnyAny
campaign_end_date_campaign_tz
(CTZ) Campaign End Date		AnyAny
campaign_frequency_amount
Campaign Frequency Amount		AnyAny
campaign_frequency_interval
Campaign Frequency Interval		AnyAny
campaign_frequency_optimization
Campaign Frequency Optimization		AnyAny
campaign_frequency_type
Campaign Frequency Type		AnyAny
campaign_goal_type
AnyAny
campaign_goal_value
AnyAny
campaign_has_custom_attribution
AnyAny
campaign_id
AnyAny
campaign_impression_cap_amount
AnyAny
campaign_impression_cap_automatic
AnyAny
campaign_impression_cap_type
AnyAny
campaign_initial_start_date
(GMT) Campaign Initial Start Date		AnyAny
campaign_initial_start_date_campaign_tz
(CTZ) Campaign Initial Start Date		AnyAny
campaign_io_name
AnyAny
campaign_io_reference_num
AnyAny
campaign_is_programmatic_guaranteed
Campaign Is Programmatic Guaranteed		AnyAny
campaign_name
AnyAny
campaign_pc_window_minutes
AnyAny
campaign_political
AnyAny
campaign_pv_pct
AnyAny
campaign_pv_window_minutes
AnyAny
campaign_service_type
Campaign Service Type, a.k.a. Managed Service Flag / managed_service_flag		AnyAny
campaign_spend_cap_amount
AnyAny
campaign_spend_cap_automatic
AnyAny
campaign_spend_cap_daily_cap
AnyAny
campaign_spend_cap_type
AnyAny
campaign_start_date
(GMT) Campaign Start Date		AnyAny
campaign_start_date_campaign_tz
(CTZ) Campaign Start Date		AnyAny
campaign_status
Active Status		AnyAny
campaign_total_budget
AnyAny
campaign_total_impression_budget
Campaign Impressions Budget		AnyAny
campaign_updated_on
Campaign Update Time		AnyAny
campaign_zone_name
Campaign Time Zone, a.k.a time_zone		AnyAny
deal_external_id
AnyAny
deal_group_id
AnyAny
deal_group_name
AnyAny
deal_id
AnyAny
deal_name
AnyAny
deal_price_type
AnyAny
deal_publisher_id
Deal Publisher ID		AnyAny
exchange_id
AnyAny
exchange_name
AnyAny
organization_id
AnyAny
organization_name
AnyAny
strategy_archived
AnyAny
strategy_audience_segment_exclude_op
AnyAny
strategy_audience_segment_include_op
AnyAny
strategy_bid_aggressiveness
AnyAny
strategy_bid_price_is_media_only
AnyAny
strategy_budget
AnyAny
strategy_channel
AnyAny
strategy_created_on
AnyAny
strategy_description
AnyAny
strategy_end_date
AnyAny
strategy_exchange_type_for_run_on_all
AnyAny
strategy_frequency_amount
AnyAny
strategy_frequency_interval
Campaign Frequency Interval		AnyAny
strategy_frequency_optimization
AnyAny
strategy_frequency_type
Campaign Frequency Type		AnyAny
strategy_goal_type
AnyAny
strategy_goal_value
AnyAny
strategy_group_created_on
AnyAny
strategy_group_description
AnyAny
strategy_group_external_identifier
AnyAny
strategy_group_id
AnyAny
strategy_group_impression_cap_amount
AnyAny
strategy_group_impression_cap_type
AnyAny
strategy_group_name
AnyAny
strategy_group_spend_cap_amount
AnyAny
strategy_group_spend_cap_type
AnyAny
strategy_group_updated_on
AnyAny
strategy_groups
AnyAny
strategy_id
AnyAny
strategy_impression_pacing_amount
AnyAny
strategy_impression_pacing_interval
AnyAny
strategy_impression_pacing_type
AnyAny
strategy_max_bid
AnyAny
strategy_max_bid_wm
AnyAny
strategy_min_bid
AnyAny
strategy_name
AnyAny
strategy_pacing_amount
AnyAny
strategy_pacing_interval
AnyAny
strategy_pacing_optimization_amount
AnyAny
strategy_pacing_optimization_type
AnyAny
strategy_pacing_type
AnyAny
strategy_roi_target
AnyAny
strategy_site_restriction_transparent_urls
AnyAny
strategy_start_date
AnyAny
strategy_status
Active Status		AnyAny
strategy_targeting_segment_exclude_op
AnyAny
strategy_targeting_segment_include_op
AnyAny
strategy_updated_on
AnyAny
strategy_use_campaign_end
AnyAny
strategy_use_campaign_start
AnyAny
strategy_use_mm_freq
AnyAny
strategy_use_optimization
AnyAny
Metrics
average_bid_amount_cpm
AnyAny
average_win_amount_cpm
AnyAny
bid_rate
AnyAny
bids
AnyAny
matched_bid_opportunities
AnyAny
max_bid_amount_cpm
AnyAny
max_win_amount_cpm
AnyAny
min_bid_amount_cpm
AnyAny
min_win_amount_cpm
AnyAny
pacing_matched_bid_opportunities
AnyAny
total_bid_amount_cpm
AnyAny
total_win_amount_cpm
AnyAny
win_rate
AnyAny
wins
AnyAny

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

Security
Auth0(Required scopes: offline_access)
Bodyapplication/jsonrequired
One of:
end_timestring or null, (date-time)
fieldsArray of strings, non-empty, uniquerequired
filtersArray of objects, non-emptyrequired
full_entitiesArray of strings or null, non-empty, unique
max_resultsinteger or null, >= 1

Maximum number of results to return. Only applicable for streaming responses. No limit if absent or null.

orderArray of objects
paginationobject or null

Streaming response if absent or null, Paginated response otherwise

rollupstringrequired
start_timestring, (date-time)
time_windowstring
time_zonestring

Only in supported datasets: campaign, UTC or a time zone name defined in https://www.iana.org/time-zones

curl -i -X POST \
  https://api.mediamath.com/reporting/v2/win-loss \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "fields": [
      "campaign_id",
      "impressions"
    ],
    "filters": [
      {
        "field": "organization_id",
        "op": "=",
        "value": 123456
      },
      {
        "field": "agency_id",
        "value": [
          123456,
          789012
        ]
      },
      {
        "field": "advertiser_id",
        "value": 123456
      },
      {
        "field": "campaign_name",
        "op": "=~",
        "value": "Test Campaign"
      }
    ],
    "order": [
      {
        "desc": false,
        "field": "agg_timestamp",
        "nulls_last": true
      }
    ],
    "pagination": {
      "page_index": 0,
      "page_size": 100
    },
    "rollup": "by_hour",
    "time_window": "current_day"
  }'

Responses

JSON for Paginated, JSONL for Streaming

Body
metaobject
resultsArray of objects
Response
{
  "meta": {
    "items_count": 3,
    "page_index": 0,
    "status": "OK",
    "total_items_count": 3,
    "total_pages": 1
  },
  "results": [
    { … },
    { … },
    { … }
  ]
}