Before we begin with the integration setup, there is two key points that are very important:
The respondent id must at all times be sent to us as
respondentid=meaning the client does not send the respondent id as&r= or &rsp= or &rid=The Redirect url must always be 100% URL encoded i.e. ("=" equal sign must also be encoded). Also the &link= must be the last variable in the URL link.
With all this in mind lets look at some examples of how a client builds a redirect link so that a respondent is sent back to the host survey after they have completed the exercise on the CS platform.
...
We use the URL that CS provides for the exercise.
https://survey.rose.conceptsauce.io/?projectid=e29b560d-7eaa-4e3d-605e-029c491e1541&startpage=93389377-2e90-4c44-7f1c-98bdaa650b93param_id=PRMS01H5HK56RFG4WTQ3TVYWSWV02G
Then we add on the &respondentid= with the dynamic respondent id after the equal sign. The link above will look like this once the respondent id has been parsed:
https://survey.rose.conceptsauce.io/?projectid=e29b560d-7eaa-4e3d-605e-029c491e1541&startpage=93389377-2e90-4c44-7f1c-98bdaa650b93param_id=PRMS01H5HK56RFG4WTQ3TVYWSWV02G&respondentid=DEMOrespondent
...
Using a simple online service to Encode/Decode the URL you can easily turn:
https://www.google.com/?pid=S1800&id=clientEN-US1&DoNotRedir1=0
To a 100% URL encoded version that will look like so:
https%3A%2F%2Fwww.google.com%2F%3Fpid%3DS1800%26id%3DclientEN-US1%26DoNotRedir1%3D0
| Info |
|---|
Be aware of using Ampersand [&] in the URL text, as this can break the link. For instance when trying to use a brand name that has & in it, i.e. M&M. Then the Ampersand needs to be double encoded. i.e. M&M will therefore be shown as M%2526M and not single encoding M%26M |
It does look like a mess, but its URL encoding and this is the correct version to pass to us so we can process the request correctly. In the above example we are redirecting back to www.google.com. This however can be your host survey system. confirm-it, Quest.
...
| Code Block |
|---|
https://survey.rose.conceptsauce.io/?projectid=e29b560d-7eaa-4e3d-605e-029c491e1541&startpage=93389377-2e90-4c44-7f1c-98bdaa650b93param_id=PRMS01H5HK56RFG4WTQ3TVYWSWV02G&respondentid=DEMOrespondent&link=https%3A%2F%2Fwww.google.com%2F%3Fpid%3DS1800%26id%3DclientEN-US1%26DoNotRedir1%3D0 |
...