Children Age & Gender - PureSpectrum

Quotas on children are defined as a combination of age and gender. The main qualification code is 232 and the pre screener text is defined as My child age and gender is %%232%%.

Each possible qualification answer is defined like this:

"answers": [
    {
        "answer_id": "111",
        "local_text": "Boy up to 1 month old",
        "eng_text": "Boy up to 1 month old",
        "condition_code": 111
    },
    {
        "answer_id": "112",
        "local_text": "Girl up to 1 month old",
        "eng_text": "Girl up to 1 month old",
        "condition_code": 112
    },
    {
        "answer_id": "113",
        "local_text": "Boy 2 months old",
        "eng_text": "Boy 2 months old",
        "condition_code": 113
    },
    {
        "answer_id": "114",
        "local_text": "Girl 2 months old",
        "eng_text": "Girl 2 months old",
        "condition_code": 114
    }
    // And the list goes on while code 167 is the code for no under 17 years old children in the household.
    {
        "answer_id": "167",
        "local_text": "I have no children 17 or younger living in my household",
        "eng_text": "I have no children 17 or younger living in my household",
        "condition_code": 167
    },
]

When adding a children quota to a survey a new quota criteria property has been introduced child_age_unit unit which can be 311 for years and 312 for months.

Example 1: 1000 completes with children under 17 years old:

{
  "survey_title": "Children test survey",
  "survey_localization": "en_US",
  "completes_required": 1000,
  "expected_ir": 80,
  "expected_loi": 10,
  "live_url": "http://www.example.com/surveys",
  "test_url": "http://www.example.com/surveys-test",
  "field_time": 10,
  "qualifications": [
    {
      // This is the new qualification code.
      "qualification_code": 232,
      // This will select all boys and girls that are form 1 month old until 17 years old.
      "condition_codes": [
        "111", "112", "113", "114", "115", "116", "117", "118", "119", "120", "121", "122", "123", "124", "125", "126", "127", "128", "129", "130",
        "131", "132", "133", "134", "135", "136", "137", "138", "139", "140", "141", "142", "143", "144", "145", "146", "147", "148", "149", "150",
        "151", "152", "153", "154", "155", "156", "157", "158", "159", "160", "161", "162", "163", "164", "165", "166"
      ]
    }
  ],
  "quotas": [
    {
      "buyer_quota_id": "children_quota_id_1",
      "required_count": 400,
      "criteria": [
        {
          "qualification_code": 232,
          "child_age_unit": 311, // Years Unit
          "condition_codes": [
            "111", "112", "113", "114", "115", "116", "117", "118", "119", "120", "121", "122", "123", "124", "125", "126", "127", "128", "129", "130",
            "131", "132", "133", "134", "135", "136", "137", "138", "139", "140", "141", "142", "143", "144", "145", "146", "147", "148", "149", "150",
            "151", "152", "153", "154", "155", "156", "157", "158", "159", "160", "161", "162", "163", "164", "165", "166"
          ]
        }
      ]
    }
  ]
}

Example 2: 400 completes with children under 17 + 600 without children

{
  "survey_title": "Automobile Preferences",
  "survey_category_code": 231,
  "survey_localization": "en_US",
  "completes_required": 1000,
  "expected_ir": 80,
  "expected_loi": 10,
  "live_url": "http://www.mybuyer.com/surveys_134",
  "test_url": "http://www.mybuyer.com/surveys_134t",
  "field_time": 10,
  "qualifications": [
    {
      "qualification_code": 232,
      "condition_codes": [
        "111", "112", "113", "114", "115", "116", "117", "118", "119", "120",
        "121", "122", "123", "124", "125", "126", "127", "128", "129", "130",
        "131", "132", "133", "134", "135", "136", "137", "138", "139", "140",
        "141", "142", "143", "144", "145", "146", "147", "148", "149", "150",
        "151", "152", "153", "154", "155", "156", "157", "158", "159", "160",
        "161", "162", "163", "164", "165", "166", "167"
      ]
    }
  ],
  "quotas": [
    {
      "buyer_quota_id": "b11111",
      "required_count": 400,
      "criteria": [
        {
          "qualification_code": 232,
          "child_age_unit": 311, //Years Unit
          "condition_codes": [
            "111", "112", "113", "114", "115", "116", "117", "118", "119", "120",
        	"121", "122", "123", "124", "125", "126", "127", "128", "129", "130",
        	"131", "132", "133", "134", "135", "136", "137", "138", "139", "140", 
			"141", "142", "143", "144", "145", "146", "147", "148", "149", "150",
			"151", "152", "153", "154", "155", "156", "157", "158", "159", "160",
			"161", "162", "163", "164", "165", "166"
          ]
        }
      ]
    },
    {
      "buyer_quota_id": "b11112",
      "required_count": 600,
      "criteria": [
        {
          "qualification_code": 232,
          "condition_codes": ["167"]
        }
      ]
    }
  ]
}

Example 3: 1000 completes with children aged 4-12

