Deconstructing Unsubscribe Links

Overview

Let’s deconstruct the example SMTPProvider Application unsubscribe link below:

http://example.com/ga/unsubscribe/1-32383893-57-566-60d358adf6afe74-5d11c85933

Version 1 links consist of the following parts:

  1. http://example.com/ga/unsubscribe/ – The base unsubscribe URL, derived from the URL Domain setting that was used.
  2. 1 – This is the version number (version 1) of the URL. This exists so that we can update the URL format in the future without breaking compatibility for existing campaigns.
  3. 32383893 – This is the subscriber ID that the link was sent to.
  4. 57 – This is the ListID that the link was sent to.
  5. 566 – Stat Slice ID – This is an internal value that we use to determine where to put the stats for this click.
  6. 60d358adf6afe74 – Subscriber confirmation code – This exists as a security measure to make sure that the subscriber is real.
  7. 5d11c85933 – Anti-tamper code – This exists as a security measure to make sure that the unsubscribe is real.

http://example.com/ga/unsubscribe/1-32383893-57-912-566-60d358adf6afe74-5d11c85933

Version 2 links consist of the following parts:

  1. http://example.com/ga/unsubscribe/ – The base unsubscribe URL, derived from the URL Domain setting that was used.
  2. 2 – This is the version number (version 2) of the URL. This exists so that we can update the URL format in the future without breaking compatibility for existing campaigns.
  3. 32383893 – This is the subscriber ID that the link was sent to.
  4. 57 – This is the ListID that the link was sent to.
  5. 912 – This is the Campaign ID that the link was sent to.
  6. 566 – Stat Slice ID – This is an internal value that we use to determine where to put the stats for this click.
  7. 60d358adf6afe74 – Subscriber confirmation code – This exists as a security measure to make sure that the subscriber is real.
  8. 5d11c85933 – Anti-tamper code – This exists as a security measure to make sure that the unsubscribe is real.

Web Interface Lookups

Once you’ve identified the subscriber ID and ListID, you can lookup information about the mailing list or subscriber.

To lookup information on the mailing list, go to the following URL:

  • http://HOSTNAME/ga/mailing_lists/LISTID/

The following replacements will need to be made:

  1. Replace HOSTNAME with your SMTPProvider Application server’s hostname.
  2. Replace LISTID with the ListID.

To lookup information on the subscriber, go to the following URL:

  • http://HOSTNAME/ga/mailing_lists/LISTID/subscribers/SUBSCRIBER_ID

The following replacements will need to be made:

  1. Replace HOSTNAME with your SMTPProvider Application server’s hostname.
  2. Replace LISTID with the ListID.
  3. Replace SUBSCRIBER_ID with the actual subscriber ID.