11.5 inserting forms into mailings
11.5 Inserting forms into mailings
For saved forms, the URL of the respective form is displayed below the name. In addition to the CTOKEN, the link also contains the form name. Like any other link, you can enter this link directly in the browser or include it in mailings.
Please note: If you have used an Introductory trigger, the direct call in the browser always leads to the error form, since the E-Marketing Manager does not find an agnUID for which it can execute the introductory action. For this reason, you must attach an agnUID to the link for forms that are to load or process recipient data, such as a profile change page, a newsletter unsubscribe or a web view of your mailing.
The agnUID is generated automatically by E-Marketing Manager when you attach the following parameter to the URL:
&agnUID=##AGNUID##
Calling a form for unsubscription with agnUID could look like this:
agnCTOKEN=xxxxxx&agnFN=unsubscribe&agnUID=##AGNUID##
However, you cannot simply copy this link into your browser either, as the link does not yet have any reference to a recipient. To be able to check the success form with reference to a recipient, you must use the following trick: You can obtain a valid agnUID by embedding the form URL in any mailing as shown above. Then click on this link in the preview for a test recipient. This way, you can also directly check whether the trigger used does exactly what you expect.
The AGNITAS user ID is generated in encrypted form from the recipient data and can be explicitly assigned to a data record.
Since it is often forgotten that an agnUID is required, we have developed our own agn tag that you can insert into your mailing instead of the URL:
[agnFORM name="\<Formname>"/]
Instead of the placeholder, insert the name of your form. The E-Marketing Manager automatically adds the agnUID if it is required for the form call. An integration of the unsubscribe form from the first example in your mailing would look like this with the tag:
Tip: You can enter form calls in the mailing as administrative clicks, then statistics let's you see how many clicks have been made on your actual content. You can find out more in chapter Editing links.