Documentation / Product / Integrations / Maropost

Maropost: Import Users & Email Activity

Importing Maropost users and activity into Lytics results in new or updated user profiles. Once imported, Lytics can use this Maropost data to inform our machine learning based enrichments, and this data enables you to improve audience targeting for your cross-channel Journeys orchestrated by Lytics.

Integration Details

  • Implementation Type: Server-side.
  • Implementation Technique: REST API.
  • Frequency: Contacts are batch imported daily, on a continuous basis. Activity data is batch imported hourly.
  • Resulting Data: Full user profiles for all Maropost contacts in the selected lists. Activity data related to marketing campaigns will be collected as additional user fields.

This integration utilizes the Maropost APIs to receive contact data. The workflow will:

  1. Initially import all contacts in the selected Maropost lists through the contacts endpoint.
  2. Import activity for the configured number of days is imported via the reports API for each event type: opens, bounces, clicks, unsubscribes, and complaints.
  3. After the initial import, contacts are checked daily at midnight PST and only updated contacts are imported. New activity is imported every hour.

Fields

The following user fields are included in the default mapping of the maropost_users stream:

Source FieldLytics User FieldDescriptionType
account_idma_account_idMaropost Account IDstring
list, list_statusma_list_statusMaropost List Statusmap[string]value
idma_idMaropost IDstring
emailemail unique idEmailstring
first_namefirst_nameFirst Namestring
last_namelast_nameLast Namestring
phonephonePhonestring
faxfaxFaxstring

The following activity fields are included in the default mapping of the maropost_users stream:

Source FieldLytics User FieldDescriptionType
emailemail unique idEmailstring
idma_idMaropost IDstring
last_active_tsLast Active on Any Channeldate
browserma_browserBrowserstring
campaign_idma_campaign_idMaropost Last Active Campaignstring
campaign_idma_campaign_idsMaropost Campaigns[]string
campaign_tagsma_campaign_tagsMaropost Campaign Tags[]string
urlma_email_urlsMaropost URLs[]string
urlhashedurlsHashed Urls Visitedmap[string]intsum
account_idma_account_idMaropost Account IDstring
ma_lastopen_tsMaropost Last Opendate
ma_firstopen_tsMaropost First Opendate
eventma_openctMaropost Open Countint
ma_lastclick_tsMaropost Last Clickdate
ma_firstclick_tsMaropost First Clickdate
eventma_clickctMaropost Click Countint
ma_lastbounce_tsMaropost Last Bouncedate
ma_firstbounce_tsMaropost First Bouncedate
eventma_bouncectMaropost Bounce Countint
email_monthlyEmail opens By Monthmap[string]intsum
email_hourofweekEmail Hour of Week Eventsmap[string]intsum
email_hourlyopenEmail Hourly Eventsmap[string]intsum

Configuration

Follow these steps to set up and configure an import of user and email activity into Lytics.

  1. Navigate to the Integrations page and select the Maropost tile. Maropost tile
  2. Select Workflows from the menu on the left.
  3. Select Import Users & Email Activity from the list of workflows.
  4. To configure the import, select the Maropost Lists that you want to import user data from. Activity data from the past 180 days will be imported. To only import user data, uncheck Activity.Screen Shot 2018-11-30 at 13 18 26
  5. This import will run continuously by default. If you would like to do a one-time import, uncheck Keep Updated in the Advanced Options section.
  6. Click Start Import to begin the workflow.