- Introduction
- How to Install Mailjet Extension
- Configure Mailjet Settings
- Mailjet Contacts
- Mailjet Campaigns
- Mailjet Statistics
- Troubleshooting
- Conclusion
Introduction
The Mailjet plugin for Magento 2 brings everything you love about Mailjet into the Magento dashboard, unlocking powerful email marketing tools for your eCommerce business. The natively embedded plugin allows you to get the benefit of Mailjet’s leading email builder, deliverability and analytics inside your Magento admin panel. This will help you optimize your outbound marketing and transactional email campaigns.
With the Mailjet plugin for Magento 2, you can:
- Enjoy top-notch deliverability: Improve your deliverability by using Mailjet’s SMTP relay to send your emails – no more worrying about your emails ending up in the Spam box.
- Drag-and-drop newsletter editor: Create and send a beautiful marketing campaign in only a few minutes – choose from over 30 templates or create your own.
- Identify and target prospects: Easily target your high potential customers with personalized email.
- All The Power of Mailjet: Use Mailjet to send, track and optimize your email strategy.
How to Install and Configure
The Mailjet module is available for both Magento and Magento 2.
However, the installation procedure differs slightly, so if you are using Magento, please visit our dedicated Magento user guide.
How to Install the Mailjet Extension
- Back up your database (optional) - if you want to be sure that no undesired changes
would occur. - Set up your cron jobs - https://devdocs.magento.com/guides/v2.4/config-guide/cli/config-cli-subcommands-cron.html
- Login into SSH and navigate to your store root directory
- Enable maintenance mode:
- You can upload your module’s files via FTP or with composer:
-
- FTP
-
- Download your module archive from your Magento store purchases
- Connect to your hosting server with Filezilla or another FTP client
- Navigate to your_store_root_directory/app/code
- Inside create a folder “Mailjet” and enter it
- Inside of the “Mailjet” folder create a new folder “Mailjet” and enter it
- Extract the files on your local PC
- Upload the module’s files to the opened directory on the FTP client
- Go to your CLI and download the Mailjet library
-
- Composer
-
- Update the composer.json file in your Magento project with the name of
the extension - Add the extension’s name and version to your composer.json file and
download the needed packages: - Enter your authentication keys. Your public key is your username;
your private key is your password:-
- To get them, go to Magento Marketplace > Your name > My
Profile - Click Access Keys in the Marketplace tab
- If you don’t have Access Keys click Create a New Access Key.
Enter a specific name for the keys (e.g., the name of the
developer receiving the keys) and click OK - New public and private keys are now associated with your
account that you can click to copy. Save this information or
keep the page open when working with your Magento project.
Use the Public key as your username and the Private key as
your password
- To get them, go to Magento Marketplace > Your name > My
-
- Wait for Composer to finish updating your project dependencies and
make sure there aren’t any errors
- Update the composer.json file in your Magento project with the name of
-
- FTP
-
- Verify the extension
-
- To verify that the extension installed properly, run the following command:
- By default, the extension is probably disabled:
- To verify that the extension installed properly, run the following command:
-
- Enable the extension
-
- Enable the extension and clear static view files:
- Register the extension:
- Recompile your Magento project: In Production mode, you may receive a
message to “Please rerun Magento compile command”. Magento does not
prompt you to run the compile command in Developer mode - Verify that the extension is enabled:
You should see output verifying that the extension is no longer disabled: - Clean the cache:
- Enable the extension and clear static view files:
-
- Disable maintenance mode:
- Configure the extension in Admin as needed - go to Admin panel > Stores >
Configuration > Mailjet
Note: You need to have a mailjet account to set your API settings.
Configure Mailjet Settings
-
Now you need to configure your Mailjet account in Magento 2. In the Magento 2 Admin, go to ‘Mailjet’ → ‘Configuration’.
-
In the left-side menu under ‘Mailjet’ click on ‘Account configuration’.
-
You will now need to enable the plugin and then add your Mailjet API Key and your Secret Key.
We will now describe the options available to you on the Mailjet extension configuration page:
-
Plugin Enabled - should be set to ‘Yes’. By enabling this checkbox, you are allowing Mailjet to send emails emanating from your Magento 2 environment. With Mailjet’s SMTP relay, you will have access to real-time statistics, triggered marketing events, order statuses, ROI on campaigns, optimized email deliverability and much more.
-
API Settings - You will need to enter your Mailjet API Key and Secret Key here to link your Mailjet account to Magento 2. You can find the API Key and Secret Key information in your Mailjet API Key Management page.
- Subscribed sync enabled - Specifies if Magento 2 Subscriber data is synchronized with Mailjet.
- Unsub event enabled - Automatically sync unsubscribed contacts from Mailjet to Magento 2.
- SMTP enabled - Deliver Magento 2 transactional emails through Mailjet SMTP.
Once you have entered all the information you need, click on the ‘Save Config’ button to submit the changes.
-
Configure Sender Address for Automatic Emails
To select the Sender address for your automatic Magento 2 emails, from the Configuration section choose 'General' and then go to ‘Store Email Addresses’.
You will see the different options for sender email addresses, where you can select the Sender Name and the email.
The ‘General Contact’ email will be the one used by Magento 2 to send automatic emails. In order to successfully use it, you need to have the ‘General Contact’ email verified in Mailjet. To do that, please visit the Sender domains & addresses section of your Mailjet account.
Mailjet Contacts
How to Manage Your Magento 2 Contacts
When you configure Magento 2 to send emails through Mailjet, all of your contacts will automatically be transferred to a Mailjet contact list of your choice. The list will be continuously updated when new contacts are added in Magento 2.
You are also able to configure Mailjet to automatically sync unsubscribed contacts from Mailjet to Magento 2.
How to Manage Your Mailjet Contact Lists
To send out your marketing campaigns with Mailjet, you need to use contact lists that contain the contact details of all the subscribers you want to reach. You can use these contact details to further connect with your customers with email personalization, tailoring each email sent within a campaign to make your users feel unique and important.
Here you will see a list of all the contact lists you currently have on your Mailjet account. If you have no contact lists, the area will be empty.
In this section you will 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 wish to associate with 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 will help you with personalizing emails in Mailjet, or with 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 within the Magento 2 admin, you can design beautiful marketing newsletters 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 newsletter 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 2 admin go to ‘Mailjet’ → 'Marketing' → ‘Campaigns’.
For detailed information on how to create and send your campaigns, please visit our dedicated guide.
Mailjet Statistics
To view the powerful real-time analytics of your campaigns and emails, click on the ‘Stats’ link in Magento 2.
Select the desired time range for the stats page.
By clicking on ‘Show me the reports’ you will 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 map view.
By default, all emails statuses are displayed. You can filter the results to display only one email status via the ‘Status’ drop down menu.
To export the email lists section to a text file, 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 wish to remove all the ‘bounced’ email addresses from a particular contact list, filter the results to show only ‘Bounce’, click on ‘Export to a list’ and follow the instructions.
Troubleshooting
The Magento ‘Contact Us’ page allows you to contact the Magento Customer Support for answers 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 difficulties with the Mailjet product - our team of specialists will be more than happy to assist you! Please visit the Mailjet ‘Contact Us‘ page for more information.
Conclusion
We hope you find this guide helpful. Let us know what you think of the Magento 2 integration process, or especially what functionality we should introduce next by emailing plugins@mailjet.com.
Happy Mailjetting,
Mailjet Integrations Team