Campaigns

Creating campaigns

General

To create a new campaign go to Menu > Campaigns > New campaign

For tips about each option point your mouse over .

• Use different sender settings
  First you select a sender profile. Optionally you can define the <From-name>, <From-email> and <Reply-to-email> values just for this campaign.
  • The custom sender settings (at campaign or autoresponder level) will override the the sender profile settings.
  • Some SMTP servers may not accept these custom values and instead use the actual <From-name> and <From-email> used for SMTP authentication.
• Filters
  This option is available when sending a campaign to “all lists” or “selected lists”.
• Subscriber tags
  This adds another layer of segmentation. It has the same effect as using a filter.
• Subscribers who confirmed
  This option is available when sending a campaign to “all lists” or “selected lists”. A subscriber has a confirmed/verified status at list level. If the subscriber is confirmed for at least one list (but perhaps not in others) then he will receive the email.
• Campaign & Autoresponder tags
  You can use tags to group/categorise your campaigns.
• Disable tracking for this campaign
  Clicks & views will not be recorded.
• Anonymous tracking
  With anonymous tracking you will see Total but not Unique ratios. Only total clicks per link are reported.
  Emails clients and Geolocation reports are not affected.
  Bounces, Complaints and Opt-outs will work normally.
  Triggers will not fire.
• Excluding lists from campaigns
  Since nuevoMailer v.8.6 you have a new option: This option is available when you choose "All lists" or "Selected lists".
  Looking at the example picture above it means, that if a subscriber belongs both to list 35 (or 8) but also to list 2 then he will not be part of the campaign.
  In other words, the campaign will target subscribers who belong to lists 35 and/or 8 but if some of them belong also in 2 they will be excluded.
  Prior to v.8.6 this was done by using filters.

Multipart content

When you send both an html and a text newsletter at the same time then you are sending a multipart newsletter.

• If a recipient’s email client cannot display html it will display the text version. Both parts will be personalized and tracking links will apply.
• There is absolutely no compromise with this method. But there is a downside: too large size of an email since in essence you are sending a double-sized email per subscriber. And in fact you must prepare two newsletters for each campaign.
• A trick that may save you time is to prepare the html one and then automatically create a text version of it.
• If you have subscribers that are likely to use old email clients that cannot read html, sending multipart emails ensures that they will eventually be able to read your newsletter.
• Tests have indicated that a multipart newsletter is treated better by spam filtering engines.

A very effective trick
The idea is to make a multipart campaign where in the text newsletter you have a smart link to redirect the subscriber to read the html newsletter in the browser.
The following picture explains this idea better. You can vary the text as you like but the special link must be like this: [browser_link]
Practically it works exactly like the “Smart link” that you have in html newsletters “Read this newsletter in your browser”.

Send a web page (URL)

You can send a web page that is located on a web server by giving the URL of this page (and an email subject). The result is like sending an html newsletter. If your page contains images and references to css files these should be in absolute/full path.

With this method views and clicks tracking works in exactly the same way when you send an html newsletter.

You can use personalization tags: [sub_name], [sub_email] etc.

You can use smart links such as:

            
<a href="webpagelink" target="_blank">Read this in your browser</a>
                
<a href="friendforwardlink">Forward to your friends</a>
                
(Change the wording as you like.)

For opt-out links you have two options.

1. Automatically append an opt-out link at the end of the newsletter by clicking the checkbox that you see* or
2. Insert a link anywhere else you want with this code:

                   
   <a href="list_optout">Opt-out from this list</a>
   
   <a href="global_optout">Global opt-out</a>
   
   <a href="account_login">Subscriber account_login</a>
   
   (Change the wording as you like.)

* With the first option in order to change the opt-out type and link wording have a look at the file /inc/optLink.php where you can make the necessary changes.

A/B split testing

A/B testing can be used to test differences in response rates (views & click-through ratios) to different content (newsletter in this case) among your recipients. Here is how it is done:

