Follow

Unsubscribe Form Using Customer Key

Overview

In a realm with Customer Key enabled, you have the option to create an unsubscribe form using the Email address or the Customer Key to search for the subscriber.  Customer Key is only available on some systems.

To create an Unsubscribe Form using Customer Key

  1. Go to SUBSCRIBERS > SUBSCRIPTION FORM WIZARD.
  2. Select a List.
  3. From Generate select 'Unsubscribe Form'.
  4. Select 'Use customer key for subscriber lookup'. 
  5. Enter a Goto URL for the landing page.  If no landing page is defined, the form will use the Landing Page defined in your List properties.  If no Landing Page is defined, the subscriber will see a default platform welcome page.
  6. Enter an Error Landing Page. If no landing page is defined, the form will use the Landing Page defined in your List properties.  If no Landing Page is defined, the subscriber will see a default platform error page.
  7. Click NEXT.
  8. Select the form code and paste into a text editor to customize the form further, then place the form code iinto your website.

Please consider carefully how you wish to proceed when using the Customer Key for Unsubscribe Forms.  If you choose to create an Unsubscribe Form using the Customer Key, you must be sure your subscriber knows their Customer Key (perhaps it is an account number), or you must include code in your form to insert the Customer Key for the subscriber. 

In most cases, it will be easier for the subscriber to use their Email Address instead of their Customer Key.   If you want to create an Unsubscribe Form using the Email Address instead, then select 'Use email for subscriber lookup' in step 4.

Example

The following is an example of how the form code will appear, where [siteURL] is the URL of your domain, [slid] is the special list id, [gotoURL] is the success Landing Page, and [errorURL] is the Error Landing Page.  In this basic example, the Customer Key field is labeled "Account Number" and assumes the subscriber will know this information.

<form action="http://[siteURL]/bin/listctrl" method="POST" name="unsubscribe_form">     <input type="hidden" id="slid" name="slid" value="[slid]" />     <input type="hidden" id="cmd" name="cmd" value="unsubscribe" />     <input type="hidden" id="goto" name="goto" value="[gotoURL]" />     <input type="hidden" id="errors_to" name="errors_to" value="[errorURL]" /> Account Number: <input type="text" name="customer_key" size="20" /> <input type="submit" value="Unsubscribe" /> </form>

Testing the Form

Once you have created a form, test it to ensure it is functioning as expected.  To test your unsubscribe form:

  1. Login to your realm.
  2. Go to SUBSCRIBERS > SEARCH FOR SUBSCRIBER.
  3. Click ADD.
  4. Enter an Email address and Customer Key  to create a test subscriber.  Click the Subscription tab and select the list to test against, then click SAVE.
  5. Save the form as an .html file. 
  6. Open the .html file in your browser.
  7. Fill the form fields with the test Email address or Customer Key, then submit the form.
  8. Login to your realm.
  9. Go to SUBSCRIBERS > SEARCH FOR SUBSCRIBER.
  10. Enter the Email address or Customer Key submitted above, then click SEARCH
  11. Double click the subscriber record to view the details.
  12. Verify the subscription was removed in the Subscription tab.
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Powered by Zendesk