Set Dynamics Responses

This dataset contains the observer reach and frequency of each request.

Set Dynamics returns detailed reach and frequency results for each scenario, providing comprehensive metrics for campaign planning and analysis. Results are delivered as JSON objects containing scenario metadata and performance metrics.

Response Structure

Each response contains scenario identification, panel statistics, and reach metrics across multiple frequency thresholds and duration periods.

{
  "scenario_id": "4db7092ff5df9ff7c9b2e431b1d18616",
  "created_timestamp": "2024-10-26T14:30:00-05:00",
  "customer_scenario_name": "National Billboard Campaign Analysis",
  "customer_scenario_info": "Q2 2024 reach analysis for premium billboard inventory",
  "type": "lts_freq_per_period",
  "days": 14,
  "market_ids": "US2020XDMA524",
  "segment_id": "2035-9330",
  "reach_metrics": {
    "eff_freq_1_reach": 23.45,
    "eff_freq_2_reach": 20.21,
    "eff_freq_3_reach": 17.35,
    "eff_freq_4_reach": 15.56,
    "eff_freq_5_reach": 10.90,
    "eff_freq_10_reach": 2.18,
    "eff_freq_20_reach": 0.21,
    "eff_freq_50_reach": 0.03,
    "eff_freq_100_reach": 0.00
  },
  "summary_metrics": {
    "total_reach_pct": 23.45,
    "average_frequency": 2.89,
    "trp": 67.42,
    "total_impressions": 33240384
  }
}

Field Definitions

Scenario Identification

Field	Type	Description	Example
`scenario_id`	String	Unique identifier for the scenario analysis	`4db7092ff5df9ff7c9b2e431b1d18616`
`created_timestamp`	String	ISO 8601 timestamp of scenario creation	`2024-10-26T14:30:00-05:00`
`customer_scenario_name`	String	User-provided scenario name	`National Billboard Campaign Analysis`
`customer_scenario_info`	String	User-provided scenario description	`Q2 2024 reach analysis for premium billboard inventory`

Analysis Parameters

Field	Type	Description	Example
`type`	String	Exposure measurement type used	`lts_freq_per_period`
`days`	Integer	Analysis duration in days	`14`
`market_ids`	String	Geographic market identifier(s)	`US2020XDMA524`
`segment_id`	String	Target segment identifier (format: segment-base)	`2035-9330`

Reach Metrics

Reach metrics show the percentage of the target population reached at various effective frequency thresholds.

Field	Type	Description
`eff_freq_1_reach`	Float	Percentage reached at least 1 time
`eff_freq_2_reach`	Float	Percentage reached at least 2 times
`eff_freq_3_reach`	Float	Percentage reached at least 3 times
`eff_freq_4_reach`	Float	Percentage reached at least 4 times
`eff_freq_5_reach`	Float	Percentage reached at least 5 times
`eff_freq_6_reach`	Float	Percentage reached at least 6 times
`eff_freq_7_reach`	Float	Percentage reached at least 7 times
`eff_freq_8_reach`	Float	Percentage reached at least 8 times
`eff_freq_9_reach`	Float	Percentage reached at least 9 times
`eff_freq_10_reach`	Float	Percentage reached at least 10 times
`eff_freq_11_reach`	Float	Percentage reached at least 11 times
`eff_freq_20_reach`	Float	Percentage reached at least 20 times
`eff_freq_50_reach`	Float	Percentage reached at least 50 times
`eff_freq_100_reach`	Float	Percentage reached at least 100 times

Summary Metrics

Field	Type	Description	Example
`total_reach_pct`	Float	Overall percentage of population reached (1+ frequency)	`23.45`
`average_frequency`	Float	Average exposures per person reached	`2.89`
`trp`	Float	Target Rating Points (reach × frequency)	`67.42`
`total_impressions`	Integer	Total impression count across all exposures	`33240384`

Multiple Scenarios

When multiple measurement types or duration periods are requested, separate response objects are returned for each combination:

[
  {
    "scenario_id": "4db7092ff5df9ff7c9b2e431b1d18616",
    "type": "lts_freq_per_period",
    "days": 7,
    ...
  },
  {
    "scenario_id": "4db7092ff5df9ff7c9b2e431b1d18616", 
    "type": "lts_freq_per_period",
    "days": 14,
    ...
  },
  {
    "scenario_id": "4db7092ff5df9ff7c9b2e431b1d18616",
    "type": "ots_freq_per_period", 
    "days": 7,
    ...
  }
]

Data Interpretation

Reach Percentages: All reach values are percentages of the target population (e.g., 23.45 = 23.45% of target segment).

Frequency Thresholds: Higher frequency thresholds show subset populations (e.g., eff_freq_3_reach ≤ eff_freq_1_reach).

Updated 2 months ago