Unsubscribing/checkout(Double-opt-in)

Double Opt Out Template TAGs

The sample template we will now use to describe these TAGs properly is the template with ID 4. (For better comprehension, you should open the template while reading this documentation.) We will only describe the TAGs that are needed for the DOO function. The programming of common templates is described in Chapter “Subscription”.

The figure, shown underneath, can be found in your WebInterface template ID 4, and looks like this:

Abb. 8.4.4 - WebInterface Templates (Beispiel ID 4)

Preparing the template

Provided there is an HTML page designed according to your requirements, you may now start to create the template by filling in the BACKCLICK-specific TAGs for the input boxes where the subscribers may fill in their data. Within the HTML-template, you will now fill in a form field where all the

necessary variables will be saved. All the information needed for your system, such as introducing sentences, error or success messages, and the information for the input boxes, should be inserted between the <FORM>-</FORM>-TAGs.

Form-Field Introduction:

<FORM method="post" action="web.unsubscribe?tid=4" name="remove_reader">

You now need to define the error messages (-TAGs), to anticipate potential errors.

Error message:

<!--ERROR:NOABO-1-->
  <TR>
    <TD><FONT face="verdana" size="1">You are not subscribed to the Stock-Newsletter.</FONT></TD>
  </TR>
<!--/ERROR:NOABO-1-->

BACKCLICK is able to show several error messages: in case wrong information is provided by the subscriber; if any input box is left empty; or in case of any system error. By using the following -TAGs you may show the error to the subscriber:

<!--ERROR:DATABASEFIELDNAME-->Bitte geben Sie ... ein.<!--/ERROR:DATABASEFIELDNAME-->

For detailed information, please read the corresponding section in this chapter which describes the programming of the unsubscribing template and the usable TAGs.

DOO-spezific-

TAGs

After you have defined the required messages, you will need to add the parts that are necessary in order for you to use the

DOI function. As explained at the beginning of this chapter, the subscription will be split into several parts:

Unsubscribing by using the template form with or without knowing the password
Display of an “UNCONFIRMED” message that says, “You will receive a confirmation message including a confirmation link to confirm the unsubscription.”
Sending a defined e-mail including the request to confirm
Display a “CONFIRMED” message in the template after the subscriber clicked on the hyperlink that has been sent via e-mail
The subscriber’s data will be erased from the BACKCLICK database

This message needs to be inserted between the following TAGs:

TAGs der vorläufigen Anmeldebestätigung:

<!--UNCONFIRMED--> ......... <!--/UNCONFIRMED-->

This message should look like this in your template code (example ID 4):

<!--UNCONFIRMED-->
  <!--SUCCESS-->
    <TR>
      <TD>
      <FONT face="verdana" size="1">You will soon receive a confirmation e-mail.</FONT><BR>
      <FONT face="verdana" size="1">Please click on the following link to checkout from newsletter:<BR></FONT>
      </TD>
    </TR>
  <!--/SUCCESS-->
  <!--SUCCESS:REMOVED-NEWSLETTER-1-->
    <TR>
      <TD><FONT face="verdana" size="1">Stock-Newsletter</FONT></TD>
    </TR>
  <!--/SUCCESS:REMOVED-NEWSLETTER-1-->
  <!--SUCCESS:REMOVED-NEWSLETTER-2-->
    <TR>
      <TD><FONT face="verdana" size="1">New Market Newsletter</FONT></TD>
    </TR>
  <!--/SUCCESS:REMOVED-NEWSLETTER-2-->
  <!--SUCCESS:REMOVED-NEWSLETTER-3-->
    <TR>
      <TD><FONT face="verdana" size="1">Investmentfonds Newsletter</FONT></TD>
    </TR>
  <!--/SUCCESS:REMOVED-NEWSLETTER-3-->
  <!--SUCCESS:REMOVED-NEWSLETTER-4-->
    <TR>
      <TD><FONT face="verdana" size="1">IPO-Newsletter</FONT></TD>
    </TR>
  <!--/SUCCESS:REMOVED-NEWSLETTER-4-->
<!--/UNCONFIRMED-->

The content and the layout are to be defined freely. The content of the DOO-confirmation e-mail will be defined later on while you are programming the template. We will start with programming the success messages that will be shown in the web of the subscriber if the confirmation of the checkout took place and the subscriber’s data will be removed from the database of BACKCLICK.

The success messages need to be inserted :

<!--CONFIRMED--> ........ <!--/CONFIRMED-->

The message should look like this in your template code (example ID 4):

