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 customer information, cohort details, and reach metrics across multiple frequency thresholds and duration periods.

{
  "customer": {
    "customer_id": 30,
    "customer_name": "Motionworks",
    "customer_scenario_id": "686d59e67e25e60012b986cb",
    "customer_scenario_name": "Albany NY panels",
    "customer_scenario_info": "{\"customer_name\":\"test_name\",\"customer_email\":\"[email protected]\"}"
  },
  "cohort": {
    "customer_segment_id": 2035,
    "customer_base_segment_id": 9330,
    "geography_ids": ["US2020XDMA532"]
  },
  "effective_reach_per_duration": [
    {
      "duration": "28",
      "effective_freq_list": [
        {"effective_freq": "1", "lts_reach": 0.38148},
        {"effective_freq": "2", "lts_reach": 0.30715},
        {"effective_freq": "3", "lts_reach": 0.25684},
        {"effective_freq": "4", "lts_reach": 0.22148},
        {"effective_freq": "5", "lts_reach": 0.19922},
        {"effective_freq": "6", "lts_reach": 0.1845},
        {"effective_freq": "7", "lts_reach": 0.16959},
        {"effective_freq": "8", "lts_reach": 0.15534},
        {"effective_freq": "9", "lts_reach": 0.14473},
        {"effective_freq": "10", "lts_reach": 0.13538},
        {"effective_freq": "11", "lts_reach": 0.12776},
        {"effective_freq": "20", "lts_reach": 0.07511},
        {"effective_freq": "50", "lts_reach": 0.02026},
        {"effective_freq": "100", "lts_reach": 0.00074}
      ]
    }
  ],
  "messages": "Success"
}

Schema

Name	Description	Type	Example
customer. customer_id	Motionworks customer identification number (echoed from request)	integer	30
customer. customer_name	Customer organization name (echoed from request)	string	Motionworks
customer. customer_scenario_id	Unique identifier for the scenario (echoed from request)	string	686d59e67e25e60012b986cb
customer. customer_scenario_name	Human-readable scenario name (echoed from request)	string	Albany NY panels
customer. customer_scenario_info	Additional scenario information, often containing customer contact details as JSON string (echoed from request)	string	{"customer_name":"test_name","customer_email":"[email protected]"}
cohort. customer_segment_id	Consumer demographic segment used for analysis (echoed from request)	integer	2035
cohort. customer_base_segment_id	Base age segment used for analysis (echoed from request)	integer	9330
cohort. geography_ids	Array of geographic markets included in the analysis (echoed from request)	array of strings	["US2020XDMA532"]
effective_reach_per_duration	Array of reach and frequency results organized by analysis duration. Contains one object for each requested duration period	array of objects	[{"duration":"28","effective_freq_list":[...]}]
effective_reach_per_duration[]. duration	Analysis duration in days for this set of results	string	28
effective_reach_per_duration[]. effective_freq_list	Array of reach percentages for each effective frequency threshold	array of objects	[{"effective_freq":"1","lts_reach":0.38148}]
effective_reach_per_duration[]. effective_freq_list[]. effective_freq	Frequency threshold (minimum number of exposures)	string	1, 2, 10, 50, 100
effective_reach_per_duration[]. effective_freq_list[]. lts_reach	Percentage of target population reached at or above this frequency threshold. Values are decimal representations (e.g., 0.38148 = 38.148%)	float	0.38148
messages	Processing status message. "Success" for successful processing, error description for failures	string	Success

Multiple Durations

When multiple duration periods are requested, the effective_reach_per_duration array contains separate objects for each period:

{
  "customer": {...},
  "cohort": {...},
  "effective_reach_per_duration": [
    {
      "duration": "7",
      "effective_freq_list": [...]
    },
    {
      "duration": "14", 
      "effective_freq_list": [...]
    },
    {
      "duration": "28",
      "effective_freq_list": [...]
    }
  ],
  "messages": "Success"
}

Data Interpretation

Frequency Thresholds: Higher frequency thresholds represent subsets of the population. The reach value decreases as frequency requirements increase (e.g., effective_freq_1 ≥ effective_freq_10 ≥ effective_freq_50).

Effective Frequency: Each threshold shows the percentage of people who were exposed at least that many times during the analysis period.

Updated 16 days ago