Web Survey Links
Links location
With CCA and WebProd, you have many different kinds of links that you can use, with or without the capability to resume. These links are accessible from a few different places on the Supervisor side:
- The contextual menu on a selected survey:
- On survey properties > WebProd tab > on the contextual menu on a selected WebProd connection:
- On Find/edit contact (in case of DoPanel survey) > contextual menu on selected contact:
- On the Web connections window > contextual menu on selected WebProd:
StartSurvey link
This will start a survey without the resume capability.
Link:
http://servername/webprod/cgi-bin/AskiaExt.dll?Action=StartSurvey&SurveyName=AskiaSurvey
Parameters:
- SurveyName - The external name of the survey as defined in WebProd.
- FromQuestion (optional) - indicates the Shortcut of the question where you want to start the interview from (e.g. &FromQuestion=Q2).
- Test (optional) - If true, the survey will progress normally, but will be deleted on completion or after a timeout of one hour. The completed survey won't be sent to CCA.
Example link:http://servername/webprod/cgi-bin/AskiaExt.dll?Action=StartSurvey&SurveyName=AskiaSurvey&FromQuestion=Q2&Test=True
Shortcut in a mail template: [ccaStartSurveyLink]
DoPanel link
This will start a survey with a capability to resume, linked to a contact from your sample list. All imports from your sample list must be set as "Askia Panel" on the survey side, in the import settings for your questions.
Shortcut to add into your email template:
DoPanel: <a href="[ccaDoPanelLink]">[ccaDoPanelLink]</a>
This link will be automatically updated by the CCA to transform it into a unique DoPanel link for each respondent within the sample list. The DoPanel link should not be created manually.
Example:
http://servername/webprod/cgi-bin/AskiaExt.dll?Action=DoPanel&Survey=RYLZDLVLLBHLNJBL&PanelId=RYLZDLVLLBHLNJBL@FFFHPMPFHIGPKFBK
Parameters:
- Survey - The Askia-encoded CCA survey ID.
- PanelId - Askia-encoded panel ID. Format: ContactID@ListID. The Contact ID is the AskInterview field in the AskList table.
- Test (optional) - if true, the survey will progress normally, but will be deleted on completion or after a timeout of one hour. The completed survey won't be sent to CCA.
- FromStart (optional) - if 1, the survey starts from the beginning without erasing answers.
- FromQuestion (optional) - indicates the shortcut to where you want to start the interview from (e.g. &FromQuestion=Q2)
According to your IIS options, you can use "prettified" and encrypted links in your email template.
"Prettified" DoPanel link keyword:
<a href= "[ccaDoPanelPrettyLink]">[ccaDoPanelPrettyLink]</a><br><br>
How it's displayed on the respondent side:
http://myWebServer.com/WebProd/Start/00005RI3T802JPIC/00029DWMCYCJJL9L00021KH3SW1QQP7P
Encrypted DoPanel link keyword:
<a href= "[ccaDoPanelEncryptedLink]">[ccaDoPanelEncryptedLink]</a>
How it's displayed on the respondent side:
http://MyWebServer.com/WebProd/~EggxryiKSaqe6q52EEa-CQ
If necessary, you can get the DoPanel link for a specific contact (or a group of contacts) in Supervisor > Find/edit a contact on a DoPanel list > Select the contact > Web > Copy Panel Link. But there is a method that allows you to write back the DoPanel links into the sample list directly - you can find that here.
DoExternalPanel link
This will start a survey with the capability to resume.
Link:
http://servername/webprod/cgi-bin/AskiaExt.dll?Action=DoExternalPanel&SurveyName=AskiaSurvey&Broker=SomeBroker&BrokerPanelId=RandomPanelId
Parameters:
- SurveyName - The external name of the survey as defined in the WebProd.
- Broker - Alphanumerical characters to identify the email broker/external provider.
- BrokerPanelId - Alphanumerical characters (generated by the email broker/external provider) to individually identify the panel members.
- Test (optional) - if true, the survey will progress normally, but will be deleted on completion or after a timeout of one hour. The completed survey won't be sent to CCA.
- FromStart (optional) - if 1, starts from the beginning without erasing answers.
- FromQuestion (optional) - indicates the shortcut where you want to start the interview from (e.g. &FromQuestion=Q2).
http://MyWebserver/WebProd/cgi-bin/askiaext.dll?Action=DoExternalPanel&SurveyName=MySurvey&Broker=Askia&BrokerPanelId=thx1138&FromQuestion=Q2
Please note that it is the combination of the two parameters Broker and BrokerPanelId that set the survey link as unique.
According to your IIS options, you can use "prettified" links for DoExternalPanel links:
http://askia.com/WebProd/Start/MySurvey/Broker/BrokerPanelId
Unsubscribe link
We have added an unsubscription feature in 5.5.2. Here are the keywords you can add to your email template:
[ccaUnsubscribeLink] = unsubscribe link for a contact. Once added into your email template, it will be converted to this:
http://MyWebServer.com/WebProd/cgi-bin/askiaext.dll?Action=Unsubscribe&PanelId=00029DWMCYCJJL9L@00021KH3SW1QQP7P
[ccaUnsubscribeEncryptedLink] = encrypted unsubscribe link for a contact. Once added into your email template, it will be converted to this:
http://MyWebServer.com/WebProd/~IXGRzsJqAoM
Keywords
Here is a summary of all the keywords that can be used in a mail template:
[ccaStartSurveyLink] = Start the survey link without a resume capability.
[ccaDoPanelLink] = Survey link with a resume capability.
[ccaDoPanelPrettyLink] = Prettified survey link with a resume capability.
[ccaDoPanelEncryptedLink] = Prettified survey link with a resume capability.
[ccaUnsubscribeLink] = Unsubscribe link for a contact.
[ccaUnsubscribeEncryptedLink] = Encrypted unsubscribe link for a contact.
[ccaWebProdUrl] = Root URL of WebProd.
[ccaAskiaExtUrl] = URL to askiaext.dll.
[ccaSurveyExternalName] = Survey name.