<!--CONFIRMED-->
  <!--SUCCESS-->
    <TR>
      <TD>
      <FONT face="verdana" size="2"><STRONG>Congratulation!</STRONG></FONT><BR>
      <FONT face="verdana" size="1">The checkout from the following newsletters has been successfully:<BR></FONT>
      </TD>
    </TR>
  <!--/SUCCESS-->
  <!--SUCCESS:REMOVED-NEWSLETTER-1-->
    <TR>
      <TD><FONT face="verdana" size="1">Stock-Newsletter</FONT></TD>
    </TR>
  <!--/SUCCESS:REMOVED-NEWSLETTER-1-->
  <!--SUCCESS:REMOVED-NEWSLETTER-2-->
    <TR>
      <TD><FONT face="verdana" size="1">New Market Newsletter</FONT></TD>
    </TR>
  <!--/SUCCESS:REMOVED-NEWSLETTER-2-->
  <!--SUCCESS:REMOVED-NEWSLETTER-3-->
    <TR>
      <TD><FONT face="verdana" size="1">Investmentfonds Newsletter</FONT></TD>
    </TR>
  <!--/SUCCESS:REMOVED-NEWSLETTER-3-->
  <!--SUCCESS:REMOVED-NEWSLETTER-4-->
    <TR>
      <TD><FONT face="verdana" size="1">IPO-Newsletter</FONT></TD>
    </TR>
  <!--/SUCCESS:REMOVED-NEWSLETTER-4-->
<!--/CONFIRMED-->

BACKCLICK lets you define one of these success messages for every mailing list that exists in your system. For this reason, add the ID of each individual mailing list separated by "-". The IDs of the mailing lists can be found in “Mailing List Management (Main Menu) -> mailing list overview (submenu).” It may happen that a subscriber will click on the confirmation link more than once, because of slower Internet connections or for other reasons, even though BACKCLICK already registered the subscription. While saving the subscriber in the database, BACKCLICK sends out a “CONFIRMED” block.

After having clicked more than once, the subscriber will receive an “ALREADY-CONFIRMED” block if defined.

This message must be written into the following TAG:

<!--ALREADY-UNCONFIRMED--> ................... <!--/ALREADY-UNCONFIRMED-->

The message will look like this:

<!--ALREADY-UNCONFIRMED-->

  <!--ERROR-->
    <TR>
      <TD><FONT face="verdana" size="1">No further confirmation of the unsubscription is needed. <BR><BR>
          The following e-mail address<BR><BR>

          <STRONG>'<?GIS name="EMAIL" content="form"?>'</STRONG><BR><BR>
          has been checked out successfully from the following newsletters:<br><br></FONT></TD>
    </TR>
  <!--/ERROR-->
  <!--ERROR:ALREADY-UNCONFIRMED-1-->
    <TR>
      <TD><FONT face="verdana" size="1">- Stock-Newsletter</FONT></TD>
    </TR>
  <!--/ERROR:ALREADY-UNCONFIRMED-1-->
  <!--ERROR:ALREADY-UNCONFIRMED-2-->
    <TR>
      <TD><FONT face="verdana" size="1">- New Market Newsletter</FONT></TD>
    </TR>
  <!--/ERROR:ALREADY-UNCONFIRMED-2-->
  <!--ERROR:ALREADY-UNCONFIRMED-3-->
    <TR>
      <TD><FONT face="verdana" size="1">- Investmentfonds Newsletter</FONT></TD>
    </TR>
  <!--/ERROR:ALREADY-UNCONFIRMED-3-->
  <!--ERROR:ALREADY-UNCONFIRMED-4-->
    <TR>
      <TD><FONT face="verdana" size="1">- IPO-Newsletter</FONT></TD>
    </TR>
  <!--/ERROR:ALREADY-UNCONFIRMED-4-->
<!--/ALREADY-UNCONFIRMED-->

The form fields that should be shown to the subscriber have to be defined and integrated into the template. These form field TAGs need to be written in between the -TAG.

REMOVE-USER-TAG:

<!--REMOVE-USER--> ........ <!--/REMOVE-USER-->

Example for the input box “e-mail”:

E-mail entry field:

<?GIS EMAIL?>

Selection of mailing list/newsletter:

<?GIS NEWSLETTER 1?>

For further information on these TAGs, please read “Unsubscription”

DOO - EMAIL

This section describes the confirmation link of the Double Opt Out (DOO) procedure. In other words, a user who subscribed by using the website will not automatically be written into your database, but will receive an e-mail with a link in it so that he or she can confirm the unsubscription again. This link is set by writing the "$$DOO-LINK$$" Tag into the “body.” The template must contain this link, because otherwise the subscriber cannot confirm the unsubscription. In the section “TO,” you may access all data fields by using the notation $$DATABASEFIELDNAME$$ for field names that have been saved in the subscriber’s profile. This is also possible in the sections “SUBJECT” and “BODY”. If one of these fields is the “Title” field, you may add special gender-relevant text with the notation "$$male$female$neutral$$.

