Page 1 of 16 1234511 ... LastLast
Results 1 to 10 of 155
Like Tree2Likes

Thread: HOW-TO guide for Email Campaigns.

  1. #1
    agupta is offline Sugar Team Member
    Join Date
    May 2005
    Posts
    142

    Default HOW-TO guide for Email Campaigns.

    Following are the steps that you need to follow in order to send email campaigns using 4.0 or later version of sugar.

    1. Setup a monitored mailbox.

    This mailbox will be the sender of campaign emails and will also receive any bounces. this is an administrative task and needs to be done only once. One mailbox can be used with multiple email campaigns.

    Use the Manage Mailboxes option from the Admin panel to set this up. In addition to required fields on the form do not forget to set these field values:
    a. Possible Action = Bounce Handling
    b. From Name: Email Campaign Sender Name. This will be the default value, it can be overwritten during the campaign definition.
    c. Form address: A valid email address. Campaign emails will be sent from this account. All bounces will land in this account. You should have pop access to this account.

    2. Campaign module relies on the scheduler to send emails and process bounced emails. There are two predefined scheduler jobs that perform these tasks. "Run Nightly Mass Email Campaigns" and "Run Nightly Process Bounced Campaign Emails". You need to configure your scheduler and activate these jobs.

    3. Define a campaign of Type Email.

    if you set values for both tracker text and tracker url. The text will be appended to your email message as a link with the tracker url as the target. When the recipients of your email click on the tracker text they will be redirected to the tracker url and a click-thru campaign log entry will be created.

    If you want to control the location of the tracker text then leave the tracker text field empty and set tracker url. when composing the email template add tracker text add the desired location and surround it with TRACKER_URL_START and TRACKER_URL_END macros. The text will be converted into a link and associated with the tracker url.


    4. Add targets list, a collection of people who will receive the campaign email. You can add leads, contacts, targets and/or users to a target list. A target list can either be a list of targets to send emails to, or, pattern of/a list of email address exempted from the campaign. lists of type default, test and seed belong to the first category.


    Target List Type: Default: Everybody in this list will receive the campaign email.
    Seed: List of people who need to be notified when a campaign has been sent. The will receive a copy of the email. Typically you would add users of the application to this list.
    Test: List of people who would receive the test emails, Can be used to work on the email messaging before it is sent outside.
    Suppress - By Id: List of people exempted from the Campaign email. say for a campaign you have a default list of 100 targets of this list you do not want to send emails to 20 targets, first add these targets to a list of this type and then associate the list with the campaign.
    Suppress - By Email Address: Same function as previous type. In this case exemption is based on email address comparison.
    Suppress - By Domain: with this type you get an additional field "No emails to Domain", you can set a domain name in this field. say you want to suppress emails to <everybody>@yahoo.com, set yahoo in the domain field.


    Target lists are integrated with import functionality. After a successfully importing a list of targets you get an opportunity to add imported records to a target list.
    Target lists are integrated with reports, you can link output of a report to a target list, this feature is enabled for leads, contacts and target reports.

    After defining the target lists associate them with the campaign.

    5. Define the email marketing message. This will be the message that the campaign targets will receive. A campaign can have multiple email marketing messages, with each message you can associate target lists. This allows for sub-grouping of targets in a campaign, and provide a different messaging for each sub-group.

    In this step you will be using the monitored mailbox that we defined in the first step, upon selection of the mailbox the default "From Name" will be filled you can override this value, since the recipients of the email will see this name as the sender of the email.

    Create an email template that constitutes the subject and body of the email, in this step you can use the TRACKER_URL_START and TRACKER_URL_END macros defined above.

    6. You are now ready to test/send your campaign. for these action you will be using the "Send Test" and "Send Emails' buttons from the Campaign detail view.

    Send Test: Use this option to test you message, you will need at least one target list of type test. When selected with take you to a scheduling screen where you will see all the Email marketing messages and the associated target lists. you can choose the message that you like to send. Messages will be sent only to test lists even if you have other type of lists associated with the email marketing message.

    Messages will be sent immediately upon selection of the send button from the scheduling screen. you can see the status of the messages and campaign response by switching to the status view. "Delete Test Entries" button from this page can be used to delete campaign log entries associated with test lists.. you can perform this step at any time.

    Send Email: This function works like send test except for 2 difference. first, it deals with default list and applies the exemption lists, second, messages are not sent immediately instead they are queued for sending. The "Run Nightly Mass Email Campaigns" job described in step 2 takes the queue as its input and sends messages. if the schedulers are not configured you can use "Mass Email Manager" option from Admin panel to send messages manually.


    7. Mass emailer. This component processes the campaign email queue, for each item in the queue the emailer,
    a. Checks the target's email address against the suppression lists for the campaign. If it is to be suppressed then item is deleted from the queue.
    b. if the target is opted out the appropriate campaign log entry is created and item is delete from the queue.
    c. if the target has an invalid email address a campaign log entry is created and item is deleted from the queue.
    d. composes a message for target from the email templates, assigns a unique id to the email message (tracker_id) and adds a bot to the email to track email viewing. if specified, appends tracker text and url to message. Appends opt-out url and message to the email, the message text can be changed in the module's language file.

    if you are concerned about number of emails sent by the mass emailer per run, you can control that value by navigating to Admin Panel->Email-Campaign Setting option, set a different value for "Number of emails sent per batch" property, default is 500.

    The other setting on this page lets you change the location of files that track how recipients of the campaign email are responding to the message. files of interest are, campaign_tracker.php, image.php and removeme.php. these files are in root of your install directory by default. you may need to move these files if you are sending the email campaign from site what is not publicly accessible. if you move them you will need to make some changes to these files.


    8. Campaign Tracking: Once the campaign has been sent you can track its progress by switching to the status view. Campaign module integrates with inbound emails component to process bounced message, make sure that "Run Nightly Process Bounced Campaign Emails" job, described is step 2, is configured properly.

    Thanks for you constructive feedback.
    emailsangel and Chris_C like this.

  2. #2
    siros is offline Sugar Community Member
    Join Date
    Jan 2006
    Posts
    20

    Post Re: HOW-TO guide for Email Campaigns.

    I noticed that you can only set the campaign to come from a mailbox which has "bounce handler" set: all other mailboxes are not shown in the list.

    Does that mean that we cannot have an application where a mass email is actually trying to get people to reply to the email? In other words, we would like to handle not just bounces but also real replies. How would we do that?

  3. #3
    jayskersonic is offline Sugar Community Member
    Join Date
    Jan 2006
    Posts
    19

    Default Re: HOW-TO guide for Email Campaigns.

    How do you modify the opt out message for mass mailings?

    It has an arbitrary email tag at the end of all of my messages that is redundant. Plus the email address it uses is bogus...

    Where does this file live? I asked this question some time ago!

    Does anyone know? I can't believe that this tag line would be on EVERY EMAIL and you give no instructions as to how to change or remove it!!!!

    PLEASE HELP!!!

  4. #4
    agupta is offline Sugar Team Member
    Join Date
    May 2005
    Posts
    142

    Default Re: HOW-TO guide for Email Campaigns.

    jayskersonic,

    The tags that form the opt-out message are defined in this file, modules/Emailman/laguage/en_us.lang.php

    change the value of TXT_REMOVE_ME , TXT_REMOVE_ME_CLICK and TXT_REMOVE_ME_ALT.

    -Ajay

  5. #5
    agupta is offline Sugar Team Member
    Join Date
    May 2005
    Posts
    142

    Default Re: HOW-TO guide for Email Campaigns.

    Quote Originally Posted by siros
    I noticed that you can only set the campaign to come from a mailbox which has "bounce handler" set: all other mailboxes are not shown in the list.

    Does that mean that we cannot have an application where a mass email is actually trying to get people to reply to the email? In other words, we would like to handle not just bounces but also real replies. How would we do that?


    Siros,

    We do not have support for your use case, I will be taking it as a feature request for next release. The reason we did not implement your use case is becuase when you send large number of campaigns using an email address, the mailbox tends to get loaded with bounced messages, auto-replys etc. which makes it diffcult to find genuine responses from your targets.

    As a part of this feature request I will allow for another field in the email marketing message screen, where you will be able to specify the reply-to address. this address can be different from your bounce handling mailbox , which means you will be able to use inbound email process to import the messages.

    Thanks,
    Ajay

  6. #6
    wrightbyname is offline Sugar Community Member
    Join Date
    Feb 2006
    Posts
    19

    Default Re: HOW-TO guide for Email Campaigns.

    Thanks for the excellent guide! It's making the process much easier.

    I'm having trouble with the WYSIWYG editor stripping out half of my HTML, but as long as I edit it externally, then switch to Text mode, paste it in and save it without switching back to WYSIWYG mode it seems OK.

    Could you tell me how to insert the TRACKER_URL_START and TRACKER_URL_END macros? Basically, what is the syntax, and could someone give a quick example? Nothing I try seems to work....

  7. #7
    agupta is offline Sugar Team Member
    Join Date
    May 2005
    Posts
    142

    Default Re: HOW-TO guide for Email Campaigns.

    wrightbyname,

    Glad to hear that the guide is helping you. as for your question try the following..

    1. for the campaign make sure that tracker text field is empty and supply a value for tracker URL.
    2. in the email template for the campaign use this format to supply the tracker text.

    TRACKER_START_URL<your text>TRACKER_END_URL


    3. at run time <your text> will be converted into a link , which will have tracker URL as its href.

    -Ajay

  8. #8
    wrightbyname is offline Sugar Community Member
    Join Date
    Feb 2006
    Posts
    19

    Default Re: HOW-TO guide for Email Campaigns.

    I've got it now - I was expecting the preview to show me an example of how the macro converts into a link, but it doesn't. I should have just sent myself a test straight away and avoided the head scratching!

    Thanks again.

  9. #9
    bretvenuso is offline Sugar Community Member
    Join Date
    May 2005
    Posts
    14

    Default Re: HOW-TO guide for Email Campaigns.

    Thanks for the step by step this has answered most of my questions.
    This is probably my lack of knowledge on the use of a campaign but i am looking for the ability to handle the following situation:

    Say i have 50 customers all of which want me to handle there monthly newsletters to their target list, each newsletter will contain info specific to that customer, ie - logo, address, specific text, specific ad section. However the bulk of the newsletter will be the same for everyone. I would create a monthly Template with the ability to pull the dynamic content for each customer.

    Is there a way to handle something like this with sugar?

  10. #10
    agupta is offline Sugar Team Member
    Join Date
    May 2005
    Posts
    142

    Default Re: HOW-TO guide for Email Campaigns.

    bretvenuso,

    Interesting use case. sorry we do not support this use case at this time. we are adding it to the list of feature requests for future releae.

    how about customizing the application to add support for your use case.

    -Ajay

Page 1 of 16 1234511 ... LastLast

Thread Information

Users Browsing this Thread

There are currently 1 users browsing this thread. (0 members and 1 guests)

Bookmarks

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •