- 4 Minutes to read
- Print
- DarkLight
Attribute References
- 4 Minutes to read
- Print
- DarkLight
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 store different values from those listed here. Usually, however, the attributes are filled with the following values.
To create personalization placeholders: To insert information directly into a message, the 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.
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:
|
Gender | ${user[‘Gender’]} | <%${user[‘Gender’]}%> | This attribute stores the gender of the contact.
|
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 and does not come standard with Mapp Engage. You can create custom attributes to store contacts 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 named 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 group members, which is identical.
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 named 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 various groups.
You can only create member attributes by importing 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 named 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. The creation date has the following format: yyyy-mm-dd hh:mm:ss:ms. |
<%${member['MessageCounter']}%> | The cumulative number of messages 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.
|
<%${user['EmailDomain']}%> | The domain of the email address of the contact. The email domain is the part of the address after the @ sign. |