You may now create the content of the confirmation e-mail.

DOO-EMAIL-TAG:

<!--DOO-EMAIL--> ......... <!--/DOO-EMAIL-->

To define the content, the system provides the following TAGs to create the sender name and the subject of the e-mail.These are the accessible TAGs listed:

Sender name within the DOO-EMAIL:

<!--SENDER-NAME-->Unsubscription Link<!--/SENDER-NAME-->

The  TAG contains the name that will be displayed in the e-mail client of the subscriber, instead of the e-mail address of the sender defined in the system.

Priority of the DOO-EMAIL:

<!--PRIORITY-->1<!--/PRIORITY-->

You may define priority for the confirmation e-mail. Selectable values are:

1 (Highest Priority), 2 (High Priority), 3 (Normal Priority), 4 (Low Priority), 5 (Lowest Priority).

Receiver’s name within the DOO-EMAIL:

<!--TO-->$$FIRSTNAME$$ $$LASTNAME$$<!--/TO-->

By using the -TAGs you may define an optional name for the person receiving the e-mail. Within these TAGs, you may access all the personalized fields existing in your system. Do not use line breaks!

Subject-TAG within the DOO-EMAIL:

<!--SUBJECT-->Please confirm your unsubscription!<!--/SUBJECT-->

The subject of the confirmation e-mail must be put in between this TAG and will be displayed in the subject line of the e-mail client of the recipient. All of the personalized fields may be accessed here as well. Do not use line breaks!

Body-TAG within the DOO-EMAIL:

<!--BODY-->
Dear $$TTLE$$ $$LASTNAME$$,

click on the following link to checkout:
$$DOO-LINK$$
You will be unsubscribed with the following data:
Email : $$EMAIL$$
Password: $$PASSWORD$$
Title : $$TITLE$$
First Name : $$FIRSTNAME$$
Last Name: $$LASTNAME$$
<!--SUCCESS:REMOVED-NEWSLETTER-->from the following newsletter(s):<!--/SUCCESS:REMOVED-NEWSLETTER-->
<!--SUCCESS:REMOVED-NEWSLETTER-1--> -
Stock-Newsletter<!--/SUCCESS:REMOVED-NEWSLETTER-1-->
<!--SUCCESS:REMOVED-NEWSLETTER-2--> -
New Market-Newsletter<!--/SUCCESS:REMOVED-NEWSLETTER-2-->
<!--SUCCESS:REMOVED-NEWSLETTER-3--> -
Investmentfond-Newsletter<!--/SUCCESS:REMOVED-NEWSLETTER-3-->
<!--SUCCESS:REMOVED-NEWSLETTER-4--> -
IPO-Newsletter.<!--/SUCCESS:REMOVED-NEWSLETTER-4-->
Your editorial staff
Disclaimer:
-----------
If you did not ask for this e-mai, please ignore it without further action.
<!--/BODY-->

You will write the content of the e-mail in between these TAGs. All of the data fields to personalize the subscriber’s data may be used here.

The BODY must contain a special TAG:

DOO-LINK:

<!-DOO-LINK-->

The  will be replaced by the unsubscribing link after the e-mail has been sent out. It must be placed inside the body-TAG, so that it will be possible to unsubscribe. Additional e-mail content may be designed however you choose. You may, for example, define other messages in response to successful unsubscription by a subscriber. Those messages should be entered into already known -TAGs.

Example for the replaced link:

http://yourdomain.de/bc/servlet/web.unsubscribe?tid=2&c=N18xdoi

To define an HTML success message for the unsubscription, you need to integrate this link into the <A>-TAG:

Example for the DOO link in the HTML message:

<A href="<!--DOI-LINK-->">Please click here to confirm the unsubscription.</A>

BCC within the DOO-EMAIL:

<!--BCC--> ...... <!--/BCC-->

Here you may define that any time there is an unsubscription, BACKCLICK will send you an e-mail.

CONFIRM-EMAIL

If you want to send a success message to the subscriber following a successful unsubscription, you must use this TAG. The e-mail will be defined inside the template. The TAGs you need to use are therefore the same TAGs as with the DOO-EMAIL but here they are used as enclosing TAGs.

TAGs of the confirmation e-mail:

<!--CONFIRM-EMAIL--> ....... <!--/CONFIRM-EMAIL-->

If you do not want to send an extra “success” e-mail to the subscriber, do not write these TAGs into your template.

Sender name of the CONFIRM-EMAIL:

<!--SENDER-NAME-->Unsubscription<!--/SENDER-NAME-->

The  TAG contains the name that will be displayed in the e-mail client of the subscriber, instead of the e-mail address of the sender defined in the system.

Priority within the CONFIRM-EMAIL:

