Maropost: Import Audiences & Activity Data
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 customer 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 job will:
- Initially import all contacts in the selected Maropost lists through the contacts endpoint.
- Import activity for the configured number of days is imported via the reports API for each event type: opens, bounces, clicks, unsubscribes, and complaints.
- 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 Field | Lytics User Field | Description | Type |
|---|---|---|---|
| account_id | ma_account_id | Maropost Account ID | string |
| list, list_status | ma_list_status | Maropost List Status | map[string]value |
| id | ma_id | Maropost ID | string |
email unique id | string | ||
| first_name | first_name | First Name | string |
| last_name | last_name | Last Name | string |
| phone | phone | Phone | string |
| fax | fax | Fax | string |
The following activity fields are included in the default mapping of the maropost_users stream:
| Source Field | Lytics User Field | Description | Type |
|---|---|---|---|
email unique id | string | ||
| id | ma_id | Maropost ID | string |
| last_active_ts | Last Active on Any Channel | date | |
| browser | ma_browser | Browser | string |
| campaign_id | ma_campaign_id | Maropost Last Active Campaign | string |
| campaign_id | ma_campaign_ids | Maropost Campaigns | []string |
| campaign_tags | ma_campaign_tags | Maropost Campaign Tags | []string |
| url | ma_email_urls | Maropost URLs | []string |
| url | hashedurls | Hashed Urls Visited | map[string]intsum |
| account_id | ma_account_id | Maropost Account ID | string |
| ma_lastopen_ts | Maropost Last Open | date | |
| ma_firstopen_ts | Maropost First Open | date | |
| event | ma_openct | Maropost Open Count | int |
| ma_lastclick_ts | Maropost Last Click | date | |
| ma_firstclick_ts | Maropost First Click | date | |
| event | ma_clickct | Maropost Click Count | int |
| ma_lastbounce_ts | Maropost Last Bounce | date | |
| ma_firstbounce_ts | Maropost First Bounce | date | |
| event | ma_bouncect | Maropost Bounce Count | int |
| email_monthly | Email opens By Month | map[string]intsum | |
| email_hourofweek | Email Hour of Week Events | map[string]intsum | |
| email_hourlyopen | Email Hourly Events | map[string]intsum |
Configuration
Follow these steps to set up and configure an import of user and email activity into Lytics. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.
- Select Maropost from the list of providers.
- Select the Import Audiences & Activity Data job type from the list.
- Select the Authorization you would like to use or create a new one.
- Enter a Label to identify this job you are creating in Lytics.
- (Optional) Enter a Description for further context on your job.
- 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.
- 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.
- Click Start Import.
