de en


Setups: Profile manager

In the profile manager, you create forms for your website that subscribers can use to change their subscriber data themselves, for example when their email address changes.

The subscriber can also add missing information, for example areas of interest.

You insert the profile manager link via the input assistance, either directly in the newsletter or on a landing page.

A typical process looks like this: the subscriber clicks 'Change profile' in the newsletter. A form opens in which the existing subscriber data is prefilled. The subscriber changes or adds their data and saves the entry.

You can later edit ('open'), 'move' to subfolders and 'delete' profile managers you have already created. If you have already moved a profile manager to a subfolder, use the 'Open folder' button to go to the subfolder.

Creating a new profile manager setup

Basic settings

Enter a name and, optionally, a description.

Advanced settings

In the 'E-mail forwarding' field, enter your own email address if you want to receive a notification email for every profile change. This email contains the subscriber's data before and after the change. The 'Report changed fields only' option lets you decide whether all fields or only changed fields are listed.

An 'HTTP forwarding' is also possible to forward the data to a URL on your own server. The POST method is used for this. The data format is field[<fieldid>]=<fieldvalue>, list[<listid>]=<0 or 1>, id=<subscriberid>.

Dialog pages

Here you enter the URLs of your own dialog pages. If these fields are left empty, the system's default dialog pages are used.

Form

On the 'Form' tab, you design your profile manager form.

The view consists of two areas: on the left you see the preview, on the right all available elements and editing options.

Every change is immediately visible in the preview. The three basic steps are:

  • Insert an element: Drag the element you want from the 'Element pool' (right side) into the form.
  • Change the position: Move the element within the form to the position you want via drag&drop.
  • Edit an element: As soon as you select an element in the preview, the 'Edit element' tab opens on the right side. Here you adjust the properties of the selected element, e.g. the label or width.

The right side shows 4 tabs for editing the form:

Tab #1: Element pool

Here you find all elements that can be inserted into the form. To place elements side by side instead of one below the other, simply change their width, e.g. from 100% to 50%.

  • Headlines, texts and spacers provide information and visual structure.
  • Subscriber fields take the user's input, depending on the field type as a text field, date field, checkbox(es) or selection list.
  • Subscriber list selection: Following the principle "one subscriber list per topic", you offer various topic newsletters for selection in the form. If the user selects the topic "Travel tips", they are added to the "Travel tips" list, and so on. Alternatively, you can separate topics with a subscriber field with selection options, which you then address via different target groups. Separating by "one list per topic" makes sense if the topics do not overlap and it should later be possible to unsubscribe separately by topic (=list). The list selection can be inserted as a single or multiple selection. For the appearance, select either 'List selection' or 'Radio buttons' on the 'Edit element' tab. In addition to the lists in the form, the new subscriber is also subscribed to the lists you activated on the 'Subscriber lists' tab.


Tab #2: Edit elements

When you select an element in the preview, the 'Edit element' tab opens on the right. The following screenshot shows this using the example of the 'Email' field:

Subscriber fields have the following properties:

  • Width: The default is 100%. If you want to place two fields side by side, set both to 50%.
  • Label text: The default is the name of the field. The label appears in bold above the input field. You can adjust it in the form as you like or leave it empty.
  • Description: The description appears below the input field. Here you can, for example, point out a required field.
  • Required field Yes/No and error message text: If a field is defined as a required field, an error message is shown if the field is not filled in. You can enter a separate error message text for each required field. Please avoid unnecessary required fields! In Germany, the principle of "data avoidance and data minimization" applies in accordance with Section 3a of the German Federal Data Protection Act (BDSG). For subscribing to a classic email newsletter, required fields other than the email address are taboo. Only define fields as required fields if their data is absolutely necessary for the subscription (for example, to an event).
  • Hidden field (hidden field): If you want to pass a fixed field value with the form, first insert the field in the form and then convert it to a hidden field. To make sure that security-relevant information is really hidden, emma stores all hidden fields internally with the respective setup and does not insert them into the form source code. Hidden fields are often used to record the entry point (which form, which website) of the new subscriber.

The checkbox for consent to the 'Collection of personal data (user profiles)' should be included in the form, so that subscribers can activate or deactivate it at any time, independently of receiving the newsletter.

The field types Single selection or Multiple selection (e.g. the salutation with the options Mr/Ms) have additional settings for 'Appearance' and 'Selection options'.

The same applies to the selection element Subscriber lists:

For the Appearance, select either 'List selection' or 'Checkboxes' (single selection) or 'Radio buttons' (multiple selection).

In the 'Selection options' area, you define whether all or only certain field options (or lists or setups) are offered in the form. Use the icons on the far right to change the order of the options via drag&drop or to hide options.

In the left column of the table, you adjust the name with which each option should appear in the selection list. On the right side, you see the original name (value) of the field option for information (cannot be changed). For a list or setup selection, the ID is displayed.

Use the 'Add selection option' link to add previously hidden or newly added options to the selection at any time.

Tab #3: Layout

Here you define the general look of your form, such as font, colors and inner/outer spacing. Every change is immediately visible in the preview.

Tab #4: Source code

Once you have put together your form, you generate the current form source code here. There is an important difference between profile manager forms and opt-in/opt-out forms:

  • Opt-in and opt-out forms: You copy the generated source code, adjust it a little if needed, and then insert it "manually" at the position you want on your website. Only then are the changes to the form visible on your website.
  • Profile manager: The source code is stored directly on the emma servers. Every change to the source code is immediately visible live if you have already embedded the profile manager as a mailing link or on a landing page.

To test the source code, insert the profile manager link into a mailing via the input assistance. Send yourself a test delivery of the mailing and click the profile manager link in it.

Test the behavior of the form: Are changed profile data saved to the subscriber fields? Is the error message for required fields that are not filled in helpful? Are the correct dialog emails sent? Do the dialog pages you set up appear?


'HTML' and 'CSS' tabs

These tabs show the automatically generated form source code, which you can adjust if needed.

Adding your own adjustments to the source code

In the new code format (since February 2017), you can also add your own adjustments to the source code generated by the system if needed. This applies to HTML, JavaScript and CSS.

The following areas of the 'HTML' tab are always overwritten by the system, so please enter your own adjustments outside these areas:

  • /* BEGIN ELEMENTS */ This area is overwritten by the system. /* END ELEMENTS */
  • /* BEGIN DTP */ This area is overwritten by the system. /* END DTP */
  • <!-- BEGIN ELEMENTS --> This area is overwritten by the system. <!-- END ELEMENTS -->

When generating the source code, keep the default setting as shown in the screenshot, i.e. both checkboxes deactivated.

There are no special areas for the CSS tab, i.e. here the entire CSS code is either left untouched or overwritten.