Navigation Path

Administration​ > ​Attributes​

Attributes​

An attribute is a property field that stores data in Mapp Engage. Attributes provide you with flexible storage space so that you can store many types of information in your system.


This window provides access to three types of attributes.

  • ​Profile Attributes: The profile attributes store data about your contacts. Together, the profile attributes create a complete picture of each contact. When you store rich and full profile data you can develop targeted, personalized marketing programs that are tailored for individual contacts. You can use the data that is stored in the profile attributes to personalize messages and create selections.
  • ​Channel Attributes​
  • ​Related Data​

Information​

The attributes in this area use square bracket notation. For example, ${user['Email']}. This format is different from dot notation. You cannot use square bracket notation for standard attributes in import files. For information about how to format attribute references in import files, see ​CSV Format for Contact Imports and ​XML Format for Contact Imports.

Column Name

Description

​Name​

Displays the name of the attribute. The name identifies the attribute in the system.

​Display Name​

Displays an optional display name for the attribute. The display name provides more information about the attribute and facilitates attribute management.

Attribute Type

Displays whether the attribute is a standard attribute or a custom attribute.

  • Standard:​ Mapp Engage offers several standard attributes to store contact profile data. These attributes default in every system.
  • Custom:​ You can also create your own profile attributes to store data about a contact. These attributes are called custom attributes. Custom attributes store the data about your contacts that are relevant to your digital marketing needs and strategies.

​Reference​

The ​Reference​ area displays the internal notation that Mapp Engage uses to reference attributes. Use this notation in functions and personalization placeholders.

  • Functions:​ This format is used to reference attribute values in Mapp Engage functions. For example, ${user['Email']}.
    For more information, see ​Mapp Engage Functions.
  • Placeholder:​ This format is used to reference an attribute in a personalization placeholder. For example, <% ${user['Email']} %>.
    Personalization placeholders can be inserted into messages and landing pages. For more information, see ​Personalization Placeholders.

​Type​

Displays the data type of the attribute.

  • String:​ Stores data as a series of characters. Mapp Engage supports all common character sets. The maximum length of a string attribute is 2000 characters.

    For search purposes, the string has to be truncated to 200 characters.

  • Boolean:​ Stores data as ​true​ or ​false.
  • Number:​ Stores data as a positive or negative numeric value.
    The decimal point must be a period (UK /US standard). You cannot use characters to separate groups of digits.
  • Date:​ Stores data as a date.
    Mapp Engage uses ISO-8601 to format dates. With this format, you specify time zones as follows: YYYY-MM-DDThh:mm:ss(+/-)GMT difference. For example, the time zone US/Eastern is formatted: 2012-12-25T15:15:15-05:00. ISO-8601 is recommended for formatting date information in import files. Deprecated formats are not fully supported.

​Enumerated​

Displays whether the attribute is enumerated or not. An enumerated value allows you to store up to 1,000 unique values in the corresponding custom attribute. These values can then be selected from a list box. The number in parentheses is the count of enumerated values currently stored for the attribute.

Trying to add more than 1,000 values will result in an error.

​Creator​

Displays the system user who created the attribute. This information is not shown for standard attributes and older custom attributes for which the information is not available.

​Creation Date​

Displays the creation date. This information is not shown for standard attributes and older custom attributes, for which the information is not available.


Actions​


Action

Description

​Create ​

Creates a custom attribute. Custom attributes are attributes that you create for a specific Mapp Engage system. Custom attributes can store contact data that is relevant to your digital marketing needs and strategies. Custom attributes give you almost unlimited flexibility for the information you choose to store for each contact in Mapp Engage.

​Create Enumeration​

Creates an enumeration. This action is only available for custom attributes. Only a set number of defined values are stored in an enumerated attribute.

​Edit Enumeration​

Opens a window where you can add and delete values of the enumeration. This action is only available for custom attributes.

​Remove Enumeration​

Changes an enumerated attribute into an attribute that is not enumerated. This change makes it possible to save any value in this attribute. This action is only available for custom attributes. This action does not delete any values that are stored in the attribute.

​Target Attribute​

Selects an attribute to be used for the target group analysis in the message statistics. Target analysis lets you compare the success of your message with different target audiences. For example, you can see whether a message performs better with men or women.

You can select up to two attributes. The attributes must be enumerated and can contain a maximum of 10 values. You cannot select Boolean attributes. If two attributes have already been selected, remove a selection to select a different attribute. You can always include the standard attributes ​Title​ and ​Date of Birth. These attributes do not count towards the two-attribute limit.

​Remove Target Attribute​

Removes the selection. The attribute is no longer used for target group analysis.

​Edit Display Name​

Changes the display name of the profile attribute. This option is only available for Mobile Push attributes.

The values that are contained in each Mobile Push attribute include the app ID of the associated app. To identify the app further, Mapp Engage automatically adds the name of the app in the ​Display Name​ field of the attribute.

Changes to the display name do not affect the value of the attribute in Mapp Engage placeholders or back-end functions. For example, the placeholder <% ${user.CustomAttribute['appid_105388_pushsent']} %>.

​Select All​

Selects all attributes currently visible on the overview.

​Archive​

Archives the attributes that are currently selected. When you archive an attribute, you can no longer use the attribute elsewhere in Mapp Engage. The attribute is removed from all selections, automations, and personalizations where it is used. However, the attribute and the values that are stored in it are not deleted. You can reactivate archived attributes at any time.

​Export ​

Generates an export file with attribute references for the attributes that are selected currently. To export all attributes simultaneously, click ​Select All​. The export file contains standard attributes and custom attributes. The export file does not contain group attributes or member attributes.

The export file contains the following data for each attribute:

  • Attribute name
  • Attribute reference in functions syntax
  • Attribute reference in placeholder syntax
  • All values in the enumeration (for enumerated attributes)
  • Creator
  • Creation date

The system sends a notification email to the system user when the report is generated. The export file is in CSV format. You can open the file in Excel or with a text editor.

When you change the attribute that is selected for target group analysis, the target group statistics for previous messages are deleted. To retain your statistical information, export the statistics before you change the selected attributes.


Change Display Options ​


Setting

Description

​Show​

Controls whether the table displays active or archived attributes.

​Filter​

Filters the entries according to the values in the filter fields. It is possible to combine multiple filter criteria.

​Remove Filter​

Removes all filters and displays all available entries.

​Visible Rows​

Changes the number of rows that are displayed per page.

​ > >>​

Navigates to the next or previous page of results. The arrows appear when not all entries can be displayed on one page.

Related Topics​

​Profile Attributes​
​Create, Edit, or Delete Enumeration​
​Remove Custom Attribute Enumeration​
​Create Custom Attribute​