Survey Exclusion Group

In order to not allow respondents who participated in a previous survey to access a new survey, you can create a survey group and then apply that group to the new survey.

Create a survey group

Use the Create exclusion group endpoint to create a survey group.

Second Step

Once a survey group has been created, it can be added to a survey either at survey creation time using the Create survey endpoint or after using the Update survey or Update survey attributes / properties endpoints.

The payload for the above endpoints needs to contain a new key buyer_surveygroup_ref and its value is the created survey group ID.

Example:

{
  "survey_title": "Sample Survey with survey groups",
  "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&test=1",
  "field_time": 10,
  "buyer_surveygroup_ref": "cosmetics_project_123"
}

The available endpoints for survey grouping can be found here: Survey group exclusions

You can't group a survey that had been created with incl_excl=1 (a recontact survey).

Apply multiple survey groups to a survey

To apply multiple survey groups to a single survey buyer_surveygroup_refs can be used to pass an array of survey groups IDs.

Example:

{
  "survey_title": "Sample Survey with survey groups",
  "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&test=1",
  "field_time": 10,
  
  "buyer_surveygroup_refs": ["cosmetics_project_123", "cosmetics_project_1234"]
}

Remove one or more exclusion groups from survey

To remove one or more exclusion groups from a survey, follow the same steps as above and keep the values for buyer_surveygroup_ref and buyer_surveygroup_refs empty.

{
  "buyer_surveygroup_ref": "",
  "buyer_surveygroup_refs": []
}

For more information on exclusions, access the Advanced Filters - Exclusion & Feasibility page.

Apply multiple survey groups to a survey#

Remove one or more exclusion groups from survey#

Apply multiple survey groups to a survey

Remove one or more exclusion groups from survey