How to implement a control blended profile in a draft target group
This guide explains how to define and add a control blended profile to a draft target group. A control blended profile allows you to select specific conditions from two or more existing profiles and group them under a single blended profile, with per-target quotas.
Unlike the interlock type, which automatically expands all possible combinations, the control type is manually constructed to target only the specific segments you need to cap or monitor.
Requirements
- Pre-existing Profiles: Each
controlblended target must reference conditions from at least two distinct standalone profiles in the target group. - Condition Matching: Every condition used in a blended profile with
controlblended type must already exist as a condition in a standalone profile within that target group.
Steps to implement a blended profile with control blended type in a draft target group
Step 1: Define your standalone profiles
Before adding the blended object, you must first define the regular profiles that will supply the conditions.
For example, you must first define separate regular profiles for Age (question ID 42), State (question ID 96), and Gender (question ID 43).
Step 2: Manually construct the blended profile with blended_type: "control"
Create a profile object with the type object: "blended" and blended_type: "control". This object should contain specific targets representing the combinations you want to control.
Example payload for a draft target group:
{
"profiles": [
{
"object": "regular",
"quotas_enabled": true,
"targets": [
{
"conditions": [
{
"object": "selection",
"question_id": 43,
"option": "1"
}
],
"quota": {
"completes_goal_percentage": 45,
"completes_goal": 0
}
},
{
"conditions": [
{
"object": "selection",
"question_id": 43,
"option": "2"
}
],
"quota": {
"completes_goal_percentage": 55,
"completes_goal": 0
}
}
]
},
{
"object": "regular",
"quotas_enabled": false,
"targets": [
{
"conditions": [
{
"object": "range",
"question_id": 42,
"min": 20,
"max": 29
}
]
},
{
"conditions": [
{
"object": "range",
"question_id": 42,
"min": 30,
"max": 39
}
]
}
]
},
{
"object": "regular",
"quotas_enabled": true,
"targets": [
{
"conditions": [
{
"object": "selection",
"question_id": 96,
"option": "1"
}
],
"quota": {
"completes_goal_percentage": 13.3,
"completes_goal": 0
}
}
]
},
{
"object": "blended",
"name": "Control quota",
"quotas_enabled": true,
"blended_type": "control",
"targets": [
{
"name": "Control quota 1",
"conditions": [
{
"object": "selection",
"question_id": 43,
"option": "1"
},
{
"object": "range",
"question_id": 42,
"min": 20,
"max": 29
},
{
"object": "selection",
"question_id": 96,
"option": "1"
}
],
"quota": {
"completes_goal_percentage": 0.0,
"completes_goal": 0
}
},
{
"name": "Control quota 2",
"conditions": [
{
"object": "selection",
"question_id": 43,
"option": "2"
},
{
"object": "range",
"question_id": 42,
"min": 30,
"max": 39
},
{
"object": "selection",
"question_id": 96,
"option": "1"
}
],
"quota": {
"completes_goal_percentage": 10.0,
"completes_goal": 0
}
},
{
"name": "Control quota 3",
"conditions": [
{
"object": "selection",
"question_id": 43,
"option": "1"
},
{
"object": "range",
"question_id": 42,
"min": 30,
"max": 39
},
{
"object": "selection",
"question_id": 96,
"option": "1"
}
],
"quota": {
"completes_goal_percentage": 0.0,
"completes_goal": 0
}
}
]
}
]
}
A completes_goal_percentage of 0.0 means the segment is paused — no completes will be collected for that target. This is useful for blocking specific demographic combinations from entering the survey.
Step 3: Validate and save
Submit the request to the Create target group endpoint. The system will validate that:
- The blended goal does not exceed the target group's total completes goal.
- All specified conditions exist in the regular profiles provided in the same request.
- A maximum of one
controlblended type blended profile with up to five targets is allowed per target group. - A
controlblended profile cannot use questions that are already part of aninterlockblended profile in the same target group.
Lifecycle and management
- Deleting a
controlblended profile will not delete the standalone profile conditions it references. - If a standalone profile condition referenced by a
controlblended profile is deleted, the corresponding target within the blended profile will also be deleted. - If all profile targets within a
controlblended profile are deleted, the blended profile object as a whole will be deleted as well.
Example: Cascade deletion when a standalone profile condition is removed
Using the example from Step 2, if you remove the Age range 20 to 29 target from the Age profile, the system will also delete Control quota 1 (which references that condition). The resulting target group will look like this:
Resulting payload:
{
"profiles": [
{
"object": "regular",
"quotas_enabled": true,
"targets": [
{
"conditions": [
{
"object": "selection",
"question_id": 43,
"option": "1"
}
],
"quota": {
"completes_goal_percentage": 45,
"completes_goal": 0
}
},
{
"conditions": [
{
"object": "selection",
"question_id": 43,
"option": "2"
}
],
"quota": {
"completes_goal_percentage": 55,
"completes_goal": 0
}
}
]
},
{
"object": "regular",
"quotas_enabled": false,
"targets": [
{
"conditions": [
{
"object": "range",
"question_id": 42,
"min": 30,
"max": 39
}
]
}
]
},
{
"object": "regular",
"quotas_enabled": true,
"targets": [
{
"conditions": [
{
"object": "selection",
"question_id": 96,
"option": "1"
}
],
"quota": {
"completes_goal_percentage": 13.3,
"completes_goal": 0
}
}
]
},
{
"object": "blended",
"name": "Control quota",
"quotas_enabled": true,
"blended_type": "control",
"targets": [
{
"name": "Control quota 2",
"conditions": [
{
"object": "selection",
"question_id": 43,
"option": "2"
},
{
"object": "range",
"question_id": 42,
"min": 30,
"max": 39
},
{
"object": "selection",
"question_id": 96,
"option": "1"
}
],
"quota": {
"completes_goal_percentage": 10.0,
"completes_goal": 0
}
},
{
"name": "Control quota 3",
"conditions": [
{
"object": "selection",
"question_id": 43,
"option": "1"
},
{
"object": "range",
"question_id": 42,
"min": 30,
"max": 39
},
{
"object": "selection",
"question_id": 96,
"option": "1"
}
],
"quota": {
"completes_goal_percentage": 0.0,
"completes_goal": 0
}
}
]
}
]
}
Control quota 1 was deleted because the Age condition (20 to 29) it references was removed. Control quota 2 and Control quota 3 remain because they only reference the 30 to 39 Age condition, which is still present.