FEOT: Field Evenly Over Time via API
Overview
Buyers have use cases that require them to collect an even number of completes over a period of time,
to ensure representativeness of sample
have an even number of completes over a period of time
conduct dipstick research whereby some % of completes have to be repeated over time
FEOT takes the desired number of completes and divides them evenly over the defined number of weeks
, days
 and hours
. For example, if we want 1000 completes evenly spaced over 5 days: FEOT will allow a max of 200 completes per day for 5 days.
NOTE: In order to use this functionality, the feature should be activated in you account. If you need to activate, please contact your account manager.
This the error message in case the feature is not activated:
{"status":"Failure","msg":"This users dosen't have access to this feature"}
Â
Use FEOT BuyAPI
To enable FEOT on a survey via Buy API, you must pass in the following request body parameters in either the POST /surveys
or PUT /surveys/:surveyId
endpoints:
"is_feot_enabled": true,
"feot": {
"pacing": "hours",
"interval": 12,
"is_custom": true
}
Use the one of these values to change the pacing:
hours
days
weeks
(7 days from launch date)
with "is_custom": true
.
In case you use "is_custom": false
, the pacing used will be days
Important Considerations
The pacing cannot be bigger that
field_time
Make sure to create a script that check the
field_time
is bigger than thepacing
/interval
Request (POST)
POST $apihost/$basepath/surveys
Parameters:Â
Body:
{
"survey_title": "Test SURVEY FEOT",
"survey_category_code": 231,
"survey_localization": "en_US",
"completes_required": 1000,
"expected_ir": 60,
"expected_loi": 60,
"offer_price": 4.5,
"live_url": "https://my.survey.com?survey_id=1234",
"test_url": "https://my.survey.com?survey_id=1234",
"field_time": 10,
"is_feot_enabled": true,
"feot": {
"pacing": "hours",
"interval": 12,
"is_custom": true
},
"qualifications": [
{
"qualification_code": 211,
"condition_codes": [
"111",
"112"
]
},
{
"qualification_code": 212,
"range_sets": [
{
"from": 21,
"to": 59,
"units": 311
}
]
},
{
"qualification_code": 213,
"range_sets": [
{
"from": 50000,
"to": 100000,
"units": 321
}
]
}
]
} |
Result (POST)
Response Code
201
Response Body
Request (PUT)
POST $apihost/$basepath/surveys/#surveyid