{
  "qualifications": [
    {
      "qualification_code": 232,
      "condition_codes": ["139", "140", "141", "142", "143", "144", "145", "146", "147", "148", "149", "150", "151", "152", "153", "154", "155", "156"]
    }
  ],
  "quotas": [
    {
      "buyer_quota_id": "b11111",
      "required_count": 1000,
      "criteria": [
        {
          "qualification_code": 232,
          "child_age_unit": 311, //Years Unit
          "condition_codes": ["139", "140", "141", "142", "143", "144", "145", "146", "147", "148", "149", "150", "151", "152", "153", "154", "155", "156"]
        }
      ]
    }
  ]
}

Example 4: 1000 completes with boys aged 1-17

{
  "qualifications": [
    {
      "qualification_code": 232,
      "condition_codes": ["133", "135", "137", "139", "141", "143", "145", "147", "149", "151", "153", "155", "157", "159", "161", "163", "165"]
    }
  ],
  "quotas": [
    {
      "buyer_quota_id": "b11111",
      "required_count": 1000,
      "criteria": [
        {
          "qualification_code": 232,
          "child_age_unit": 311, //Years Unit
          "condition_codes": ["133", "135", "137", "139", "141", "143", "145", "147", "149", "151", "153", "155", "157", "159", "161", "163", "165"]
        }
      ]
    }
  ]
}

Example 5: 1000 completes with children aged 1-17 years old: 400 boys 600 girls

{
  "qualifications": [
    {
      "qualification_code": 232,
      "condition_codes": ["133", "134", "135", "136", "137", "138", "139", "140", "141", "142", "143", "144", "145", "146", "147", "148", "149", "150", "151", "152", "153", "154", "155", "156", "157", "158", "159", "160", "161", "162", "163", "164", "165", "166"]
    }
  ],
  "quotas": [
    {
      "buyer_quota_id": "b11111",
      "required_count": 400,
      "criteria": [
        {
          "qualification_code": 232,
          "child_age_unit": 311, //Years Unit
          "condition_codes": ["133", "135", "137", "139", "141", "143", "145", "147", "149", "151", "153", "155", "157", "159", "161", "163", "165"] //Boys from 1 to 17
        }
      ]
    },
    {
      "buyer_quota_id": "b11112",
      "required_count": 600,
      "criteria": [
        {
          "qualification_code": 232,
          "child_age_unit": 311, //Years Unit
          "condition_codes": ["134", "136", "138", "140", "142", "144", "146", "148", "150", "152", "154", "156", "158", "160", "162", "164", "166"] //Girl from 1 to 17
        }
      ]
    }
  ]
}

Example 6: 1000 completes with children: 200 boys aged 1-3 + 300 boys aged 4-9 + 500 girls aged 4-9

{
  "qualifications": [
    {
      "qualification_code": 232,
      "child_age_unit": 311, //Years Unit
      "condition_codes": ["133", "135", "137", "139", "140", "141", "142", "143", "144", "145", "146", "147", "148", "149", "150"]
    }
  ],
  "quotas": [
    {
      "buyer_quota_id": "b11111",
      "required_count": 200,
      "criteria": [
        {
          "qualification_code": 232,
          "child_age_unit": 311, //Years Unit
          "condition_codes": ["133", "135", "137"],
        }
      ]
    },
    {
      "buyer_quota_id": "b11112",
      "required_count": 300,
      "criteria": [
        {
          "qualification_code": 232,
          "child_age_unit": 311, //Years Unit
          "condition_codes": ["139", "141", "143", "145", "147", "149"]
        }
      ]
    },
    {
      "buyer_quota_id": "b11113",
      "required_count": 500,
      "criteria": [
        {
          "qualification_code": 232,
          "child_age_unit": 311, //Years Unit
          "condition_codes": ["140", "142", "144", "146", "148", "150"]
        }
      ]
    }
  ]
}

Example 7: 600 completes without children + 400 with boys aged 4-9 (300 boys aged 4-6 + 100 boys aged 7-9)

{
  "qualifications": [
    {
      "qualification_code": 232,
      "condition_codes": ["133", "134", "135", "136", "137", "138", "139", "140", "141", "142", "143", "144", "145", "146", "147", "148", "149", "150", "151", "152", "153", "154", "155", "156", "157", "158", "159", "160", "161", "162", "163", "164", "165", "166", "167"]
    }
  ],
  "quotas": [
    {
      "buyer_quota_id": "b11112",
      "required_count": 600,
      "criteria": [
        {"qualification_code": 232, 
        "condition_codes": ["167"]} //Don't have children
      ]
    },
    {
      "buyer_quota_id": "b11113",
      "required_count": 300,
      "criteria": [
        {
          "qualification_code": 232,
          "child_age_unit": 311, //Years Unit
          "condition_codes": ["139", "141", "143"] //4 to 6
        }
      ]
    },
    {
      "buyer_quota_id": "b11114",
      "required_count": 100,
      "criteria": [
        {
          "qualification_code": 232,
          "child_age_unit": 311, //Years Unit
          "condition_codes": ["145", "147", "149"] //7 to 9
        }
      ]
    }
  ]
}