Import Contacts and Data into Mapp Engage

Overview

Mapp Engage allows you to import the following types of data:

• Contacts: Identified by email address, mobile number, or app alias.

• Contact Profile Data: Standard and custom attributes.

• Group and Member Attributes.

• Contact Preferences: Read mode and message limitations (XML only).

Key Features

• Contacts are always imported into an existing group.

• You can choose to send a confirmation message (supports confirmed and double opt-in processes).

• Imports allow adding, updating, or removing contacts and can sync data with external systems.

The video below explains the general principles of manual contact import into Mapp Engage.

Data Synchronization​

• Each contact has a single, centralized profile in Mapp Engage.

• During import:

  • Syntax of email addresses is verified.

  • Invalid or duplicate contacts can be ignored based on specific criteria:

    • Already in the group.

    • Previously unsubscribed.

    • Deactivated due to delivery failures.

• Note: Import outcomes may vary by time zone. For more information, refer to the Time Zone Behavior for Imported Data.

File Requirements​

• Formats: CSV, XML, or text files.

• File Size Limit: 50 MB for manual imports (use automation for larger files).

• Contacts must be uniquely identified using one of the following:

  • Contact ID

  • email address

  • mobile phone number

  • mobile app alias

File Formatting Guides:

• XML Format for Contact Imports.

• Quick Reference: Contact Import XML.

• CSV Format for Contact Imports.

• Quick Reference: Contact Import CSV.

Import Methods​

1. Automated Imports

• Automation Job: Schedule imports (daily/weekly).

• File Types: XML or CSV.

• Ideal for large-scale imports (up to 20 million contacts).

2. Process Control XML

• Transfers and imports via an FTP or SCP service.

• Combines operations like creating groups, importing contacts, and starting campaigns.

• Suitable for automated campaigns and large files.

3. External Identifier Imports

• Use the external identifier for contact updates.

• Prevents profile duplication while updating contact details.

4. Manual Upload

• Ideal for one-off imports under 1 million contacts.

• File Types: XML or CSV.

• Supports files up to 50 MB.

5. Adding Single Contacts

• Add individual contacts via the UI.