• You create the campaign using a Newsletter series.
• You can use as many newsletters as you like.
• Make sure you check Rotate newsletters with every batch (for A-B split testing).
• Select your lists.
• Make sure that you use batch settings for this campaign.
• Start the execution manually or schedule it.

• Let your campaign run for some time until several batches are sent.
• Go to your summary report. It will probably take some time until statistics start to accrue. Click the A/B button:
  
• You will see this report:
  
• You can pause and edit your campaign, choose the best performing newsletter and resume it. Or not, you can just let the campaign continue as-is.

• What you see in the report are ratios. The numbers in parentheses show how many times the newsletter was sent.
• It is recommended to let the campaign run some rounds (batches) in order to have a large enough sample for all newsletters.

Batches and timing

• It is highly recommended to use batches when sending.
• It improves deliverability and eases the strain on the server.
• Batches help prevent server time-outs.
• Batches can help you conform with your Host's quotas (number of emails per hour/day). Consult with your Host or SMTP provider to find these quotas.

• When sending manually with a pop-up window the applicable batch settings come from the sender profile you have selected for this campaign.
  You can set these settings in the page where you edit the Sender profile.
  The pause (batch interval) works as an exact pause. You will see your pop-up window reload exactly after the pause.
  You can use any number of minutes for pause or 0 or fractions of a minute like 0.5.
  
  
• When sending with cron you can set the batch settings specifically for a campaign. In this case the Sender profile batch settings are overridden.
  In this case the pause (batch interval) works as a minimum safe distance between two batches.
  You can use 0 for pause and let the cron period regulate the timing (unless of course you have more specific requirements).
  A rough example:
  Assume your cron hits every 5 minutes. But for this campaign you want to have at least 10 minutes break before the next batch starts.
  So you use 10 minutes for pause. In your activity log you may see lines similar to this:

  Task: 3-->2014-12-15 16:27:24-->Check-point-5.-->STOP. Time since last execution: 9 Batch pause: 600.0

  In other words: only 9 seconds elapsed since the last batch finished. But the pause is 10 min (600 secs). So it will stop now and it will check again with the next cron run.

Google analytics

• Optional. Can be used with or without the clicks tracking of nuevoMailer. Learn more
• Applies only to html newsletters.
• When using Google Analytics what you actually track is the website(s) traffic that results from the links in your newsletters.
  You can track the behavior of the subscribers who followed these links inside your Google Analytics account by going to Traffic sources > Campaigns.
• In short, your newsletter becomes another source of traffic and this can be tracked.
  Which means that you must already be using Google analytics at the sites you want to track.
• The URL building is done automatically by nuevoMailer. It parses the links in your newsletter and adds the campaign parameters as required by Google.
• If needed you can use subscriber personalization tags as indicated in the picture above. For the campaign id you can use [camp_id] This is not activated by default but you will find the code to activate it in the file /inc/rdr.php (bottom).
• Google Analytics link parsing of nuevoMailer works with or without the internal clicks tracking mechanism. In fact it works as an extension to the internal clicks tracking mechanism.

Sending campaigns

Editing a campaign
Go to your campaigns page. You will see these options: To make changes to a running campaign (even if the mailing has started). Click the "Edit" icon. Your changes will take effect with the next batch.

Sending manually

To start a campaign manually go Menu > Campaigns > View & start campaigns.

• Click to see the remaining emails to be sent.
• Click “Start mailing” to start the sending process. A new pop-up window opens and the button is disabled. Do not close your browser.
  

If you use batches then after a batch is sent you will see the following screen.
This window refreshes automatically after the batch pause and starts sending the next batch.
If you want to stop the mailing you can close the pop-up window.
However, some more emails will be sent (since the process is now running at the server).

The process is repeated until all emails are sent. At the end you will see this:

Sending with cron

When you schedule a campaign to run in the background using cron you have a few more options.

1. You can define batch settings specifically for this campaign.
2. You can set a campaign daily limit.
3. You can set the hours and days when you want this campaign to run or leave empty to send 24/7.

