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 about 12 hours ago