Introduction

The Mailjet Magento extension provides complete control of your Magento Email service using Mailjet. It not only replaces your

default Magento transactional SMTP service, but is also a fullstack email marketing solution for your Magento w ebsite. The

natively embedded plugin allow s you to get the benefit of Mailjet's leading email design, deliverability and tracking inside your

Magento admin. This w ill help you optimize your outbound marketing and transactional email campaigns.

Mailjet has extensive reporting tools and advanced statistics available to help you monitor and optimize your emails.

Mailjet Settings

1. Now you need to configure your Mailjet account in Magento. In the Magento Admin, go to 'System' → 'Configuration'.

IMPORTANT: Since Magento is a multi-store service, you are able to administer several stores from your Magento admin

page. Whenever you configure your Mailjet settings, if you have selected 'Default Config' from the 'Current Configuration

Scope' menu, the settings you choose w ill be saved as default ones. How ever, if you choose a certain store instead, they

w ill only be valid for the store you have selected at the time .

2. In the left-side menu under 'Mailjet' click on 'Settings'.

3. You w ill see the Mailjet extension configuration page. We w ill now describe the options available for you here.

Enabled - should be set to 'Yes'. By enabling this checkbox, you are allow ing Mailjet to send all of the emails emanating

from your Magento environment (transactional emails and marketing campaigns). With Mailjet’s SMTP relay, you w ill have

access to real-time statistics, triggered marketing events, order statuses, ROI on campaigns, optimized email

deliverability and much more.

Send test mail now - you can use this option to test your Mailjet configuration. Simply select 'Yes', and once you save

your new settings, an automatic email w ill be sent to the email address you have specif ied. The sender address for the

test email w ill be the one you have selected for sending automatic emails from Magento - the "General Contact" email.

For more information see the next section of the guide ("Configure Sender Address for Automatic Emails").

Recipient of test mail - this is the email address w here you w ill receive your test email.

API Settings - You w ill need to enter your Mailjet API Key and Secret Key here to link your Mailjet account to

Magento. You can f ind the API Key and Secret Key information in your Mailjet API Key Management page.

NOTE: If you do not have a Mailjet account, please create one now by clicking on ‘Create your Mailjet account’ button on the

API Settings section, or go directly to the Mailjet Signup page.

Once you have entered all the information you need, click on the 'Save Config' button to submit the changes. If you have

opted to receive a test email, it w ill be sent as soon as you click on 'Save Config'.

Configure Sender Address for Automatic Emails

To select the Sender address for your automatic Magento emails, from the Configuration section go to 'Store Email Addresses'.

You w ill see the different options for sender email addresses, w here you can select the email and the Sender Name.

The 'General Contact' email w ill be the one used by Magento to send automatic emails. In order to successfully use it, you needto have the 'General Contact' email verified in Mailjet. To do that, please visit the Sender domains & addresses section of

your Mailjet account.

Event Tracking

Event Callback (or Tracking) simply means w henever there is an event, an event is dispatched to the provided Endpoint URL,

containing meaningful context about the event (like the recipient email, timestamp, etc). From here, the customer can script actions

to be done follow ing it.

NOTE: Mailjet allow s you to track each event from one URL at a time, so it w ill not be possible to track a Click event simultaneously

from Zapier and a custom URL, for example.

In case you w ant to track certain events in Magento automatically, you can use the Endpoint URL displayed at the top of the Mailjet

'Settings' section.

To track the events you w ant you need to f irst copy the displayed link, then go to the 'Event Tracking' section of your Mailjet

account.

Let’s look at the ‘Unsub’ event. In this case, w hen a recipient unsubscribes from your new sletter (the event), that information is

pushed to Magento and that recipient’s profile is automatically updated (the action). The steps you need to follow are:

1. Tick the checkbox next to the 'Unsub' event.

2. Paste the URL you copied earlier in the 'Endpoint URL' box.

3. Click on 'Send' to test the URL. If the test is successful, you w ill see a ‘OK, Code 200’ response.

4. Click on 'Save' to submit the changes.

