Navigation Path​

  1. In the ​Main Navigation​, click ​Contacts​ > ​Administration​.
    ⇒The ​Contact Management​ window opens to the ​Group Members​ tab.
  2. In the ​Group​ drop-down list, select the group for which you want to export contact data.
    ⇒The ​Group Members​ window opens.
  3. 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. You can use this export to 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 that 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 enroled 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 member of the group even if they are deactivated system-wide.

​Pending​

Exports all contacts who have not yet acMapp Engageted 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 single opt-in subscription, this date is also the date the contact was added as a member to the group. With 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 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 member of the group and began to receive 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 which 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 which 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 mobile push.


Subscription Data

Setting

Description

​ Subscription Date​

Exports the date the contact joined the group. With single opt-in subscription, this date is also the date the contact was added as a member to the group. With 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:

  • ​Self​ - The contact enroled himself in the group.
  • ​Added​ - The contact was added or imported into the group by someone else.

​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 which 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 that represents the preferred prefix added to the name for each contact. Each value corresponds to a specific prefix, as follows:

  • 1: Mr.
  • 2: Ms.
  • -1: No data

​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: added, imported, or unknown.

​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.