<!--PRIORITY-->3<!--/PRIORITY-->

You may define priority for the confirmation e-mail. Selectable values are: 1 (Highest Priority), 2 (High Priority), 3 (Normal Priority), 4 (Low Priority), and 5 (Lowest Priority).

Receiver’s name within the DOO-EMAIL:

<!--TO-->$$FIRSTNAME$$ $$LASTNAME$$<!--/TO-->

Subject-TAG within the DOO-EMAIL:

<!--SUBJECT-->Confirmation needed<!--/SUBJECT-->

BCC innerhalb der CONFIRM-EMAIL:

<! --BCC--><!--/BCC-->

An additional recipient for an e-mail may be defined by using the -TAGs (BCC stands for “Blind Carbon Copy”). In this case, the subscriber will not know that there is a second recipient for the confirmation e-mail. All BACKCLICK users may then see an overview in real time of the subscriptions that are taking place.

Body-TAG innerhalb der CONFIRM-EMAIL:

<!--BODY--> ......... <!-/BODY-->

You will write the content of the e-mail in between these TAGs. All of the data fields to personalize the subscriber’s data may be used here.

Success messages within the CONFIRM-EMAIL:

<!--BODY-->Sehr $$geehrter$geehrte$$ $$ANREDE$$ $$NACHNAME$$,
Sie wurden dann mit folgenden Daten

  Email : $$EMAIL$$
  Anrede : $$ANREDE$$
  Vorname : $$VORNAME$$
  Nachname: $$NACHNAME$$
  Passwort: $$PASSWORD$$

<!--SUCCESS:REMOVED-NEWSLETTER-->von folgendem/n
Newsletter(n):<!--/SUCCESS:REMOVED-NEWSLETTER-->

<!--SUCCESS:REMOVED-NEWSLETTER-1--> -
Stock-Newsletter<!--/SUCCESS:REMOVED-NEWSLETTER-1-->
<!--SUCCESS:REMOVED-NEWSLETTER-2--> - Neuer
Markt-Newsletter<!--/SUCCESS:REMOVED-NEWSLETTER-2-->
<!--SUCCESS:REMOVED-NEWSLETTER-3--> -
Investmentfond-Newsletter<!--/SUCCESS:REMOVED-NEWSLETTER-3-->
<!--SUCCESS:REMOVED-NEWSLETTER-4--> -
IPO-Newsletter<!--/SUCCESS:REMOVED-NEWSLETTER-4-->

abgemeldet.


Ihr Redaktions-Team

Disclaimer:
-----------
Sollten Sie diese eMail ungewollt erhalten haben, bitten wir
Sie darum, diese eMail einfach zu ignorieren.
<!--/BODY-->

You will find the whole section of the CONFIRM-EMAIL of the template ID 4:

<!--CONFIRM-EMAIL-->
<!--SENDER-NAME-->Abmeldung<!--/SENDER-NAME-->
<!--PRIORITY-->3<!--/PRIORITY-->
<!--TO-->$$VORNAME$$ $$NACHNAME$$<!--/TO-->
<!--SUBJECT-->Bestätigung Ihrer Abmeldung<!--/SUBJECT-->
<!--BODY-->Sehr $$geehrter$geehrte$$ $$ANREDE$$ $$NACHNAME$$,

Sie wurden dann mit folgenden Daten

  Email : $$EMAIL$$
  Anrede : $$ANREDE$$
  Vorname : $$VORNAME$$
  Nachname: $$NACHNAME$$
  Passwort: $$PASSWORD$$

<!--SUCCESS:REMOVED-NEWSLETTER-->von folgendem/n
Newsletter(n):<!--/SUCCESS:REMOVED-NEWSLETTER-->

<!--SUCCESS:REMOVED-NEWSLETTER-1--> -
Stock-Newsletter<!--/SUCCESS:REMOVED-NEWSLETTER-1-->
<!--SUCCESS:REMOVED-NEWSLETTER-2--> - Neuer
Markt-Newsletter<!--/SUCCESS:REMOVED-NEWSLETTER-2-->
<!--SUCCESS:REMOVED-NEWSLETTER-3--> -
Investmentfond-Newsletter<!--/SUCCESS:REMOVED-NEWSLETTER-3-->
<!--SUCCESS:REMOVED-NEWSLETTER-4--> -
IPO-Newsletter<!--/SUCCESS:REMOVED-NEWSLETTER-4-->

abgemeldet.


Ihr Redaktions-Team

Disclaimer:
-----------
Sollten Sie diese eMail ungewollt erhalten haben, bitten wir
Sie darum, diese eMail einfach zu ignorieren.
<!--/BODY-->
<!--/CONFIRM-EMAIL-->

Links

The Templates

What do you think about this topic? Send feedback!