Zephr User Guide

Add a User Attribute

10 views 0

To add a user attribute, complete the following steps:

  1. Select Identify from the menu options
  2. Select User Attributes from the menu options

    The user attributes screen displays, as illustrated below:

    User Attributes

  3. Select the Add a User Attribute button

    The Add User Attribute screen displays, as illustrated below:

    Add User Attributes

  4. Enter a name for the user attribute in the Label text box
  5. Select the format used by the user attribute from the Type drop-down options. The options are as follows:
    • Text
    • Long Text
    • Number
    • Telephone
    • Email
    • URL
    • Selectlist
    • Checkbox
    • Radio Button
    • Range
    • Color
    • Time
    • Date
    • Date Time
    • Week
    • Month
    • Hidden

      Note: You can use a Hidden type to collect information about the end user without the field being visible on their screen. For example, you could use a hidden field to record the site on which the end user registered.

    The selected option defines how the data is stored and validated.

    Note: By default, Zephr always stores the following information:

    • Email address
    • Username
    • Date of registration
    • Zephr, or user, ID
    • Tracking ID

    This means that you do not have to define user attributes for these.

  6. If you select Selectlist from the Type drop-down menu, select the Add An Option button to add the menu options

    The Add Option dialog box displays, as illustrated below:

    Add Option

    To add an option, complete the following steps:

    1. Enter the heading for the options in the Label text box
    2. Enter the name of the option in the Value text box
    3. If you want the option to be selected by default, select the Default checkbox
    4. Select the Save button to add the option to your Selectlist options or Radio Buttons and return to the Add User Attribute screen. Selecting the Cancel button displays the Add User Attribute screen without saving your changes
  7. If you select Radio Button from the Type drop-down menu, select the Add An Option button to add the selectable options

    The Add Option dialog box displays, as illustrated above. Complete the dialog box as described for the Selectlist type.

  8. If you select Range from the Type drop-down menu, further fields display as illustrated below:

    Range

    To define the valid range, complete the following steps:

    1. Enter the start of the valid range in the Range Start text box
    2. Enter the end of the valid range in the Range End text box
    3. Enter the amount by which the valid range increases in the Range Step text box

      Note: You can also use the up and down arrows at the end of the Range Step text box to increment or decrement the step value.

      For example, if you enter a Range Start of 1 and a Range End of 10 with a Range Step of 2, the end user can enter 2, 4, 6, 8, or 10. If the Range Step is set to 1, the end user can enter any value between 1 and 10, inclusive.

  9. Optionally, for all types, enter a description of the user attribute for internal purposes in the Internal description (Optional) text box
  10. Optionally for all types, enter a description of the user attribute to display in the Public description (Optional) text box
  11. Optionally for the Text, Telephone, Email, URL or Date types, enter the expression against which to validate the entered information in the Validation Expression (Optional) text box
  12. For all Types, if the information is required, select the Mandatory field checkbox

    Notes:

    • Mandatory fields must always be completed when a user is created, whether directly on your site by the end user, using the Zephr API or directly in the Admin Console
    • You must include any fields that are defined as mandatory in your registration forms. If you do not want to include the field
  13. To add another user attribute, select the Add another checkbox
  14. Select the Save button to save the user attribute

    If you selected the Add another checkbox, the Add User Attribute screen displays. You can add another user attribute as described in the steps above.

    If you did not select the Add another checkbox, the User Attributes screen displays.

The user attributes are listed in the User Attributes screen. The order is reflected in the following places:

  • The user’s profile
  • The user list

You can reorder the user attributes by dragging them to the required position in the list.