An attribute reference is the syntax of an attribute in Mapp Engage. This syntax is the form of the attribute that Mapp Engage recognizes and can use to process the attribute information.


Use the attribute reference in the following situations:

  • When you create personalized messages.
  • When you import contact data and profile data into Mapp Engage with a CSV or XML file.
  • When you create Mapp Engage functions.

This topic provides an overview of the following attribute references:

  • Standard Attributes
  • Custom Attributes​
  • Group Attributes​
  • Member Attributes​
  • Placeholders for Other Information​

Standard Attributes​

In individually configured systems, standard attributes can be used to store different values from the ones that are listed here. Usually, however, the attributes are filled with the following values.

To create personalization placeholders: To insert information directly into a message, the entire expression is placed within the placeholder characters <% .... %>. These characters tell the system to replace everything within these characters with the respective data or information that is expressed within. This process takes place during sendout. You can preview resolved personalizations in the ​Message Preview​ window.


Name

Attribute Reference

Personalization Placeholder

Data Stored in the Attribute

​Email Address

${user['Email']}

<%${user['Email']}%>

Email address of the contact.

​Mobile Number

${user['MobileNumber']}

<%${user['MobileNumber']}%>

Mobile number of the contact.

The mobile number must include the area code. It can include a plus sign (+) before the number.

​Mobile App Alias​

${user['FaxNumber']}

<%${user['AppAlias']}%>

Mobile app alias of the contact.

First Name

${user['FirstName']}

<%${user['FirstName']}%>

First name of the contact

​Last Name

${user['LastName']}

<%${user['LastName']}%>

Last name of the contact.

Title​

${user['Title']}

<%${user['Title']}%>

Defines the prefix added to the name of the contact. The attribute value is stored in the system as a number.

  • Mr. - The attribute value is stored as the number 1.
  • Ms. - The attribute value is stored as the number 2.
    If a value is not specified, the attribute value is stored as -1.

Do not use a placeholder to insert the ​Title​ attribute into a message. The number is inserted into the text of your message.

​Date of Birth​

${user['DateOfBirth']}

<%${user['DateOfBirth']}%>

The date of birth of the contact.

Example: 1965-04-16

Source ID

${user['PartnerId']}

<%${user['PartnerId']}%>

ID which identifies the source of the contact (for example, from specific pages or actions).

​Identifier​

${user['Identifier']}

<%${user['Identifier']}%>

External identifier (for example, from a CRM system).

In the contact profile, the ​Identifier​ attribute stores an external identifier in the Mapp Engage system. This ID can be an ID used in an external CRM system.

The maximum length of the external identifier is 20 characters.

​Country

${user['ISOCountryCode']}

<%${user['ISOCountryCode']}%>

The home country of the contact.

The format is the standardized ISO country format (for example, FR for France, EN for England).

Language​

${user['ISOLanguageCode']}

<%${user['ISOLanguageCode']}%>

Language of the recipient.

The format is the standardized ISO language format (for example, fr for French, en for English).

Postal Code​

${user['ZipCode']}

<%${user['ZipCode']}%>

Postal code of the contact.

Preferred Name

${user['Nickname']}

<%${user['Nickname']}%>

The preferred name of the contact.

​Origin​

${user['Source']}

<%${user['Source']}%>

This attribute stores the origin of the contact.

Mapp Engage fills this attribute automatically when the contact is created in the system.

The following values ​​are possible:

  • ​Import​ - The contact was created by a data import (CSV, XML or text).
  • Add​ - The contact was created in the system manually.
  • Web​ - The contact subscribed from a landing page.
  • Mail​ - The contact subscribed via email. This function is configured in the group settings.
  • SMS​ - The contact subscribed via inbound SMS.
  • Unknown​ - The origin of the contact is not known.
  • Forward​ - The contact was created with a forwarded message.
  • Preview​ - The contact was added as a test recipient in a group.
  • SOAP​ - The contact was added by an API call.
Gender${user[‘Gender’]}<%${user[‘Gender’]}%>

This attribute stores the gender of the contact.

  • If a value is not specified, the attribute value is stored as 0. This is shown as 'unset' in Mapp Engage.
  • Male - The attribute value is stored as the number 1.
  • Female - The attribute value is stored as the number 2.
  • Undisclosed - The attribute value is stored as the number 3


Custom Attributes​

A custom attribute is a property field that stores data about a contact. This type of attribute is created specifically for your system. Custom attributes are specific to your system, and do not come standard with Mapp Engage. You can create custom attributes to store contact that is relevant to your digital marketing needs and strategies.

You can view the name of the profile attributes in your system in the ​Administration​ area.

The attribute reference has the following format: ${user.CustomAttribute['Name']}.

The corresponding personalization placeholder has the following format: <%${user.CustomAttribute['Name']}%>.

Example

An attribute with the name LastPurchase has the following reference: ${user.CustomAttribute['LastPurchase']}.

To insert the attribute value directly in a message, use the placeholder <%${user.CustomAttribute['LastPurchase']}%>.

Group Attributes​

A group attribute stores one value for all members of a group. The value is identical for all group members.

You can view the name and values of the group attributes in each group in the ​Groups​ area.

You can create group attributes in the Mapp Engage interface in the ​Groups​ area or with an import file.

The attribute reference has the following format: ${group.CustomAttribute['Name']}.

The corresponding personalization placeholder has the following format: <%${group.CustomAttribute['Name']}%>.

Example

An attribute with the name TravelDestination has the following reference: ${group.CustomAttribute['TravelDestination']}.

To insert the attribute value directly in a message, use the placeholder <%${group.CustomAttribute['TravelDestination']}%>.

Member Attributes​

Member attributes let you save different information for the same contact in different groups.

You can only create member attributes with import of an XML or CSV file. You cannot create member attributes manually on the Mapp Engage interface.

You can view member attributes in the contact profile, but only when you access the contact through the ​Memberships​ tab in the ​Contact Management​ area.

The attribute reference has the following format: ${user.MemberAttribute['Name']}.

The corresponding personalization placeholder has the following format: <%${user.MemberAttribute['Name']}%>.

Example

An attribute with the name LastPurchase has the following reference: ${user.MemberAttribute['LastPurchase']}.

To insert the attribute value directly in a message, use the placeholder <%${user.MemberAttribute['LastPurchase']}%>.

Placeholders for Other Information​


Tag

Description

<%${member['CreationDate']}%>

The date when the contact subscribed to the group or was added to the group.

The creation date has the following format: yyyy-mm-dd hh:mm:ss:ms.

<%${member['MessageCounter']}%>

The cumulative number of the messages which have been sent from the selected group to the contact.

<%${group['name']}%>

Name of the group.

<%${group['Email']}%>

Email address of the group.

<%${group['NoOfMembers']}%>

Current number of active members of the group.

<%${message['RecipientCount']}%>

Number of recipients who were sent a message that contained the placeholder.

<%${message['Forwarded']}%>

This attribute contains a Boolean value.

  • False​ - The message was sent in a normal sendout.
  • True ​ - The message was forwarded with a Mapp Engage forward message form.

<%${user['EmailDomain']}%>

The domain of the email address of the contact.

The email domain is the part of the address after the @ sign.

Related Topics​