Looking your campaigns table you will see a calendar icon
Point your mouse over and you will see a pop-up with information about the campaign.

You may edit, pause/resume a scheduled campaign.

If you are not sure whether your cron job is properly configured, check your activity log : Menu > Campaigns > Activity log

Multi-threaded campaigns

In order to send a campaign using multiple concurrent threads you will need the multi-threaded sending plugin. This is an add-on that is not included in the core of nuevoMailer.
To create a multi-threaded campaign go Menu > Campaigns > Create a multi-threaded campaign
You have all the usual campaign options but with a key difference here:

• The number of emails in a batch
  Multi-threaded campaigns are sent in batches. This number refers to each thread.
• Number of threads
  you define here how many processes (threads) each cron hit initiates.
• Distance between threads (seconds)
  This distance refers to thread start times. So assuming you give a 5 seconds distance, every 5 seconds a new thread will start.

Example:

• Number of emails in a batch: 5000
• Number of threads: 20
• Distance between threads: 5 seconds
• A cron hit will initiate 20 threads that start every 5 seconds and each thread will send 5000 emails.
  So each cron hit will process 100k emails.

What settings to use?

• MT campaigns are sent with a cron job. Refer to the install.html that you will find in your package for details.
• All these numbers are interrelated:
  -Campaign size
  -Batch size
  -Cron period
  -Number of threads (NOT)
  -Distance between threads (DBT)
  -REQUEUE_TIME_SPAN. You will find this constant in inc/settings.php. Use 120-180 minutes (to be on the safe side) and leave it. You can read more details in the install.html.
• Cron period, number of threads (NOT) and distance between threads (DBT)
  NOT x DBT should better be less than the cron period.
  For example, if you have 20 threads with 5 seconds distance, it means that the 20th thread will start at 100 seconds from the cron hit.
  Which means it doesn't make sense to have a cron period of less than 100 seconds.
• The campaign size, batch size and number of threads
  If you have a 100k campaign and use a batch of 5k and 20 threads then theoretically a single cron hit would be enough to process the whole campaign.
  It is recommended to use a small batch size and consume 2-3 cron hits to process a campaign.
  Measure how long it takes to process a batch of 1, 2 or 5k.
  Each batch size and thus thread should complete before the next cron hit. Not necessarily though and not for all threads. The 20th batch which will be closer to the next cron hit, will finish much later than the 1st and may pass the next cron hit.
  You can over-flood the system with large batches, many threads and short cron periods and it will still handle it.
  Run some simulation tests first (see next point).
  Keep in mind that the Global Throttling / Maximum send rate is divided by the number of threads (for all sending methods except SMTP and PowerMTA/Pickup).
• Simulation tests
  In Tools>Configuration & settings you will see a sending method: Loop - no sending
  This method is not sending. It merely simulates. So before going live you can create a campaign and watch the log file being updated to get an idea of how threads work.
  Of course, since there is no sending involved, start to finish time will be considerably shorter.
• APACHE configuration and errors
  Apache may limit the maximum number of threads you can initiate. It's good to watch the Apache error_log file for any hints.
  You may have to increase the MaxRequestWorkers & ServerLimit directives in your .conf file.
  Also in the nuevoMailer log file if you see that a thread only starts after a previous one ended then this also comes from Apache. This may happen after after several threads were initiated. The first ones will start on time but eventually the server may delay subsequent ones.
  Please refer here for further information.
• PHP FPM tweaks
  For the same reasons described above, you may need to raise the max_requests & max_children directives. More info.

Recurring campaigns

General

A recurring campaign is one that runs periodically. E.g. daily, weekly, every few days, once a month etc.. Some examples

