- 3 Minutes to read
- Print
- DarkLight
Create Group Attributes
- 3 Minutes to read
- Print
- DarkLight
Goal
To create a group attribute
Prerequisite
The group for which the attribute is created exists in Mapp Engage.
Background Information
Group attributes are identical for all members of a group. You can create group attributes manually on the Mapp Engage interface, or during data import.
Procedure
To Manually Create a Group Attribute on the Mapp Engage Interface
In the Main Navigation, click Audience > Group Management > Groups.
Click Group Attributes next to the group for which you want to create a group attribute.
⇒ The Group Attributes window opens.Click New Group Attribute.
⇒ The Create New Group Attribute window opens.In the Group Attribute Name field, enter the name of the new attribute. The maximum name length is 80 characters. The name is not case-sensitive. To avoid processing issues, do not use not empty spaces or special characters in the attribute name.
In the Group Attribute Value field, enter the value of the group attribute. This value is identical for all members of the group. The maximum length that you can store in a group attribute is 2000 characters.
To create the group attribute, click Create Group Attribute.
⇒ The Group Attributes window opens and the newly created attribute displays.
The attribute value is valid for all members of the group and can be used for sendout to this group.
To Create a Group Attribute with an XML or CSV File Import
In the Main Navigation, click Audience > Group Management > Groups.
Click Group Attributes next to the group for which you want to create a group attribute.
⇒ The Group Attributes window opens.Click Import Group Attribute
⇒ The Group Attribute Import window opens.Choose the CSV or XML file that contains the attributes you want to import.
For more information, see XML Format for Group Attribute Imports.
In CSV files, use the attribute referencegroup.CustomAttribute['name']
to create your group attributes.From the File Type drop-down list, define whether the file that is imported is a CSV or XML file.
From the Character set of File drop-down list, select the character set in which the file is saved.
Mapp Engage cannot recognize the character set of a file automatically. If you define the wrong character set, the imported data can display incorrectly. Definition of an incorrect character set can cause loss of data on your system.
From the Synchronization Mode drop-down list, select the mode Mapp Engage uses to add the new attributes:
Add: Adds new data only. Group attributes that existed in the system previously remain unchanged. No data is overwritten.
Update: Updates group attributes that exist in the system. Does not add any new attributes. Data can be overwritten.
Add and Update: Adds new attributes and updates group attributes that exist in the system.
Replace: Deletes the group attributes that currently exist in the group and adds the attributes that Mapp Engage imports.
Delete: Removes group attributes from the group that correspond to the import file. Attributes in the group that are not imported remain unchanged.When you import a CSV file, you can define the separator that Mapp Engage uses to divide the individual data sets in the file. The default separator character is a comma.
To begin your import, click Upload.
⇒ The Import Group Attributes window closes. Mapp Engage sends status messages that contain information about the progress of the import. When the import finishes, you receive an email with detailed information about the import.
Create a Group Attribute During Import of an XML File
Choose the XML file with which you would like to import recipients and define group attributes.
For a general description of the necessary structure of this XML file, see XML Format for Contact Imports.
The structure for group import is located here: XML Format for Group Attribute Imports.
- or -
Create an XML file for structuring group attributes (see XML Format for Group Attribute Imports).
Import the data manually (see Import Contacts), or schedule an automatic file import (see Automation).
The attribute value is valid for all members of the group and can be used for sendout to this group.
Create a Group Attribute During Import of a CSV File.
For a general description of the necessary structure of this CSV file, please see CSV Format for Contact Imports.
In the first line, the head of the data set, define which attribute is created and filled with data.
Tag the group attribute with "group.CustomAttribute['name'
]".Replace 'name' with the name under which the new group attribute is stored in the system.
Import the data manually or schedule an automatic import of the file. For more information, see Import Contacts and Automation.
The maximum number of new group attributes in the file import is 1000.