# 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` | Any | Any |
| `advertiser_name` | Any | Any |
| `agency_id` | Any | Any |
| `agency_name` | Any | Any |
| `campaign_archived` | Any | Any |
| `campaign_conversion_type` | Any | Any |
| `campaign_conversion_variable_minutes` | Any | Any |
| `campaign_created_on`Campaign Creation Time | Any | Any |
| `campaign_currency_code`Campaign Currency Code | Any | Any |
| `campaign_custom_attribution_source` | Any | Any |
| `campaign_dynamic_budget_allocation_type` | Any | Any |
| `campaign_end_date`(GMT) Campaign End Date | Any | Any |
| `campaign_end_date_campaign_tz`(CTZ) Campaign End Date | Any | Any |
| `campaign_frequency_amount`Campaign Frequency Amount | Any | Any |
| `campaign_frequency_interval`Campaign Frequency Interval | Any | Any |
| `campaign_frequency_optimization`Campaign Frequency Optimization | Any | Any |
| `campaign_frequency_type`Campaign Frequency Type | Any | Any |
| `campaign_goal_type` | Any | Any |
| `campaign_goal_value` | Any | Any |
| `campaign_has_custom_attribution` | Any | Any |
| `campaign_id` | Any | Any |
| `campaign_impression_cap_amount` | Any | Any |
| `campaign_impression_cap_automatic` | Any | Any |
| `campaign_impression_cap_type` | Any | Any |
| `campaign_initial_start_date`(GMT) Campaign Initial Start Date | Any | Any |
| `campaign_initial_start_date_campaign_tz`(CTZ) Campaign Initial Start Date | Any | Any |
| `campaign_io_name` | Any | Any |
| `campaign_io_reference_num` | Any | Any |
| `campaign_is_programmatic_guaranteed`Campaign Is Programmatic Guaranteed | Any | Any |
| `campaign_name` | Any | Any |
| `campaign_pc_window_minutes` | Any | Any |
| `campaign_political` | Any | Any |
| `campaign_pv_pct` | Any | Any |
| `campaign_pv_window_minutes` | Any | Any |
| `campaign_service_type`Campaign Service Type, a.k.a. Managed Service Flag / managed_service_flag | Any | Any |
| `campaign_spend_cap_amount` | Any | Any |
| `campaign_spend_cap_automatic` | Any | Any |
| `campaign_spend_cap_daily_cap` | Any | Any |
| `campaign_spend_cap_type` | Any | Any |
| `campaign_start_date`(GMT) Campaign Start Date | Any | Any |
| `campaign_start_date_campaign_tz`(CTZ) Campaign Start Date | Any | Any |
| `campaign_status`Active Status | Any | Any |
| `campaign_total_budget` | Any | Any |
| `campaign_total_impression_budget`Campaign Impressions Budget | Any | Any |
| `campaign_updated_on`Campaign Update Time | Any | Any |
| `campaign_zone_name`Campaign Time Zone, a.k.a time_zone | Any | Any |
| `frequency`number of impressions seen by a unique user | Any | Any |
| `frequency_bin` | Any | Any |
| `organization_id` | Any | Any |
| `organization_name` | Any | Any |
| `strategy_archived` | Any | Any |
| `strategy_audience_segment_exclude_op` | Any | Any |
| `strategy_audience_segment_include_op` | Any | Any |
| `strategy_bid_aggressiveness` | Any | Any |
| `strategy_bid_price_is_media_only` | Any | Any |
| `strategy_budget` | Any | Any |
| `strategy_channel` | Any | Any |
| `strategy_created_on` | Any | Any |
| `strategy_description` | Any | Any |
| `strategy_end_date` | Any | Any |
| `strategy_exchange_type_for_run_on_all` | Any | Any |
| `strategy_frequency_amount` | Any | Any |
| `strategy_frequency_interval`Campaign Frequency Interval | Any | Any |
| `strategy_frequency_optimization` | Any | Any |
| `strategy_frequency_type`Campaign Frequency Type | Any | Any |
| `strategy_goal_type` | Any | Any |
| `strategy_goal_value` | Any | Any |
| `strategy_group_created_on` | Any | Any |
| `strategy_group_description` | Any | Any |
| `strategy_group_external_identifier` | Any | Any |
| `strategy_group_id` | Any | Any |
| `strategy_group_impression_cap_amount` | Any | Any |
| `strategy_group_impression_cap_type` | Any | Any |
| `strategy_group_name` | Any | Any |
| `strategy_group_spend_cap_amount` | Any | Any |
| `strategy_group_spend_cap_type` | Any | Any |
| `strategy_group_updated_on` | Any | Any |
| `strategy_groups` | Any | Any |
| `strategy_id` | Any | Any |
| `strategy_impression_pacing_amount` | Any | Any |
| `strategy_impression_pacing_interval` | Any | Any |
| `strategy_impression_pacing_type` | Any | Any |
| `strategy_max_bid` | Any | Any |
| `strategy_max_bid_wm` | Any | Any |
| `strategy_min_bid` | Any | Any |
| `strategy_name` | Any | Any |
| `strategy_pacing_amount` | Any | Any |
| `strategy_pacing_interval` | Any | Any |
| `strategy_pacing_optimization_amount` | Any | Any |
| `strategy_pacing_optimization_type` | Any | Any |
| `strategy_pacing_type` | Any | Any |
| `strategy_roi_target` | Any | Any |
| `strategy_site_restriction_transparent_urls` | Any | Any |
| `strategy_start_date` | Any | Any |
| `strategy_status`Active Status | Any | Any |
| `strategy_targeting_segment_exclude_op` | Any | Any |
| `strategy_targeting_segment_include_op` | Any | Any |
| `strategy_updated_on` | Any | Any |
| `strategy_use_campaign_end` | Any | Any |
| `strategy_use_campaign_start` | Any | Any |
| `strategy_use_mm_freq` | Any | Any |
| `strategy_use_optimization` | Any | Any |
| **Metrics** |  |  |
| `clicks` | Any | Any |
| `ctc`CTC | Any | Any |
| `ctr`CTR | Any | Any |
| `general_invalid_clicks` | Any | Any |
| `impressions` | Any | Any |
| `post_click_conversions`Post-Click Conversions | Any | Any |
| `post_view_conversions`Post-View Conversions | Any | Any |
| `rr_per_1k_imps`Response Rate/1K Imps | Any | Any |
| `total_clicks` | Any | Any |
| `total_conversions` | Any | Any |
| `uniques` | Any | Any |

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

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