• Auto-responder campaigns. When you want to send a newsletter to new subscribers after X minutes (hours or days).
• Anniversary campaigns like birthdays. nuevoMailer greatly facilitates the collection of dates from your subscribers by having date-type fields.
• Your weekly, monthly news updates.
• if you define an End date then the campaign recreation process stops at this day.
• After a recurring campaign runs, a new one is created and the task points to this new campaign.
• Asking subscribers to confirm
  Sometimes your subscribers forget or neglect to confirm their subscription. The idea is to send confirmation reminder campaigns that start a few days after they subscribed and stop after a point in time.
  For this example let's assume that:
  - you want to remind them every 3 days
  - start from the 10^th and stop after 30 days from subscription.
  This is your filter:

  AND DATEDIFF(CURDATE(), iDate) <30 AND DATEDIFF(CURDATE(), iDate) >10

  And your campaign settings:
  
  
  The concept described above can be applied in several cases.
  Instead of a confirmation campaign it can be a simple auto-responder that is sent to your subscribers every week, starts after the 10^th, and stops after X days.

Campaign series

A campaign series is a type of a recurring campaign in which you can load a number of newsletters that will rotate with every next campaign.

Which day of the week? As you can see above we set the activation date on May 30th, 2020 which is a Monday. Since the campaign repeats weekly it will be sent every Monday.

Sending once a month To set the day of the month set the activation date to the day you want.
In the special case where you want this campaign to be sent on the last day of the month choose 31 or 30. nuevoMailer will always pick the last day of the month whether that is 30 or 31 or 28 or 29.

Sending a series of newsletters with recurring campaigns is optional
You can use only one newsletter in a recurring campaign and,

• Keep the same newsletter and edit its content just before the next campaign starts.
• Edit the campaign and choose a different newsletter.

Changing newsletter by editing the campaign is probably better for archiving reasons, than keeping the same newsletter and replacing its content. This approach is typical for those publishing newsletters on standard cycles (weekly, bimonthly, monthly etc).

Many authors find it convenient to send a web page as a newsletter.
What they do is to set-up the campaign as above, always use the same URL and just before the campaign starts they update their web page. You have many options.

Life cycle list management
Creating a campaign series is a good way for long term list nurturing. It is usually the first auto-responder emails and triggers that you will use to engage your subscribers. Then you can just put them in a long term campaign using a newsletter series.

So let's assume that for their first 10 days you have used auto-responders. Then there is a special filter that you can add to a campaign series so that it will pick subscribers 10 days after subscription.

AND DATEDIFF(CURDATE(), iDate) >10

And in case you want to stop mailing them after 90 days here is how your filter should be:

AND DATEDIFF(CURDATE(), iDate) <90 AND DATEDIFF(CURDATE(), iDate) >10

General date subscribed vs List sign-up date
dateSubscribed - iDate
You have two options for which subscription date to use.
dateSubscribed refers to General subscription date. The first time a subscriber was added to your system.
iDate refers to List sign-up date. The first time a subscriber was added to this list. Occasionally these two are the same.
When working with one list it is better to use the iDate in your filters.

Auto-responders

Menu > Campaigns > Autoresponders > Create new

An auto-responder is a series of timely campaigns that are sent automatically to subscribers in the order and frequency you choose.
nuevoMailer supports auto-responders based on subscription date (list sign-up) or a subscriber field of type date.
nuevoMailer auto-responders are fully featured independent recurring campaigns with their own statistics that recycle forever.

Here is an auto-responder that is sent 20 minutes after subscribing to a list:
Here is another example based on a custom subscriber field Wedding date: As you can see we have one more option here: Full date comparison.
When checked this auto-responder will fire only once, exactly 7 days after the exact wedding day.
If not checked then it will fire every year, 7 days after the wedding date. In this case the filtering is done by checking only the month and day (and not year).

For birthday newsletters you do not want a "Full date comparison".

If I already have subscribers on my list, what happens for them when I create a new auto-responder for this list?
It depends on when the subscribers were added to your list (the list sing-up date). So if the date condition of the auto-responder is met they will receive the auto-responder.

To exclude subscribers that you manually import as an administrator using a bulk import method, check this option:
For older versions you can enhance your auto-responders using a filter:

