# Reach and Frequency

Basic performance metrics as well as the "uniques" metric, broken out by frequency of ad exposure.  Available in standard intervals.
### Fields
| Field | Time Windows | Rollups |
|  --- | --- | --- |
| **Dimensions** |  |  |
| `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 |
| `frequency`<br>number of impressions seen by a unique user | Any | Any |
| `frequency_bin`<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** |  |  |
| `clicks`<br> | Any | Any |
| `ctc`<br>CTC | Any | Any |
| `ctr`<br>CTR | Any | Any |
| `general_invalid_clicks`<br> | Any | Any |
| `impressions`<br> | Any | Any |
| `post_click_conversions`<br>Post-Click Conversions | Any | Any |
| `post_view_conversions`<br>Post-View Conversions | Any | Any |
| `rr_per_1k_imps`<br>Response Rate/1K Imps | Any | Any |
| `total_clicks`<br> | Any | Any |
| `total_conversions`<br> | Any | Any |
| `uniques`<br> | Any | Any |

### Pageable
Yes
### Time Windows
`last_90_days`, `yesterday`, `last_7_days`, `last_14_days`, `last_30_days`, `last_60_days`
### Rollups
`all`

Endpoint: POST /reach-frequency
Version: 1.0.0
Security: Auth0

## Request fields (application/json):

  - `fields` (array, required)

  - `filters` (array, required)

  - `filters.field` (string)

  - `filters.filters` (array)

  - `filters.filters.field` (string)

  - `filters.filters.filters` (array)
    An array of filters. Required if `op` is `and` or `or`.

  - `filters.filters.op` (string)
    * `=`: Equals or contains if `value` is an array
* `!=`: Not equals
* `>`: Greater than
* `>=`: Greater than or equals
* `<`: Less than
* `<=`: Less than or equals
* `=~`: Text contains (case-insensitive)
* `and`: All filters must match
* `or`: At least one filter must match
* `isNull`: Is null
* `isNotNull`: Is not null

  - `filters.filters.value` (any)

  - `filters.op` (string)
    * `=`: Equals or contains if `value` is an array
* `!=`: Not equals
* `>`: Greater than
* `>=`: Greater than or equals
* `<`: Less than
* `<=`: Less than or equals
* `=~`: Text contains (case-insensitive)
* `and`: All filters must match
* `or`: At least one filter must match
* `isNull`: Is null
* `isNotNull`: Is not null

  - `filters.value` (any)

  - `full_entities` (array)

  - `max_results` (integer)
    Maximum number of results to return. Only applicable for streaming responses. No limit if absent or `null`.

  - `order` (array)

  - `order.desc` (boolean)

  - `order.field` (string, required)

  - `order.nulls_last` (boolean)

  - `pagination` (object)
    Streaming response if absent or `null`, Paginated response otherwise

  - `pagination.page_index` (integer)

  - `pagination.page_size` (integer)

  - `rollup` (string, required)

  - `time_window` (string, required)

  - `time_zone` (string)
    **Only in supported datasets:** `campaign`, `UTC` or a time zone name defined in https://www.iana.org/time-zones

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