The Mailcampaigns connector allows you to synchronize data between Spotler Activate and the Email Service Provider (ESP) MailCampaigns. Audiences, profiles, triggers and product sets from Spotler Activate can be sent to MailCampaigns via the connector.
By completing the full implementation, email addresses and consent are synchronized once between MailCampaigns and Spotler Activate. In addition, profile fields are synchronized from Spotler Activate to MailCampaigns. After establishing the connection, the following data is synchronized:
- Email addresses: new email addresses are synchronized in real time from Spotler Activate to MailCampaigns.
- Consent: changes to consent are synchronized in real time from Spotler Activate to MailCampaigns and daily from MailCampaigns to Spotler Activate.
- Profile fields: with each API call, the profile fields are sent from Spotler Activate and stored in MailCampaigns.
Activate the Mailcampaigns connector
Implementing MailCampaigns consists of establishing the MailCampaigns connection, synchronizing profiles to MailCampaigns and synchronizing consent to MailCampaigns.
Step 1: Establishing the MailCampaigns connection
Login to MailCampaigns and go to ‘Integrations › Software links › Spotler Activate’. If this Software link is not in your overview, you can contact the MailCampaigns team. They will then prepare the necessary so that the link can be made. Copy the values ‘OAuth Client ID’ and ‘OAuth Client Secret’.
Go to the Apps page in Spotler Activate and click on the MailCampaigns connector. Paste the copied values into the ‘OAuth Client ID’ and ‘OAuth Client Secret’ fields.
Next, the Spotler Activate API settings must also be added to MailCampaigns. Go to Settings in Spotler Activate. Copy the values ‘Account ID’ and ‘API key’. Go to ‘Integrations › Software links › Spotler Activate’ in MailCampaigns. Paste the copied values in the fields ‘Spotler Activate Account ID’ and ‘Spotler Activate API key’.
When the connection is completed, it still needs to be set up on the Mailcampaigns side. In MailCampaigns, go to ‘Integrations › Software connections › Spotler Activate. Go to ‘Link contact fields’. To be able to import contacts from Spotler Activate to MailCampaigns, the contact fields need to be linked to the fields in Spotler Activate. Map the fields. Go to ‘Link content fields’. To be able to import products from Spotler Activate to MailCampaigns, the content fields need to be linked to the fields in Spotler Activate. Map the fields.
Step 2: Synchronizing profiles to MailCampaigns
To synchronize (new) profiles from Spotler Activate to Mailcampaigns in real time, you need to create an Advanced Audience with the following rules:
(New) profiles that leave their email address are synchronized to MailCampaigns in real time.
Step 3: Synchronizing consent to MailCampaigns
To synchronize consent from Spotler Activate to MailCampaigns in real time, the following is required:
Create an Advanced audience with the following rules:
The profiles with email address and newsletter consent are synchronized to Mailcampaigns. To synchronize service consent, the above can be repeated with permission = Email - service messages
Audiences & Profiles
In the Audience Builder, you can send audiences to MailCampaigns by checking MailCampaigns as Channel:
For the profiles in the audience, Spotler Activate sends two API calls to MailCampaigns:
- Contacts: with this API call, the profile fields of the profile are sent to MailCampaigns and stored in MailCampaigns.
- Contact Groups: with this API call, the audiences are sent to MailCampaigns.
Triggers & Productsets
In the Journey Builder you can send triggers to MailCampaigns with the Email trigger. In the Email trigger you can set the following:
- Trigger name: the name you give to identify the trigger
- Trigger: the campaign that is triggered in MailCampaigns
- Products: the product set that is sent with the trigger. Please note: For the standard product sets of Spotler Activate, the language of the account is leading for the language of the product set in MailCampaigns.
For the profiles that reach the Email trigger and meet the conditions, Spotler Activate sends an API Call to MailCampaigns:
- Spotler Activate Trigger: with this API call a trigger is sent for the profile and possibly the product set of the profile is sent along.