Skip to content

Magento Emarketing Configuration

Jacob edited this page Aug 17, 2015 · 2 revisions

Magento Emarketing Configuration

This page should give a good overview of all configuration settings and what they mean. You find the configurations for the extension in your Magento Admin panel under System -> Configuration -> Customers | eMarketing.


Enable eMarketing - Enable or disable the extensions cron jobs, this means if disabled the extension will not check for new recipients, send out emails, check for incoming bounces, aggregate data for reports,… etc automatically, however you can still run those task manually. Email may still get send out if task is triggered manually, see Email section for test mode.

Use Temporary Tables - This is quite a technical setting and really only makes sense for installations with 100k products and/or customers and helps to perform the filter test results quicker by telling MySQL (database) to cache nested conditions so they only run once. Enabling it can increase the filter test load time by 50%, however it will make the filter query load time useless as well as query debugging. So if you create your own filters you might want to turn this feature off as it gets in the way of debugging.

Allow filters to create indexes - Filters use database queries to retrieve the relevant results, sometimes missing database indexes can cause filters to run really slow. A warning message is shown to let you know that a filter is not running effective due to a missing database index. By enabling this feature, the index will automatically be created if it is missing. Filters implementations have to do this manually. See the Customer Address filter as an example.

Content Management

Enable WYSIWYG Editor - What you see is what you get, will use the CKEditor to give you a nice html editor that lets you do the basic HTML formation. Especially useful if you are not good with HTML or CSS. Some developers don’t like the generated HTML, and personally would encourage everyone to double check the results as well. The WYSIWYG Editor can also be disabled campaign based by disabling the design mode. If disabled, you will get a code editor for section in your email that you want to change.

Enable Syntax Highlighting - By using the ACE code editor you will get syntax highlighting and auto code completion, not just for html and css but also for magento CMS syntax (e.g. {{var $order.customer_name}}).

Google Analytics

If enabled, the extension will automatically add the utm parameters to your links. Source and Medium can be configured here. Campaign, Content and Term are generated from the link and campaign name. The guys from have a nice blog post about this.

Enable UTM Parameters - Enable/Disable the UTM parameters.

UTM Source - The value for the source parameter (e.g. magento, emarketing, magento-email,…)

UTM Medium - The medium value. Right now only used by email, this value maybe later get defined by the medium provider. I would suggest to set it as “email”.

Domain Throttling

Domain throttling allows you to prevent the extension from sending out to many emails to one domain in a to short period of time. If you have just created a new Magento store and don’t have yet many many emails you can disable this feature. Domain Throttling can get handy if you have never send out any emails before from your IP/domain, but already have a large customer base and you are about to kick off many campaigns, then you might want to warm up your domain first. This feature is only relevant if you have many active customers (e.g. 10k) and never done any email marketing.

Enable Domain Throttling - Enable/Disable domain throttling.

Time Threshold [T] - The threshold time in seconds

Send Threshold [S] - The send threshold

Rest Time [R] - The time in seconds to rest if the threshold is reached.

So if the extension is about to send more emails out then [S] defined in the given time [T] then it will wait [R] seconds before sending out an email again.

Keep in mind each email that is getting send has an expiry date defined by the campaign. If you have a really low expiry time (e.g. 30m) set by your campaign and the domain throttle is set low as well, then all emails may not make it out on time and your emails get flagged as “Expired” as the domain throttle blocked them from sending.

You can also set domain specific settings and give for instance or a higher value then the rest.


Retrieving relevant data from your subscriber can be useful for your reports. Some useful data can be extracted by the IP address, like location and timezone information. The extension will use common and free* APIs to retrieve location data from the IP (GeoIP). You can enable/disable it or define what provider to use. Many provider allow to use their service for free to a certain limit. The extension will use each adapter to balance the load of requests and make sure none of these services are abused. If you have many many requests you might need a paid solution. You can also define your own GeoIP adapter if you have your own source.

Inject Timeoffset JS - Using GeoIP is not always that exact. You can use JavaScript to extract the users timezone offset. This works by adding once a little Javascript code to your HTML (before_body_end) that sets a cookie with the time offset. Of cause this will only work if the user clicks on a link to your Magento store.

Use GeoIP - Disable/Enable the GeoIP adapters. If disabled then location reports (e.g by country or state) will not work.

GeoIP Adapters - The adapters to use to retrieve geo information for the collected IPs.

Note: There is no guarantee about the correctness of the data provided by those adapters. Proxy, Caches (e.g. Google Caches) may distort the results. They can give you a rough idea about the Geo data, especially if you have many data sets but will not be a 100% accurate.


Enable Autologin - If enabled the user will be automatically logged in to their account when clicking a link to your store. This can be useful for campaigns like abandon shopping carts etc. Obviously this will only login the customer if the email recipient has a customer defined.

Expire - The time in hours after the email was send before the auto-login expires, once the expire-time has past the link will still work, however the user will not get logged in anymore.

Inbox / Bounce Message

See "Handling email bounces & replies" to find out more about this.


Remove HTML/CSS comments - Clean up your code by remove all HTML and CSS comments from your emails before sending them out.

Enable CSS Inliner - Inline all your CSS. This will parse your CSS and HTML and inline the CSS defined in your template into your HTML code automatically. This allows you to code clean HTML and still be able to view your emails later correctly on devices only supporting Inline-CSS.

Test Mode - In test mode no emails will get send to their original intended recipient, but instead send to the email address defined in “Test Mode Address”.

Test Mode Address - The email address all emails get send to if “Test Mode” is enabled.

Enable List Unsubscribe - Set the unsubscribe header. Some newer email clients and some email provider check for those headers to let people easily unsubscribe from your emails instead of flagging them as spam and harming your reputation.

List Unsubscribe (mailto:) - List Unsubscribe works by either calling a link or by sending an unsubscribe email to a specified email address. If you enter here the email address from your “Inbox / Bounce Message” section, then the extension will automatically look out for those emails and unsubscribe your users.

Email Transporter - You can define a transporter for your emails.

  • Sendmail is the default php internal transporter.
  • SMTP lets you choose any smtp server to send out your emails. This works great for email providers like SendGrid or Mandrill as well as email testing environments like mailtrap.
  • File System is only used for testing and debugging locally. All emails are saved locally in /var/mzax.

Of cause you can also create your own email transporters.