AND  (1_subscribers.adminImported=0)   //For nuevoMailer v.9.5
AND  (1_subscribers.ipSubscribed NOT LIKE ‘%admin%’)    //For older versions
                

Birthday campaigns

With nuevoMailer you can capture (or import) your subscribers birthdays (or other anniversaries).
You create a birthday filter, a "Happy birthday" newsletter and a campaign that uses them.
The birthday campaign must be recurrent and run every day.

1. Start by setting up a custom subscriber field (of type date) for storing birthdays.
   
   You must choose a field type of DATE
2. Then in the same page define this field.
3. Refresh your welcome page to verify that your birthday field is active. Follow the link and explore this page.
4. Create an auto-responder

Other anniversaries?
What's described here can also be applied for other anniversaries. E.g. wedding dates.
Set-up another custom field to store these dates.

Birthday reminders for the administrator
These reminders are for you, the administrator.
You can set-up a cron job to run daily and notify you about this day's or next days birthdays.
To set the number of days in advance open the file inc/settings.php and change this variable.

$bDaysBefore=30; //Enter 0 for same day reminder

Follow-up campaigns

You can create follow-up campaigns based on the clicks or views from a previous campaign.
When looking at your “Summary report” you can create a new campaign as a “follow-up campaign”. Your options are shown in the screen shots below:

• You are creating a new campaign identical to the previous one (with the same lists, newsletters and subscriber tags). You can further edit this campaign if you need to do so.
• A filter is created in the background and it is added to this new campaign. It is the filter that will make the difference in the selection of subscribers in the new campaign.
• If the old campaign was already already using a filter this will not be appended in the new one.
• Create only a filter
  Checking this box will crate only a filter and not a new campaign. You may want to use this filter in another campaign with different parameters.
• If the campaign was sent to all subscribers then you can only create a filter (without a campaign). This is because filters can be used in campaigns to all lists or to selected lists.
  In this case you will find the checkbox already checked and disabled.

For time-sensitive follow-up campaigns see auto-responders.

Email Triggers is another way for following up on an individual basis. See below.

Triggers

For a very good overview of the triggers functionality in nuevoMailer and implementation ideas see here.

This is the button for setting triggers:

Using triggers you can do the following:

• Update a subscriber field
• Tag or un-tag a subscriber
• Send a single newsletter
• Add the subscriber to other list(s)
• Remove the subscriber from other list(s)
• Execute an outbound webhook

You can set triggers at:

• Campaign-wide level clicks/views (including auto-responder campaigns)
• A specific newsletter (clicks/views)
• A specific hyperlink (click)
• On list opt-in (see also auto-responders here)

Triggers in recurring campaigns

• Recurring campaigns are re-created automatically as soon as the previous one completes. Therefore we have a "parent" which is the first one and "children" which are the ones that follow. This is what we call a branch:
  
• The triggers set on the parent will also apply to the children.
• When you add new trigger on a child campaign it also updates the parent (and the whole branch).
• If you delete the parent campaign the old trigger will still apply to previous campaigns that were sent (of the same branch).
• But if you create new trigger for a child (after the parent has been deleted) then this will apply to this campaign and its children that will follow it.

Setting an expiration for triggered emails
Assume you create a trigger to send a single email on an action such as a view or a click.
A subscriber may do a view or a click several times as soon as he receives the newsletter or even days or months later.
nuevoMailer can prevent the sending of the triggered email multiple times (with each view/click) by marking the triggered email as processed.
But sometimes it may be useful to fire this trigger again after some time and if the view/click action happens again.
For that reason we can set a trigger expiration period in the file /inc/classUtil.php:

/** Number of days-after to delete a PROCESSED triggerred email from the queue.*/
$this->usedTriggerDeleteDays    = 10;
/** Number of days-after to delete a STALLED triggerred email from the queue. E.g. one that not fires for any reason.*/
$this->deadTriggerDeleteDays    = 10;

