Targeting Parents by Child Age & Gender
- Aditya Takale (Unlicensed)
- Ian McCartney
- David Boyajian
New Child Age & Gender
We have recently updated our Child Age & Gender Qualification to a more standard single Qualification design.
Qualification ID 232 will be used in place of the previous model combining 218, 220 and 230.
Sample API Request
GET /suppliers/v2/surveys/:survey_id
Host: api.spectrumsurveys.com
access-token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Sample API Response
This is a snippet from there response of GET /suppliers/v2/surveys/:survey_id
Example 1: quota is looking for parents of 1 year old boy.
- {
"quota_id": "39fd202e-717a-4683-b7a7-3b0a225275e4",
"quantities": {
"currently_open": 50,
"remaining": 50,
"achieved": 0
},
"criteria": [{
"qualification_code": 232, //Child Age Gender qualification
"child_age_unit": 311, //Years Unit
"condition_codes": ["133"] //Boy Age 1
}]
}
Example 2: quota is looking for people who are *not* parents
- {
"quota_id": "39fd202e-717a-4683-b7a7-3b0a212124124",
"quantities": {
"currently_open": 50,
"remaining": 50,
"achieved": 0
},
"criteria": [{
"qualification_code": 232, //Child Age Gender qualification
"condition_codes": ["167"] //I have no children living in my household and I am not pregnant/expecting a child within the next 9 months
}]
}
Example 3: quota is looking for people who are parents of boy or girl 3 months - 11 months
- {
"quota_id": "2f87bf95-6bf8-4d14-88ab-38bbb408c872",
"quantities": {
"currently_open": 50,
"remaining": 50,
"achieved": 0
},
"criteria": [{
"qualification_code": 232, //Child Age Gender qualification
"child_age_unit": 312, //Months Unit
"condition_codes": [
"115", //Boy 3 months old"
"116", //Girl 3 months old
"117", //Boy 4 months old
"118", //Girl 4 months old
"119", //Boy 5 months old
"120", //Girl 5 months old
"121", //Boy 6 months old
"122", //Girl 6 months old
"123", //Boy 7 months old
"124", //Girl 7 months old
"125", //Boy 8 months old
"126", //Girl 8 months old
"127", //Boy 9 months old
"128", //Girl 9 months old
"129", //Boy 10 months old
"130", //Girl 10 months old
"131", //Boy 11 months old
"132", //Girl 11 months old
]
}]
}
Example 4: quota is looking for people who are parents of a boy with age between 3 months - 18 months
- {
"quota_id": "2f87bf95-6bf8-4d14-88ab-38bbb408c872",
"quantities": {
"currently_open": 50,
"remaining": 50,
"achieved": 0
},
"criteria": [{
"qualification_code": 232, //Child Age Gender qualification
"child_age_unit": 312, //Months Unit
"condition_codes": [
"115", //Boy 3 months old"
"117", //Boy 4 months old
"119", //Boy 5 months old
"121", //Boy 6 months old
"123", //Boy 7 months old
"125", //Boy 8 months old
"127", //Boy 9 months old
"129", //Boy 10 months old
"131", //Boy 11 months old
"133", //Boy Age 1
"168", // Boy 13 Months Old
"170", // Boy 14 Months Old
"172", // Boy 15 Months Old
"174", // Boy 16 Months Old
"176", // Boy 17 Months Old
"178", // Boy 18 Months Old
]
}]
}
Example 5: quota is looking for people who are parents of a boy with age between 1 year - 3 years
- {
"quota_id": "2f87bf95-6bf8-4d14-88ab-38bbb408c872",
"quantities": {
"currently_open": 50,
"remaining": 50,
"achieved": 0
},
"criteria": [{
"qualification_code": 232, //Child Age Gender qualification
"child_age_unit": 311, //Years Unit
"condition_codes": [
"133", //Boy Age 1
"168", // Boy 13 Months Old
"170", // Boy 14 Months Old
"172", // Boy 15 Months Old
"174", // Boy 16 Months Old
"176", // Boy 17 Months Old
"178", // Boy 18 Months Old
"180", // Boy 19 Months Old
"182", // Boy 20 Months Old
"184", // Boy 21 Months Old
"186", // Boy 22 Months Old
"188", // Boy 23 Months Old
"135", //Boy Age 2
"190", // Boy 25 Months Old
"192", // Boy 26 Months Old
"194", // Boy 27 Months Old
"196", // Boy 28 Months Old
"198", // Boy 29 Months Old
"200", // Boy 30 Months Old
"202", // Boy 31 Months Old
"204", // Boy 32 Months Old
"206", // Boy 33 Months Old
"208", // Boy 34 Months Old
"210", // Boy 35 Months Old
"137", //Boy Age 3
]
}]
}Child Age & Gender (Qual 232) will be presented as a range filling in all the Year and Month Conditions in the requested targeting.
Legacy Child Age & Gender
Get Surveys - GET /surveys - http://api.spectrumsurveys.com/suppliers/v2/surveys/:survey_idCall this API to view the quota for the survey. You can check out the Criteria section and look for the qualification and condition codes.
This is an example of how targeting for parents, or parents of specific age/gender of children will appear. Any one of the parent's children may qualify the respondent to take this survey.
Targeting for age and gender of child { "qualification_code" : 220 & 230 } will only appear in the criteria for the quota. It will not appear in the qualifications array. This is because that the survey may target for the people who have children as well as for people who don't have children in the same survey.
If a survey is targeting for parents of a specific age and gender of a child , then a qualifications array will always contain qualification_code : 218 and condition_code:112. The Age and gender of the child will appear as a nested quota for qualification_code : 218, 220 and 230.
Please see examples below
HEADER Parameters
Parameter | Type | Required | Description |
|---|---|---|---|
access-token | string | Yes | Token used to identify the authenticity of the user. |
Response Parameters
Parameter | Type | Description |
|---|---|---|
quota_id | integer | Quota ID |
Criteria | Object | Contains Qualification codes and their corresponding condition codes |
qualification_code | integer | 218 - parent/not parent 220 - gender of child 230 - age of child |
condition_codes | array of strings | Contains the applicable answer choices for either 218 (has/doesn't have children) or 220 (gender of the child) |
range_sets | array of objects | Contains range sets for the age of the child, nested within the criteria of a quota. |
crtd_on | UTC Timestamp in milliseconds since Unix Epoch | Timestamp of when this quota id was created (milliseconds since Unix Epoch) |
mod_on | UTC Timestamp in milliseconds since Unix Epoch | Timestamp of when this quota id was last modified. This would only change if the quota is locked/unlocked, or the quantity is changed. If a quota's criteria are modified, this quota is closed and a new one is created. (milliseconds since Unix Epoch) |
Range Sets - Object Parameters
Parameter | Type | Description |
|---|---|---|
from | integer | Quota ID |
to | integer | Contains Qualification codes and their corresponding condition codes |
units | integer | 311 - Years 312 - Months |
Sample API Request
Sample API Response
This is a snippet from there response of GET /suppliers/v2/surveys/:survey_id