If a respondent asks to not be contacted anymore, whatever the data collection mode, his/her personal data, such as their phone number or email address must be added into a Do Not Contact list (DNC). Before any contact list usage, you need to ensure that you are not using any contact matched with your Do Not Contact list. The Do Not Contact lists are available for each data collection mode or a mix of them.

To implement the ability for a respondent to unsubscribe to a DoPanel sent by CCA, you will need:

• A list for unsubscribed contacts
• An unsubscription HTML page
• New keywords to add in your email template.
• An event on your list

You need to set your Unsubscription options in the Ribbon > Extra > Mailing. Two new fields are set:

• Select the DNC list you want to use to store the unsubscribed contacts.
• Select the path to the unsubscription page template. 

Please note that these options can be overridden on the sample list properties side.

List for unsubscribed contacts

This is a standard Do Not Contact list that must contain an email field. You need to attach it to your sample list, into Properties > Numbers > select and tick "Do Not Mail":

Unsubscription HTML page

The unsubscribe template contains the web page which will be shown when the user clicks the unsubscribe link. This template will need to perform the actual unsubscription, using am HTTP POST request:

POST <server>/WebProd/cgi-bin/AskiaExt.dll?Action=Unsubscribe?PanelId=<panelid>

Example unsubscribe template form with an unsubscribe post action button and a redirect on successful or failed:

<form action="[ccaUnsubscribeLink]&Redirect=https://myserver.com/Webprod/resources/thanks.html&ErrorRedirect=https://ns136.askia.com/Webprod/resources/error.html" method="post">
<label for="submit">Click 'unsubscribe' to unsubscribe [ccaEmail] from this mailing list.</label>
<br />
<input type="submit" style="width:20%" class="btn" name="submit" value="Unsubscribe">
</form><br>

Keywords

These keywords are supported in the unsubscribe template: 

• All the regular list fields, between square brackets (identical to the mail templates).
• The [ccaUnsubscribeLink], [ccaUnsubscribeEncryptedLink] and [ccaEmail] keywords.
• ??ResPath?? will return the main resource URL (not the one from a survey).

Event "Unsubscribe"

Keep in mind that CCA will only update the DNC list, not the external database that has been used to create the sample list. So, if you make an update from an external database, you may lose the information previously recorded in the sample list (but not yet recorded into the external database). That's why you need to add an event "unsubscribe" on your sample list:

The SQL query to use will be an INSERT INTO your external database used to create the DNC list.