Multi-Country Surveys - PureSpectrum

Multi-Country survey allows to replicate the multi-country feature available via UI.

For more information about Multi-Country survey, visit this page: Helpjuice Multi-Country Survey

In order to create a multi-country survey you can use the Create survey endpoint.

Using the mc_unique_id request parameter the API will allow to connect multiple survey with that unique ID. This will transform a single project to a multi- country project.

Restrictions & Considerations

Make sure the Multi-Country feature is active on your buyer account.

2 surveys with the same localization cannot be added. E.g. (for localization we define the combination between Language and Country (en_US).

Once the Multi-Country survey is launched, the ID cannot be used again.

Create the first multi country survey localized in "en_US" with the mc_unique_id set to test-mc-12345 as an example:

{
  "survey_title": "Test multi country 1",
  "survey_category_code": 231,
  "survey_localization": "en_US",
  "completes_required": 300,
  "offer_price": 3.25,
  "expected_ir": 60,
  "expected_loi": 10,
  "live_url": "https://my.survey.com?survey_id=1234",
  "test_url": "https://my.survey.com?survey_id=1234&amp;test=1",
  "field_time": 10,
  "mc_unique_id": "test-mc-12345"
 }

Create another multi country survey localized in "es_US" (different localization) with the same mc_unique_id as above.

{
  "survey_title": "Test multi country 2",
  "survey_category_code": 231,
  "survey_localization": "es_US",
  "completes_required": 300,
  "offer_price": 3.25,
  "expected_ir": 60,
  "expected_loi": 10,
  "live_url": "https://my.survey.com?survey_id=1234",
  "test_url": "https://my.survey.com?survey_id=1234&amp;test=1",
  "field_time": 10,
  "mc_unique_id": "test-mc-12345"
 }

Create another multi countru survey localized in "en_CA" (different localization) with the same mc_unique_id used in the step above.

{
 "survey_title": "Test multi country 3",
 "survey_category_code": 231,
 "survey_localization": "en_CA",
 "completes_required": 300,
 "offer_price": 3.25,
 "expected_ir": 60,
 "expected_loi": 10,
 "live_url": "https://my.survey.com?survey_id=1234",
 "test_url": "https://my.survey.com?survey_id=1234&amp;test=1",
 "field_time": 10,
 "mc_unique_id": "test-mc-12345"
}

Create further surveys, if needed, following the same steps as above.

Launch all surveys individually using the Update survey status endpoint.

For more information on this exclusions, access the Multi Country & Multi Language page.