Export Contact Data (window)
Navigation Path
- In the Main Navigation, click Audience > Administration.
⇒The Contact Management window opens to the Group Members tab. - In the Group drop-down list, select the group for which you want to export contact data.
⇒The Group Members window opens. - 3. Click Export.
⇒The Export Contact Data for Group window opens.
Purpose
In this window, you can export all the contacts in a group or only the members who meet specific criteria.
The data is exported in a CSV file format. This export can synchronize your contact profile data with an external system.
Related Topics
Actions
Action | Description |
|---|---|
Export | Exports the selected data as a CSV file. When the file is ready, Mapp Engage sends a notification email to the system user who started the export. To access the file, click the link in the notification email. The export is saved in the database for seven days. |
Settings
The List Type setting determines which members of the group are included in the export. Contacts are included in the export according to the selected membership status. The following options are available:
Setting | Description |
|---|---|
All Members | Exports all members of the group. |
Active Members | Exports all contacts with active member status. |
Self-subscribers | Exports all the contacts who enrolled themselves in the group (for example, via a subscription form). |
Unsubscriptions | Exports all contacts who unsubscribed from the group (for example, via an unsubscribe link). |
Deactivated | Exports all contacts with deactivated member status. Deactivated group members no longer receive the messages that are sent to the group. This status can be the result of responses. The contact is still a group member even if they are deactivated system-wide. |
Pending | Exports all contacts who have not yet accepted their invitation to become a member of the group and have the Pending or Awaiting Approval status. |
More options are displayed based on the list type you select. Select the corresponding check box to include this data in the export file. Different options are available for each list type. Some options are only available for specific list types.
Membership Data
Setting | Description |
|---|---|
Group Role | Exports the group role that is assigned to the contact in this group. |
Membership Status | Exports the current membership status of each group member. |
Subscription Date | Exports the date when each contact joined the group. With a single opt-in subscription, this date is also the date the contact was added as a member to the group. With a double opt-in subscription, this date is when the contact confirmed their membership and became an active member. |
Creation Date | Exports the date each contact was added to the group. With a single opt-in subscription, this date is the same as the subscription date. With double opt-in and confirmed subscription, this date is either when the contact was invited to join the group or the date they requested membership. With double opt-in and confirmed subscriptions, contacts are added to the group with the initial status Not Verified or Pending status and do not receive messages. The creation date cannot be used to determine when a contact became an active group member and began receiving group messages. |
Messages Received | Exports the number of messages that the contact has received as a member of the group. |
Response Category | Exports information about the kind of response that caused the contact to be deactivated within the group. |
Deactivation Date | Exports the date the contact was deactivated. |
Response Text | Exports the contents of the message that the Mapp Engage system received when a message could not be delivered to a recipient. The export can contain a maximum of 1000 characters. |
Read Mode
Setting | Description |
|---|---|
Email | Exports the preference settings for email messages. |
SMS | Exports the preference settings for SMS messages. |
Mobile Push | Exports the preference settings for the mobile push. |
Subscription Data
Setting | Description |
|---|---|
Subscription Date | Exports the date the contact joined the group. With a single opt-in subscription, this date is also the date the contact was added as a member to the group. With a double opt-in subscription, this date is when the contact confirmed their membership and became an active member. |
Source | Exports the IP address that each contact used to subscribe to the group. |
Source Address | Exports the IP address that is used for each web-based double opt-in confirmation. |
Subscription Mode | Exports the method that is used to add the contact to the group. The following methods are possible:
|
Opt-in Mode | Exports the subscription method that is used to add members to the group (single or double opt-in). |
Executor ID | Exports the ID of the system user who imported the contacts in self-subscription mode. This import method simulates the self-subscription process. In this case, although the contacts are imported, they are listed as self-subscribers. |
Unsubscription Data
Setting | Description |
|---|---|
Unsubscription Date | Exports the date the contact was unsubscribed from the group. |
Source | Exports the IP address that is used to unsubscribe from the group. |
Unsubscription Mode | Exports the method that is used to unsubscribe the contact from the group, whether by themselves or during import. |
Message ID | Exports the message ID. This information is available if the unsubscribe link that the contact clicked to unsubscribe from the group contained a Mapp Engage message ID. |
Time Period (optional)
These options limit the export to a specific date range.
Setting | Description |
|---|---|
From Date | Select a start date from the calendar. If no start date is entered, the creation date of the group is used. |
To Date | Select an end date from the calendar. If no end date is entered, the current date is used. |
Attribute Filter
These options limit the export to contacts who match specific attribute criteria. You can specify up to two attributes. Filter attributes are combined with the logical operator AND. To add a second attribute filter, click the 
symbol.
Setting | Description |
|---|---|
Yes | Enables the attribute filter. |
No | Disables the attribute filter. |
Select Attribute | Defines the profile attribute to use as filter criteria. |
Equals | Defines the value that the profile attribute must match for the contact to be included in the export. |
Standard Attributes
In this area, you specify the standard attributes to include in the export. To export all standard attribute data, use the Select All option. The following profile attributes are available in every Mapp Engage system and can be selected for export. If a contact profile does not contain data for an attribute, the field is left blank in the export file.
Setting | Description |
|---|---|
Email Address | Exports the email address of each contact. |
Mobile Number | Exports the mobile phone number of each contact. |
Mobile App Alias | Exports the mobile app alias of each contact. |
First Name | Exports first names of each contact. |
Last Name | Exports the last names of each contact. |
Preferred Name | Exports the preferred name of each contact. This name can be different than the first or last name. |
Postal Code | Exports the postal code of each contact. |
Title | Exports a numeric value representing the preferred prefix added to the name for each contact. Each value corresponds to a specific prefix, as follows:
|
Date of Birth | Exports the date of birth for each contact. |
Source ID | Exports the source ID associated with each contact. |
Source | Exports the method that is used to add each contact to the group. For example:
|
Identifier | Exports the external identifier of each contact. |
Country Code | Exports the country code for each contact. The format is the ISO 3166 standard format. For more information, see http://www.iso.org/iso/home/standards/country_codes.htm. |
Language Code | Exports the preferred language of each contact. The format is the ISO 639-1 standard format. For more information, see http://www.iso.org/iso/home/standards/language_codes.htm. |
Time Zone | Exports the time zone of each contact. |
Custom Attributes
In this area, you specify the custom attributes to include in the export. To export all custom attribute data, use the Select All option.
Member Attributes
In this area, you specify the member attributes to include in the export. Member Attributes are always group-specific. To export all member attribute data, use the Select All option. If the individual contact profile does not contain data for an attribute, the field is left blank in the export file.
Advanced Options
In this area, you can define extra settings for the export file.
Option | Description |
|---|---|
Encoding | Defines the character set used for the contact list export. |
Time Zone | Defines which time zone is used to represent the date and time of subscription and unsubscription for each contact. |
Use Contact Time Zone | Overrides the Time Zone setting. The time zone set in each contact profile determines date of subscription or unsubscription. When the time zone is not set in the contact profile, the default time zone of the group is used. |
Example:
The Time Zone attribute for contact A is set to Europe/Berlin [GMT+01:00].
Contact A and group Z both have a Time Zone setting of Europe/Berlin [GMT+01:00].
The Time Zone attribute for contact B is set to America/New_York [GMT-05:00].
Both contacts are members of a group with the default time zone set to Europe/Berlin [GMT+01:00].
Contact A unsubscribes from the group at 13:00 in Berlin.
Contact B unsubscribes from the group at precisely the same moment in New York.
Use Contact Time Zone On: The unsubscription time that is recorded for contact A is 13:00. The time that is recorded for contact B is 08:00.
Use Contact Time Zone Off: The unsubscription time that is recorded for both contacts is based on the time zone that is selected in the Time Zone drop-down list. If there is no time zone that is selected for this setting, the default time zone of the group is used. The unsubscription time that is recorded for both contacts is 13:00.