Create Multi-Country surveys
Multi-Country survey allows to replicate the multi-country feature available via UI.
Â
This document explains how to create via API the Multi-Country survey via API and help the client to use any tool available in UI and API.
For more information about Multi-Country survey, visit this page: Helpjuice Multi-Country Survey
Context:
This API extends the create survey API and allow to connect multiple survey with an ID. This will transform a single project to a multi-country project.
Add this parameter, "mc_unique_id"
in /buyers/v2/surveys
in any survey that you want to make part of the Multi-country study. This will allow a UI user to manage the survey with the same UI experience
NOTE:
Make sure the Multi-Country feature is activate to your 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.
Request
API call:
GET <SERVER_BASE_URL>/buyers/v2/surveys
Parameters to add:
"mc_unique_id": "mc-id-1234"
Payload:
we can use the normal payload along with the
mc_unique_id
."mc_unique_id": "random-mc-id"
A validation is added so that multiple MC surveys cannot be added with the same localization.
Steps:
Create the first MC survey localized in "en_US" with the
mc_unique_id=test-mc-1234
Create another MC survey localized in "es_US" (different localization) with the same
mc_unique_id
used in step 1.Create another MC survey localized in "en_CA" (different localization) with the same
mc_unique_id
used in step 1 and 2.Create further surveys following step 2 and 3.
Launch all surveys individually using the status change API.