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

FieldTypeDescriptionExample
scenario_idStringUnique identifier for the scenario analysis4db7092ff5df9ff7c9b2e431b1d18616
created_timestampStringISO 8601 timestamp of scenario creation2024-10-26T14:30:00-05:00
customer_scenario_nameStringUser-provided scenario nameNational Billboard Campaign Analysis
customer_scenario_infoStringUser-provided scenario descriptionQ2 2024 reach analysis for premium billboard inventory

Analysis Parameters

FieldTypeDescriptionExample
typeStringExposure measurement type usedlts_freq_per_period
daysIntegerAnalysis duration in days14
market_idsStringGeographic market identifier(s)US2020XDMA524
segment_idStringTarget segment identifier (format: segment-base)2035-9330

Reach Metrics

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

FieldTypeDescription
eff_freq_1_reachFloatPercentage reached at least 1 time
eff_freq_2_reachFloatPercentage reached at least 2 times
eff_freq_3_reachFloatPercentage reached at least 3 times
eff_freq_4_reachFloatPercentage reached at least 4 times
eff_freq_5_reachFloatPercentage reached at least 5 times
eff_freq_6_reachFloatPercentage reached at least 6 times
eff_freq_7_reachFloatPercentage reached at least 7 times
eff_freq_8_reachFloatPercentage reached at least 8 times
eff_freq_9_reachFloatPercentage reached at least 9 times
eff_freq_10_reachFloatPercentage reached at least 10 times
eff_freq_11_reachFloatPercentage reached at least 11 times
eff_freq_20_reachFloatPercentage reached at least 20 times
eff_freq_50_reachFloatPercentage reached at least 50 times
eff_freq_100_reachFloatPercentage reached at least 100 times

Summary Metrics

FieldTypeDescriptionExample
total_reach_pctFloatOverall percentage of population reached (1+ frequency)23.45
average_frequencyFloatAverage exposures per person reached2.89
trpFloatTarget Rating Points (reach × frequency)67.42
total_impressionsIntegerTotal impression count across all exposures33240384

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_reacheff_freq_1_reach).