B2B vs B2C
POST: /v1/projectsRequired fields for B2B vs B2C projects
Please see Targeting audiences effectively for a full list of optional and required fields for B2B and B2C projects.Remote vs in person
POST: /v1/projectsRemote
Whenremote is selected for typeOfResearch a project will recruit participants world wide by default. targetCountries can be added to optionally target one or more countries
- If a country is targeted, one or more cities can also be targeted in that country via
targetCities. - Participants will be recruited within 250km (155 miles) for remote projects selecting a city.
State targeting
To recruit only from specific US states, addtargetRegions with ISO 3166-2 codes such as US-CA or US-NY. All 50 states and US-DC are supported. Only participants whose profile location is in one of the listed states are invited, counted in the audience estimate, shown the project, and able to apply.
- Each region must belong to a country in
targetCountries. A region outside them, or any region on a worldwide project, returns a400error:Regions must belong to one of the project's countries: <regions>. - A region narrows only its own country. With
targetCountries: ["US", "AU"]andtargetRegions: ["US-CA"], the project recruits participants in California and anywhere in Australia. - When you also set
targetCities, a participant qualifies if they are within 250km of a targeted city or in a targeted state. - State targeting applies to remote projects only. Respondent clears
targetRegionswhen a project is in person. - If an update to
targetCountriesremoves a country, Respondent drops that country’s regions from the project. - To clear state targeting, send
targetRegions: []when you update a draft project.
Methodologies
When running remote projects the followingtargetResearchMethodology are valid.
- One on One
- Focus Group
- Unmoderated Study
- Survey
- Diary Study
In person
Wheninperson is selected for typeOfResearch a project must supply targetCountry and targetLocationRespondentInPerson fields.
- Participants will be recruited within 100km (62 miles) for in person projects.
Methodologies
When running in person projects the followingtargetResearchMethodology are valid.
- One on One
- Focus Group
- In Respondent Home
- In Respondent Office
Moderated vs unmoderated methodologies
POST: /v1/projectsModerated
Methodologies that are considered moderated must use thebookingUrl field in the externalResearcher object to pass back a URL where the participant can book a meeting time with the researcher.
- oneOnOne
- focusGroup
- inRespondentHome
- inRespondentOffice
- diaryStudy
Unmoderated
Methodologies that are considered unmoderated must use aunmoderatedStudyOrSurvey object to pass through a URL (remoteCommunicationDetails) and instructions (specialInstructions) for participants.
- survey
- unmoderatedStudy
remoteCommunicationDetails
URLs that are placed in this field will be appended with URL parameters on redirect to allow partners to collect participant, project, and screener response information. These fields can help confirm which participant relates to a particular survey response. Please see the URL Parameters guide for more information.completionUrl
Available for projects wheretargetResearchMethodology is unmoderatedStudy or survey. The completionUrl is the link a researcher redirects participants to at the end of the survey or task in order for Respondent to record task completion.
- When a participant accesses the
completionUrl, the screener response’stask.completedAttimestamp is set automatically. - Task completion does not trigger payout at that moment. Use Mark as Attended to mark the participant as complete and kick off the incentive payout, or Mark as Rejected if the response did not meet quality criteria.
- It does, however, start a 24-hour clock: if you take no action, Respondent marks the response
ATTENDEDautomatically and autopay fires. Reject inside that window if you want to withhold the incentive — see your review window. - The
completionUrlis appended with the same identifying URL parameters asremoteCommunicationDetails— see the URL Parameters guide for the full list and examples.