So after 10 days the triggered email will be sent again (assuming of course that the action that triggered it is repeated).
Triggered emails are processed by cron job #4 and are sent in batches.
The batch number is the maximum of these two: Default sender profile batch settings or 100.
So if you expect a significant volume of triggered emails adjust your settings and the cron job period accordingly.

curl -l -s http://www.domain.com/mailer/admin/_sendTr.php?apiKey

Sender settings in triggered emails
By sender settings we mean the <from-email>, <from-name> values in the triggered emails.
Campaign sender settings (if applicable - if the trigger is derived from a campaign) will override the Sender profile settings.

You can read more about the various trigger options here.

Transactional emails
Building on the email triggers feature you can also send transactional emails from your own CRM/CMS or website using the api.
You only need to "post" a subscriber email and a newsletter ID. If the subscriber exists in your database then the newsletter will be personalized.
If he doesn't exist then you can optionally subscribe him at the same time, in one step.

Mailing filters

Overview

Filters are extra criteria that you can apply to a campaign and will result in excluding or including subscribers on the basis of demographic parameters, tracking behavior, subscription dates and more.
You can create a new filter by going to:
You can view your filters under Menu > Filters > View filters.

Every filter contains a short description and SQL code. You can edit both if needed. Simply click on the description or the code.

There is no need to know SQL in order to create filters. The editing options are provided for users who know and want to do more advanced things.

Filters can be used when you send a campaign to All lists or to Selected lists.

Campaign follow-up filters
Such filters are created automatically when you create follow-up campaigns.

Demographic filters
Menu > Filters > Create new > Based on subscriber properties/data

In this page you can:

• Perform advanced searches on subscribers using any of their available fields and tags.
• See subscribers with soft or hard bounces.
• Preview and export the results to spreadsheets like Excel, CALC/LibreOffice.
• Create filtered lists (sub-lists or list segments) based on the search results. The parent lists remain intact.
• Create filters that you can save, edit, refine and use in your campaigns.

Empty, blank filter
Menu > Filters > Create new > Create a blank filter
You simply create an empty filter and then you can add your own sql code or copy code from another filter.

Refining a filter
If you are familiar with sql syntax you can change the sql code and refine an existing filter. You can also merge filters or create your own.

Testing a filter
You can test a filter when creating a new campaign. You select the list(s) and the filter(s) and you click “Count”.
Count with and without selecting a filter so you can see the difference.

Examples & tips
Using filters you can find and create a sub-list or a mailing filter or export subscribers who:

• Come from a specific country and subscribed after a certain date.
• Have a specific zip code.
• Have not updated their account since a given date.
• Did not have any activity since a given date.
• Come from the same company.
• Have the same domain in their email address.
• And much more...

Create a new list segment or a mailing filter?
If you need a new list then create a new list segment with the search results.
If you only want to do a few mailings to this subscriber group then it is perhaps better to create a mailing filter. The answer really lies in your subscriber management approach.

Merging filters

You can merge (add filters together) by putting together the sql code of each filter and using an AND or an OR operator.
Here is an example. One filter that picks subscribers with Hotmail and Yahoo email accounts.

AND (1_subscribers.email LIKE '%hotmail%' OR 1_subscribers.email LIKE '%yahoo%')

If you are familiar with SQL programming you can do many tricks, use AND, OR, EXISTS statements and construct complex filters.

A very handy filter idea - Exclude subscribers of a specific list

Attention: since nuevoMailer v.8.6 you can do this directly when you create a campaign without using filters.

Usually there is overlap between lists. Meaning that subscribers belong to more than one list.
Q: I want to make a campaign to lists A, B, C but I do not want to include anyone on those lists who is also in list D.
A: Create a campaign to lists A, B, C and use this filter

AND 1_subscribers.idEmail  NOT IN (SELECT idEmail FROM 1_listRecipients WHERE idList=D)

Which means that those who are subscribed in list with id D will not be included in the campaign (no matter if they belong to A or B or C).

 

 

© 2023 Designerfreesolutions

Visit nuevoMailer.com

Visit the Demo