Congratulations - you have successfully configured your Mailjet Extension!

NOTE: Once your configuration is saved, your Mailjet account w ill be linked to Magento. Your Magento customer contacts w ill be

automatically transferred to a new Mailjet Contact List, along w ith the contact properties configured there.

Mailjet Contacts

How to Manage Your Magento Contacts

When you configure Magento to send emails through Mailjet, all of your contacts w ill automatically be transferred to a Mailjet

contact list called '1_magento_customers_master_list'. The list w ill be continuously updated w hen new contacts are added in

Magento.

You are also able to configure Mailjet to automatically update your contact list w henever a Magento contact unsubscribes from

your mailing lists. To do that, please check our section on Event Tracking.

How to Manage Your Mailjet Contact Lists

To send out your marketing campaigns w ith Mailjet, you need to use contact lists that contain the contact details of all the

subscribers you w ant to reach. You can use these contact details to further connect w ith your customers w ith email

personalization, tailoring each email sent w ithin a campaign to make your users feel unique and important.

Here you w ill see a list of all the contact lists you currently have on your Mailjet account. If any contacts w ere automatically

migrated, you w ill also see a new ly created contact list. If you have no contact lists, the area w ill be empty.

In this section you w ill be able to create, edit, duplicate, archive and delete your contact lists. You can also create new contact

properties, or add emails to your Campaign Exclusion List.

For detailed information please visit our dedicated guide on Managing your contact lists.

Contact Properties

To store details about your subscribers (name, age, city, …) in your Mailjet contact list, you need to define/create the different

contact properties you w ish to associate w ith your Mailjet contacts. Once defined, you can then import your contact list details

and map them to the relevant contact properties on the Mailjet side.

The inclusion of additional details regarding your subscribers w ill help you w ith personalizing emails in Mailjet, or w ith

segmentation of the contact list for marketing campaigns, for example.

For more information on how to manage the properties, please visit the Contact Properties section of our guide on Managing

Contact Lists.

Mailjet Campaigns

From w ithin the Magento admin, you can design beautiful marketing new sletters using Mailjet’s drag-and-drop HTML email builder,

or pick from a gallery of templates. With one easy click, you can also turn your new sletter design into a template for future use. In

addition, you have the option to import already created templates by pasting the HTML code in our HTML editor.

To access the Mailjet Campaigns section, in the Magento admin go to 'Mailjet' → 'Campaigns'.

For detailed information on how to create and send your campaigns, please visit our dedicated guide.

Mailjet Statistics

To view the pow erful real-time analytics of your campaigns and emails, click on the ‘Stats’ link in Magento.

By default, the stats are show n for all sender addresses across all domains, and for both campaigns & transactional emails. To

view the stats for a particular domain, sender address or email type, simply select the appropriate drop-dow n menu.

Select the desired time range for the stats page.

By clicking on ‘Show me the reports’ you w ill be able to see information on each of the recipients of the campaign:

In addition to the Email List view (default), you can view the Open Analytics and the Click Analytics in a list view or via a mapview .

By default, all emails statuses are displayed. You can f ilter the results to display only one email status via the ‘Status’ drop dow n

menu.

To export the email lists section to a text f ile, click on the 'Download all as CSV' button.

To update a contact list based on the results, click on 'Export to a list'. For example, if you w ish to remove all the ‘bounced’ email

addresses from a particular contact list, f ilter the results to show only ‘Bounce’, click on 'Export to a list' and follow the

instructions.

Troubleshooting

The Magento 'Contact Us' page allow s you to contact the Magento Customer Support for answ ers to questions about extension

functionalities and common issues.

Of course, feel free to contact our Customer Support team, in case you come across any technical dif f iculties w ith the Mailjet

product - our team of specialists w ill be more than happy to assist you! Please visit the Mailjet 'Contact Us' page for more

information.

Conclusion

We hope you f ind this guide helpful. Let us know w hat you think of the Magento integration process, or especially w hat

functionality w e should introduce next by emailing plugins@mailjet.com.

Happy Mailjetting,

Mailjet Integrations Team