## Description:

  - `Fields` ()
    FieldTime WindowsRollupsDimensionsadvertiser_idAnyAnyadvertiser_nameAnyAnyagency_idAnyAnyagency_nameAnyAnycampaign_archivedAnyAnycampaign_conversion_typeAnyAnycampaign_conversion_variable_minutesAnyAnycampaign_created_onCampaign Creation TimeAnyAnycampaign_currency_codeCampaign Currency CodeAnyAnycampaign_custom_attribution_sourceAnyAnycampaign_dynamic_budget_allocation_typeAnyAnycampaign_end_date(GMT) Campaign End DateAnyAnycampaign_end_date_campaign_tz(CTZ) Campaign End DateAnyAnycampaign_frequency_amountCampaign Frequency AmountAnyAnycampaign_frequency_intervalCampaign Frequency IntervalAnyAnycampaign_frequency_optimizationCampaign Frequency OptimizationAnyAnycampaign_frequency_typeCampaign Frequency TypeAnyAnycampaign_goal_typeAnyAnycampaign_goal_valueAnyAnycampaign_has_custom_attributionAnyAnycampaign_idAnyAnycampaign_impression_cap_amountAnyAnycampaign_impression_cap_automaticAnyAnycampaign_impression_cap_typeAnyAnycampaign_initial_start_date(GMT) Campaign Initial Start DateAnyAnycampaign_initial_start_date_campaign_tz(CTZ) Campaign Initial Start DateAnyAnycampaign_io_nameAnyAnycampaign_io_reference_numAnyAnycampaign_is_programmatic_guaranteedCampaign Is Programmatic GuaranteedAnyAnycampaign_nameAnyAnycampaign_pc_window_minutesAnyAnycampaign_politicalAnyAnycampaign_pv_pctAnyAnycampaign_pv_window_minutesAnyAnycampaign_service_typeCampaign Service Type, a.k.a. Managed Service Flag / managed_service_flagAnyAnycampaign_spend_cap_amountAnyAnycampaign_spend_cap_automaticAnyAnycampaign_spend_cap_daily_capAnyAnycampaign_spend_cap_typeAnyAnycampaign_start_date(GMT) Campaign Start DateAnyAnycampaign_start_date_campaign_tz(CTZ) Campaign Start DateAnyAnycampaign_statusActive StatusAnyAnycampaign_total_budgetAnyAnycampaign_total_impression_budgetCampaign Impressions BudgetAnyAnycampaign_updated_onCampaign Update TimeAnyAnycampaign_zone_nameCampaign Time Zone, a.k.a time_zoneAnyAnyfrequencynumber of impressions seen by a unique userAnyAnyfrequency_binAnyAnyorganization_idAnyAnyorganization_nameAnyAnystrategy_archivedAnyAnystrategy_audience_segment_exclude_opAnyAnystrategy_audience_segment_include_opAnyAnystrategy_bid_aggressivenessAnyAnystrategy_bid_price_is_media_onlyAnyAnystrategy_budgetAnyAnystrategy_channelAnyAnystrategy_created_onAnyAnystrategy_descriptionAnyAnystrategy_end_dateAnyAnystrategy_exchange_type_for_run_on_allAnyAnystrategy_frequency_amountAnyAnystrategy_frequency_intervalCampaign Frequency IntervalAnyAnystrategy_frequency_optimizationAnyAnystrategy_frequency_typeCampaign Frequency TypeAnyAnystrategy_goal_typeAnyAnystrategy_goal_valueAnyAnystrategy_group_created_onAnyAnystrategy_group_descriptionAnyAnystrategy_group_external_identifierAnyAnystrategy_group_idAnyAnystrategy_group_impression_cap_amountAnyAnystrategy_group_impression_cap_typeAnyAnystrategy_group_nameAnyAnystrategy_group_spend_cap_amountAnyAnystrategy_group_spend_cap_typeAnyAnystrategy_group_updated_onAnyAnystrategy_groupsAnyAnystrategy_idAnyAnystrategy_impression_pacing_amountAnyAnystrategy_impression_pacing_intervalAnyAnystrategy_impression_pacing_typeAnyAnystrategy_max_bidAnyAnystrategy_max_bid_wmAnyAnystrategy_min_bidAnyAnystrategy_nameAnyAnystrategy_pacing_amountAnyAnystrategy_pacing_intervalAnyAnystrategy_pacing_optimization_amountAnyAnystrategy_pacing_optimization_typeAnyAnystrategy_pacing_typeAnyAnystrategy_roi_targetAnyAnystrategy_site_restriction_transparent_urlsAnyAnystrategy_start_dateAnyAnystrategy_statusActive StatusAnyAnystrategy_targeting_segment_exclude_opAnyAnystrategy_targeting_segment_include_opAnyAnystrategy_updated_onAnyAnystrategy_use_campaign_endAnyAnystrategy_use_campaign_startAnyAnystrategy_use_mm_freqAnyAnystrategy_use_optimizationAnyAnyMetricsclicksAnyAnyctcCTCAnyAnyctrCTRAnyAnygeneral_invalid_clicksAnyAnyimpressionsAnyAnypost_click_conversionsPost-Click ConversionsAnyAnypost_view_conversionsPost-View ConversionsAnyAnyrr_per_1k_impsResponse Rate/1K ImpsAnyAnytotal_clicksAnyAnytotal_conversionsAnyAnyuniquesAnyAny

  - `Pageable` ()
    Yes

  - `Time Windows` ()
    yesterday, last_7_days, last_14_days, last_30_days, last_60_days, last_90_days

  - `Rollups` ()
    all

## Security:

  - `Auth0` (unknown)
    oauth2 scopes: offline_access

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

  - `200` (unknown)
    JSON for Paginated, JSONL for Streaming

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

  - `400` (unknown)
    The request is not valid

## Response 400 fields (application/json):

  - `error_code` (string)

  - `message` (string)

  - `request_id` (string)

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `error_code` (string)

  - `message` (string)

  - `request_id` (string)

## Response 5XX:

  - `5XX` (unknown)
    An error occurred

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

  - `error_code` (string)

  - `message` (string)

  - `request_id` (string)