Update Attributes of App Contacts

Prev Next

Goal

Set up ongoing automation to import contact information collected by your app into Mapp Engage.


Prerequisites

  • An Engage FTP server must be set up.

  • Share the FTP server details with Mapp.


Background Information

Each app integrated with Mapp Engage provides data stored in different files. To ensure this data is continuously imported into the profile attributes of your contacts, an individual automation must be created for each app. Once set up, the automation runs continuously, keeping contact information up to date.


Procedure

  1. Create a Time-Based Trigger

    • Go to the Time Module and create a time-based automation.

    • Set the following values:

      • Date: Recurring Date

      • Period: Hour(s)

      • Value: 1

      • Time: 00:30:00

    • Note: The file is uploaded at the top of the hour. Ensure the automation runs after the upload is complete.

  2. Configure Automation Settings

    • Go to the Job section and choose Import Contacts.

    • Set the Import Mode to Update current members.

    • Enable the override attributes-only option.

  3. Specify the System and File Settings

    • System Name: Select the Engage system used for your email sendouts. If multiple domains are available, choose the correct one from the list.

    • Encoding: Select UTF-8.

    • Source File:

      • File name pattern: *.csv.gz

      • File type: CSV

      • File location: Provide the FTP address in the format
        protocol://user:password@host.port/url-path
        Example: ftp://joesample:1password@ftp.mapp.com/import

    • Group Email: Define the group where the app contacts are saved.

  4. Add Import Parameters

    • Include a parameter to unzip the file: source-compression gzip.

  5. Special Considerations for Parallel Import

    • When the parallel import feature is enabled, create a separate automation for each file:

      • *_LTAPPIDGT_lastactivation.csv.gz

      • *_LTAPPIDGT_lastpurchase.csv.gz

      • *_LTAPPIDGT_profileupdate.csv.gz

    • If you use custom fields, create one automation per custom field file.