Wednesday, December 31, 2008
JangoMail Tip: Random Selection of Members
JangoMail supports this need, whether you are querying your database directly (Extract from My Database) or selecting members from Groups stored within JangoMail.
The key is to add "order by newid()" to the end of the SQL query you are using to specify criteria for your mailing.
In a JangoMail Group, you would use the Filter and Send tool. From the main Filter and Send screen, Switch to the Advanced Query Editor. Now, you can set your message criteria, and add in the random selection. In the following example, we are selecting 5 random members of the Group, Web Customers.
When the Filter is executed, we will be ready to send to 5 members of this Group.
Sunday, December 21, 2008
Users calling API method SendMassEmail for single recipient campaigns now auto-converted to SendTransactionalEmail
-------------------
Today we made a change to your account involving how your email campaigns to single recipients are sent via the API. You are currently calling our API method SendMassEmail in succession to send a high volume of single-recipient "transactional" type email messages. Several days ago we launched a new API method, called SendTransactionalEmail, which is specifically designed for sending single-recipient messages. The change we made to your account, forces any calls to SendMassEmail to be converted to SendTransactionalEmail method calls, when the call to SendMassEmail is for a single email recipient only.
There are several reasons why we made this change to your account:
1. The SendMassEmail method has always been designed for sending email campaigns to a group of recipients at once. When calling this method, the system treats the campaign as a campaign going to a group of recipients and does processing involving de-duping the final recipient list, deleting invalid email addresses, assigning sending servers based on internal rule sets, and other steps to generate the final recipient list and personalize each email message. Even single recipient campaigns sent via this method take 30-60 seconds to send due to the pre-processing steps that take place with each email campaign. Additionally, when SendMassEmail is called, all campaign data is stored in your account, including the Subject, HTML Message, and Plain Text Message. Calling SendMassEmail thousands of times takes up a lot of space in our database.
2. The new SendTransactionalEmail method sends messages out over SMTP immediately upon the method call. Now emails will be sent 1-2 seconds after the method call rather than 30-60 seconds after.
3. The new SendTransactionalEmail method doesn't store the full message body in our database, since it sends the emails out right away over SMTP. Therefore overall system performance is greater and less storage is taken when single recipient emails go through this new method.
4. You'll now be able to see better reporting and statistics on single-recipient messages. With each individual call to SendMassEmail, each message shows as its own campaign in Reporting, making it difficult to assess what's happening across all of the messages together. Soon we will have an interface for Reporting on just transactional messages generated via SendTransactionalEmail. You'll be able to group different types of messages (Order confirmations, Welcome messages, Internal notifications, etc.), and see open-tracking and click-tracking statistics per Transactional Message Group.
Documentation:
The technical specification on the new method is here: http://api.jangomail.com/help/html/655d20ca-2164-c483-fb21-d3d0ee049155.htm
Here's a brief FAQ on the change:
1. Why did you set my account to convert calls to SendMassEmail to SendTransactionalEmail instead of letting me make the change in code myself?
We figured it would take our customers a while to make the code change on their own. And we didn't see any disadvantages of forcing the conversion to the new method. Furthermore, for our own benefit, we gain a lot of system preformance and database storage back by having single recipient emails go through SendTransactionalEmail rather than SendMassEmail.
2. What if I'm using SendMassEmail to send to Groups or recipients from a live web database?
Calls to SendMassEmail with Groups or live datasets as the recipients will not be altered. Only calls to SendMassEmail where a single recipient is specified are converted to SendTransactionalEmail.
3. Even though you're converting my method calls for me, should I still make the change in my code to SendTransactionalEmail?
Yes, you should. If you call this method directly, you'll be able to take advantage of Grouping and other features specific to this method.
4. Do I lose any tracking by using SendTransactionalEmail?
No, messages sent with SendTransactionalEmail still have open tracking and click tracking capabilities. The recipient is still checked against the unsubscribe and bounce lists before the email is sent. And the messages are still signed with DomainKeys and DKIM, provided your account has been setup to sign messages.
5. What if I want you to undo the change on my account and let me use SendMassEmail as before?
Sure, just let us know. We can't think of any benefit to doing so, but there are so many subtleties and different ways our customers use JangoMail, that it's possible we didn't think of everything. Just reply to this email or get in touch with us if you have a reason why you don't want us to force the SendTransactionalEmail method on you.
6. I don't see any of my messages in Reporting. How do I know my messages are being sent?
The reporting interface for transactional messages is still being built. It should be live under the "Reporting" tab by mid-this week. If you need reporting statistics beforehand, just let us know and we can manually query our database to show you what has been sent/opened/clicked.
7. I'm in the Sender Score Certified program. Will email messages sent via SendTransactionalEmail be sent through SSC-approved senders?
If you are in the SSC program, then yes, just like a regular email campaign, transactional email messages will also be sent through SSC approved senders.
One important difference with unsubscribes/bounces:
When calling SendMassEmail, if sending to an email address on your account's unsubscribe or bounce list, the method call is successful and during pre-processing that email address is removed from your final recipient list. When using SendMassEmail to send to single recipients, this would result in a campaign with 0 recipients.
When calling SendTransactionalEmail, an exception is thrown if you send to an email address on your account's unsubscribe or bounce list. Please be aware of this when writing your code or modifying your code to use SendTransactionalEmail instead of SendMassEmail. This change also is in effect for the accounts which we've put in the auto-conversion from SendMassEmail to SendTransactionalEmail.
Thursday, December 18, 2008
New API Method - SendTransactionalEmail
The new method allows for rapid processing of these single emails, while retaining full tracking for the mailings (Opens, Clicks, Unsubscribes, and Bounces).
We are completing our testing phase now. The reporting module for tracking transactional emails is still a few days away, but we're very excited with our early results and hope you will be too.
What does it look like? The input parameters are very similar to SendMassEmail. The key difference is that there is a "ToEmailAddress" parameter which expects a single email address.
The full method is at: http://api.jangomail.com/api.asmx?op=SendTransactionalEmail. Detailed documentation is at: http://api.jangomail.com/help/html/655d20ca-2164-c483-fb21-d3d0ee049155.htm.
For a full reference on the API, visit the API home page: http://api.jangomail.com/help/
Tuesday, December 16, 2008
Bug Fix: Member Counts Returned to Main Groups Page
Groups will initially show as "Counting" while this process takes place, and will display their respective counts as the tallies come in from the database.
Update to Image Library: Host TXT, PPT, and PPS Files
Once stored, you may create links in your messages that reference the hosted files much as you would a PDF or other non-image file.
JPG and GIF files remain the only image file types that are recognized by the HTML Editor's Insert Image function because they are the file types that are viewable across most HTML-capable e-mail clients.
Other file types are accepted into the library for hosting. Our tutorial on linking to hosted files (PDFs and others) can be downloaded here.
Site Enhancement: New Features Page
Make sure you stop by and ask us about anything you'd like to try:
http://www.jangomail.com/features_overview.asp
Tuesday, November 18, 2008
Updated Feature: Templates
Previously, templates were stored at the top of the Re-send Old Message list, but this became cumbersome for many users. Now, you can easily locate stored templates in a separate selection box of their own.
Monday, October 13, 2008
New Feature: Include CC Addresses
The CC feature allows you to specify an address that will receive a clear (address IS visible to the email's direct recipient) copy of the message as it is sent out. It is found under Advanced Options as you compose in the Send E-mail tab.
For example, you send a personalized message that starts: Dear Kim, Dear Joe, Dear Susie, etc. Kim, Joe, and Susie each receive their individual emails, showing the appropriate personalization. At the same time, the address given in the CC field also receives 3 emails: copies of the separate messages for Kim, Joe, and Susie.
You may want to specify a single address to receive the CC. This can be used to create an arachive for businesses with compliance needs, for example.
You can also use our personalization coding to send the CC email to an address stored in each record in your database. For example, addresses might have a particular representative assigned to them. The email can be copied to a customer's specific representative, while the message itself may be "From" the main corporate headquarters.
From Address: announcements@browniekitchen.com
CC Address: %%repemail%%
(where data associated with each address record contains a field called "repemail")
Then, Kim, Joe, and Susie would each see that their own representatives were copied on the messages as well -- also a good reminder of that direct contact information should the recipients have any questions.
Note: When using the CC feature, JangoMail is generating two emails for every one recipient address. This will double your email sending volume for pricing purposes. If you use this feature along with our BCC feature, then you will be tripling your volume for pricing purposes.
Friday, October 10, 2008
New Feature: Add Personalization to the BCC field
The BCC feature allows you to specify an address that will receive a blind (address not visible to the email's direct recipient) copy of the message as it is sent out. It is found under Advanced Options as you compose in the Send E-mail tab.
For example, you send a personalized message that starts: Dear Kim, Dear Joe, Dear Susie, etc. Kim, Joe, and Susie each receive their individual emails, showing the appropriate personalization. At the same time, the address given in the BCC field also receives 3 emails: copies of the separate messages for Kim, Joe, and Susie.
Previously, you could only specify a single address to receive the BCC. This was often used for businesses with compliance needs that required an archive of messages sent.
Now, you can use our personalization coding to send the BCC email to an address stored in each record in your database. For example, addresses might have a particular representative assigned to them. The email can be "signed" from the representative in the message body:
Regards,
%%repname%%
%%repemail%%
Now, these representatives can also receive a behind-the-scenes copy of what "they" sent out via the JangoMail system, so that they won't be surprised with direct responses from their clients. If this data is stored in a field called "repemail" for each record, just put %%repemail%% in for the BCC.
Note: When using the BCC feature, JangoMail is generating two emails for every one recipient address. This will double your email sending volume for pricing purposes.
Thursday, October 09, 2008
New Feature: Specify an SMS Text Message
You will find the new field on the Messages composition screen, under the SMS tab. Specify a message here for any text users. If an email address is in one of the listed SMS email gateway domains, then this SMS Text Message will be sent from your JangoMail account instead of the standard HTML/Plain Text multipart message.
If the SMS Text Message field is not set, and a recipient's domain is an SMS email gateway domain, then the email message will be assembled as normal, including the HTML Message, Plain Text Message, and any attachments.
A full list of SMS email gateways is available at http://en.wikipedia.org/wiki/SMS_gateway.
The following properties are ignored when an email message to an SMS email gateway is assembled:
- Open Tracking
- Click Tracking
- Wrapping
- Plain Text Message
- HTML Message
- Attachments
- Triggers
Friday, October 03, 2008
New Feature: Calendar/Time controls added to Send E-mail page
We have introduced new calendar and time controls for these fields to help you get it right the first time.
How do you use the new tools? Look to the right of the scheduling fields for the calendar and clock symbols.
Click on the calendar to set the date.
Now, click on the clock to set the desired time.
You'll wind up with the right format each time.
Thursday, October 02, 2008
New API Methods and Enhancements
Retrieve Complaint Data
JangoMail now allows you to pull the data behind the "Complaints" column of your General Job Statistics report via the API. This reflects addresses that have used their "this is spam" reporting tools via their ISP, which JangoMail receives via feedback loop.
- Reports_GetComplaintsByCampaign_Dataset retrieves list of complaints for the given Job ID. Returns a .NET DataSet.
- Reports_GetComplaintsByCampaign_String retrieves list of complaints for the given Job ID. Returns a String.
- Reports_GetComplaintsByCampaign_XML retrieves list of complaints for the given Job ID. Returns an XML document.
Check Job/Campaign Status
Once you send, your campaign goes through three stages:
- Preprocessing -- where the message is prepared for sending, removing duplicates, bounces, unsubscribes, etc. prior to sending.
- Sending -- where the message is personalized and launched from our network of senders.
- Complete -- where your campaign has fully completed sending.
These states are shown in the JangoMail interface under Reporting, and you can now confirm the current status of any campaign by API as well.
GetMassEmailStatus returns the current status for the given job/campaign ("Preprocessing", "Sending", or "Complete").
Enhancements to the "Send..." Methods
The CustomCampaignID can now be specified in the "Options" parameter of the "Send" methods (SendMassEmail, SendMassEmailPrevious, SendMassEmailPrevious2, SendMassEmailRaw). For example, Options can now include the following parameter: CustomCampaignID=FinalMailer.
Attachments will now validate during sending. This will alert you if you specify an attachment in the "Options" parameter that does not exist on the server. Previously, such a campaign would still go through, but missing the attachment, and the method would return a SUCCESS message. Now if the attachment doesn't exist, an exception will be thrown and no campaign will be sent or saved.
Enhancements to AddGroupMember and EditGroupMemberJangoMail has a new setting to prevent duplicates from being added to a Group. With the API, the AddGroupMember and EditGroupMember methods reflect this change as well. Both will now throw exceptions if the Group is set to disallow duplicates and you:
- attempt to either add an already existent address, or
- edit an address such that it would match an already existent address.
For the full web-based reference on all available methods and their signatures, including the new methods and enhancements, click here.
New Feature: Prevent Duplicates in Groups
To turn this setting ON, go to Groups and E-mail Addresses and select your Group. Click the "Enable/Disable Duplicate Members" button in the right hand pane.
With this setting enabled, if you attempt to add an address to a Group that already contains that address, it will prevent the new entry. The method of adding a Group member will not affect this setting.
Manual entries will display an error, and imports will skip addresses already in the Group. If you are using a web site sign up form, the user will get an error if they are already in the Group, preventing a second entry for that email address.
Note the difference between this and a Scrub (Scrub Group Members), for a Scrub does not prevent duplicates from being added--it just clears duplicate entries (by email address) when executed.
Note: If you enable this setting on a Group that already has duplicates, the existing duplicates are NOT deleted unless you run a Scrub.
Monday, September 29, 2008
New Feature: Creating Multiple Logins for Your Account
Creating additional logins will allow additional people access to the same account. Creating additional logins does NOT create new JangoMail accounts, and all logins have the same permissions as the main username/password on an account.
You may find this useful if you have multiple people accessing the same account. With different logins assigned to each employee,if one employee leaves, that one login can simply be deleted without affecting the others using the account.
There are a few limits to these logins. The additional logins do not have API access, the ability to initiate mass emails through an external email client, or the ability to FTP to the JangoMail server. Only the administrator's login can utilize these functions.
How do I get started?
Login with the current username and password, and go to the My Account section in the upper right of the interface.
Select the Other Logins tab.
Friday, September 26, 2008
Enhancement to Reporting: Filter by CampaignID
Bug Fix: Foreign Characters and Personalization
Using the API for "on the fly" personalization
Using our ability to do "on the fly" personalization with the API in the SendMassEmail method, we were not properly encoding personalization when it involved a non-English character set.
With this correction, you can now submit personalization field values that DO use the non-English character set, provided that it is specified in the CharacterSet option.
Now, your Options attribute can contain parameters like:
Options=
ToOtherRowDelimiter=¦,ToOtherColDelimiter=c,
ToOtherFieldNames=FirstName¦LastName¦EmailAddress¦
Headline,CharacterSet=UTF-8
This would allow you to then use the following to create a merged message with non-English characters:
ToOther=
John,Smith,john@smith.com,揭秘神舟七号飞船气闸舱¦David,Gary,david@gary.com,揭秘神舟七号飞船气闸舱¦Sheila,Panther,sheila@panther.com,揭秘神舟七号飞船气闸舱
Subject=
Hello %%FirstName%%Message=Hello %%FirstName%% %%LastName%% -- today's headline is %%Headline%%
Using foreign characters in stored Group data
When storing data in a JangoMail Group, foreign characters inserted into a group member's field previously had turned into neutral placeholders when saved. Now JangoMail can correctly store foreign characters in Groups too and use that for personalization.
Tuesday, August 26, 2008
Update to ASP script file for web servers
This notice applies to you if you use JangoMail's "Connect to Internet Web Site Database" feature to pull email address data in real-time from your web site's database.
We've updated the web server script file that is used to allow JangoMail to connect to your web / database platform. This update applies to those customers using one of these three platforms:
- Active Server Page web site / Any ODBC compliant database
- Active Server Page web site / Microsoft SQL Server Database
- Active Server Page web site / Microsoft Access Database
This update does not apply to the PHP / MySQL platform, because the w_4.php file has never used the EnDeCrypt algorithm used in the w_x.asp files.
What is the update?
The update eliminates the EnDeCrypt encryption algorithm that was previously used in the w_x.asp files. The EnDeCrypt algorithm present in the w_x.asp files is an outdated encryption/decryption mechanism that we have deprecated in favor of using standard SSL (Secure Sockets Layer) security with the https protocol.
If you retrieve the appropriate w_x.asp file now from the Extract From My Database tab of JangoMail, the new w_x.asp file will no longer contain the lines of code that perform the decryption. If you have made your own custom modifications to the script file on your web server, you can update the file manually. Or, you can retrieve the updated file from JangoMail directly.
After the updated file is in place, you must click a button at the top of the Extract From My Database tab which will tell JangoMail to stop encrypting data using the EnDeCrypt algorithm when passing information to your web server.
To update your w_x.asp file manually:
- Comment out or delete the lines that perform the EnDeCrypt decryption.
- Deleting the RC4Initialize subroutine and EnDeCrypt function.
- Comment out or delete the two array declarations, "Dim sbox(255)" and "Dim key(255)"
- Click the button that appears at the top of the Extract From My Database page to update your JangoMail account so that data is no longer encrypted with EnDeCrypt before it's passed to your web server.
To retrieve the updated w_x.asp file from JangoMail:
- Login to your JangoMail account.
- Click the Extract From My Database tab.
- Click "retrieve the web server file" and follow the directions to download the appropriate file.
- Click the button that appears at the top of the Extract From My Database page to update your JangoMail account so that data is no longer encrypted with EnDeCrypt before it's passed to your web server.
Do I have to update my w_x.asp file?
We highly recommend that you do the update as soon as possible. The old versions of w_x.asp, with the EnDeCrypt mechanism, will continue to work through the end of the year. In early 2009, the option to use a w_x.asp file with the EnDeCrypt routines will no longer exist.
One final note:
There is a benefit to updating if you maintain multiple JangoMail accounts. The old w_x.asp files, with the EnDeCrypt mechanism, made use of a private key that was hard coded inside the routines, and a private key was unique to a single JangoMail account. Once you update to the new w_x.asp files, there will be no hard coded key, and this will allow the same version of the w_x.asp file to be used with multiple JangoMail accounts.
Monday, August 18, 2008
Feature Update: Link JangoMail to Multiple Salesforce Accounts
Now, if you have multiple Sales Agents that use their own Salesforce accounts, they can all use the same JangoMail account for sending.
How do you set this up?
- From inside Salesforce, click the "JangoMail" tab. If you login to an existing JangoMail account, then the Salesforce account from which you logged in will be ADDED to that JangoMail account's list of linked Salesforce accounts.
- Go to My Options --> Salesforce --> Account Settings. Now instead of the previous single line text field that stored a single Salesforce User ID, there is a text box that can store multiple Salesforce User IDs. Type in any additional IDs here, each on a separate line.
This multiple connection only works one direction, however. You currently CANNOT have multiple JangoMail accounts linked to the same Salesforce account. A Salesforce account can only be linked to one JangoMail account, but a JangoMail account can be linked to multiple Salesforce accounts.
Wednesday, August 13, 2008
Image Library Now Accepts .MOV Files
JPG and GIF files remain the only image file types that are recognized by the HTML Editor's Insert Image function because they are the file types that are viewable across most HTML-capable e-mail clients.
Other file types are accepted into the library for hosting. Our tutorial on linking to hosted files (PDFs and others) can be downloaded here.
Bug Fix: JangoMail for Salesforce Personalization Fields
The error resulted in problems with personalization fields not properly matching during sending.
This is now fixed. As a result of the change we have made, some personalization syntax has changed slightly. Before, when you pulled from Contacts, Leads, or Campaigns, the fieldnames would have "Contact." or "Lead." prefixing the actual field's name. So "Contact.FirstName" and "Contact.LastName" for example were the field names. As a part of this fix, the field names are no longer prefixed by the table name. These would simply now be "FirstName" and "LastName" alone.
Tuesday, August 05, 2008
New Feature: Pre-Process Campaigns Now
Every JangoMail campaign starts with "pre-processing," the period where the system creates your final recipient list and assigning your campaign to our bank of senders. We start with building the list of all addresses to which you are attempting to send your message. Then, we cross-check that list for unsubscribes, bounces, duplicates, and invalid addresses.
If you will not be sending your campaign "Now," but at a later date, you can now elect to go ahead and let this pre-processing step take place now so that when the time comes to send out the campaign itself, there won't be any time spent waiting on pre-processing to complete.
How do you use this feature? When you schedule your campaign, just check the box to pre-process now.
Why would this benefit you? If you are sending to a large number of recipients (hundreds of thousands) and/or to a large number of Groups, this period can extend to several hours, based upon the amount of work the system must do to generate your final recipient list.
Friday, August 01, 2008
Security Update: Enhanced Action Logging
If you suspect that an unauthorized person (former employee, unauthorized employee, etc.) has been accessing your account, it will be easier to track.
From a support perspective, your support team can now review the logs to see what path you've taken as you've navigated through the site on your task -- so we can see where you've been and where you need to be!
Thursday, July 24, 2008
Group Scrub Tool Expanded
Concerned that a Scrub might not do what you expect? Now, get a Scrub report without actually changing any data. Use the new option at the top of the Scrub Group Members page to elect a View Only scrub.
Wednesday, July 23, 2008
Enhancements to Reporting: Click Tracking All Positions
Previously, Click Tracking reports sorted by URL would show Click Tracking data separately for each position of a URL within a message. If your URL appeared 3 times in a message, the Click Tracking data would be split among the positions, so you could see which position achieved the best results.
Now, in addition to the data split by position, we have included additional columns for Total Clicks All Positions and Unique Clicks All Positions so that you can quickly gauge interest in a particular link, regardless of its page position as well.
Tuesday, June 24, 2008
Bug Fix: Plain Text Preview
We have made two adjustments to the processing of the plain text message for Preview. These issues were NOT affecting campaigns that were actually sent ("Send E-mail" button), but only the Previews.
- The From Address will no longer show a 4 digit numeric extension. Ex: browniekitchen0042@jangomail.com will now show simply as browniekitchen@jangomail.com.
- When Click Tracking is enabled for the campaign, but disabled for the plain text version of the message, the additional tracking code will no longer show in the Preview version either. A link in plain text of http://www.browniekitchen.com will remain unchanged.
New Administrative Watch Feature
This allows us to watch over your messages as you explore new features or as we may be assisting you with troubleshooting any concerns with message processing as the message is actually going out. When your Support representative sets the Alert, he/she will be notified by email when a campaign that meets the Alert's settings has been sent. The JangoMail user will not notice any change in how he/she sends, and the Support team can watch the campaign move through each step of the sending process closely.
Thursday, June 12, 2008
Group Merge Available in Exported Reports
If you have sent a campaign to a JangoMail Group, you will be able to select that Group during export to see the list of data in the report, along with the data that was originally stored along with the email address in your Group.
Let's do an example:
- A campaign is sent to a Group containing the following data:
emailaddress, customerID, firstname
jane@doe.com, 12345, Jane
smith@yahoo.com, 12346, Bob - The Unsubscribes report shows that Jane unsubscribed, and we export that report.
- With a standard export, the email address would be included in the report, along with the date and time the address unsubscribed (jane@doe.com, 06/13/2008 01:00:00 PM).
- If the export is Merged with the original Group that received the message, the report would include the email address, the date and time of the unsubscribe, the customerID, and the firstname (jane@doe.com, 06/13/2008 01:00:00 PM, 12345, Jane).
This feature is most often used when exported data needs to be synchronized locally to other stored data. In the example above, we could then update Jane's information easily because we had her customerID -- and that is how our system tracks her.
Wednesday, June 11, 2008
User-Agent Identification Added
The JangoMail User-Agent will report as: JNHTTP
Customers examining their web logs will now be able to identify JangoMail's connections to their servers.
Tuesday, June 10, 2008
Technical Notes: Using the JangoMail API with Java
Robert Fischer is the creator of OffstageArts, an open source integrated arts management system (http://offstagearts.org). OffstageArts is written in Java and deployed via Java WebStart. Mr. Fischer has graciously provided notes on his solution for us to post so others can follow in his footsteps. Many thanks to Robert for sharing his work with us!
Using JangoMail with Java
The most convenient way to use JangoMail with Java is to use Java-based SOAP tools. Apache Axis (http://ws.apache.org/axis/) is available as a commponly used Java SOAP system. Although these tools can be intimidating at first, they make life much easier over the long run. Moreover, using them does not require much effort, just follow the steps below.
Axis is able to download the JangoMail WSDL web service description file and generate a set of JangoMail Java stub classes from it. You can then compile those classes and use them in your application. The JangoMail SOAP stub classes (generated by Axis) insulate you from the complexities of SOAP XML. An example of using these classes:
-------------------------------------------
// Make a service
JangoMail service = new JangoMailLocator();
// Now use the service to get a stub which implements the SDI.
String usr = "JangoMailUserName";
String pwd = "JangoMailPassword";
JangoMailSoap soap = service.getJangoMailSoap(new URL(https://api.jangomail.com/api.asmx));
soap.addGroup(usr, pwd, "TestGroup");
-----------------------------------------------
Doing It -- Automated
The easiest way to go through this process is to use the enclosed Netbeans/Maven project. For this, you will need NetBeans with the Maven Plug-in. If you do not have that, it can be obtained at: http://netbeans.org/ and then by following directions at: http://mevenide.codehaus.org/m2-site/mevenide2-netbeans/installation.html
With NetBeans+Maven, you are now ready to go:
- Download and unzip the accompanying project from the following link, and open it in NetBeans: Download here.
- Edit the file RunWsdl.java and make sure the variable "mavenProjectRoot" is set correctly for your project home directory.
- Right-click on the project and select "Run." This should download the WSDL file and generate all the necessary Java classes in the project.
- Right-click on the project and select "Clean and Build." This will compile the Java classes you just produced. Look at Test.java for a simple example on how these classes can be used.
This procedure has now produced a file "jangomail-1.0-LATEST.jar" that you can use in other projects. If your other projects are Maven- based, you can use the dependency:
groupId = com.jangomail
artifactId = jangomail
version = 1.0-LATEST
When the JangoMail API changes, you must re-run this procedure to make the updates available to your application.
Doing It -- Manual
If you do not have NetBeans + Maven, then you will need to download Axis and run it manually:
- Download Apache Axis from http://ws.apache.org/axis/
- Put all the jar files in Apache Axis on your CLASSPATH.
- In a command shell, change directory to your source directory.
- Run the command:
java org.apache.axis.wsdl.WSDL2Java https://api.jangomail.com/api.asmx?WSDL - Compile the source code that results.
Tuesday, May 27, 2008
JangoMail for Salesforce official release
A press release will be sent to media outlets this morning, and and we'll be sending an email announcement to all of our clients later this week.
Wednesday, May 21, 2008
Visual Metrics Now in Click Tracking
(click to see full size image )
At a glance, you can now see your message and exactly how each link is performing!
How do you turn on the feature? When reviewing your Click Tracking detail report for a campaign, click the Visual Overlay button to bring up the new layout option.
Want to see detail on a particular link? Hover over the percentage to pop up its full metrics too.
Open and Click Tracking Now Capture IP
This is how Opens will look in Reporting:
This is how Clicks will appear in Reporting:
Tuesday, May 20, 2008
Historical Tracking Now Available for Group Members
Want to know what you've sent to a particular recipient recently? Have they opened or clicked links in your messages?
With our new Historical Tracking feature, you can now see your activity history for an individual address stored in a JangoMail Group.
To pull up the history go to Groups and E-mail Addresses and select your Group. Within the Group, select the desired address to display that subscriber's details in the right hand panel. At the top of the details screen, click to View historical tracking information for this person.
The detailed report will display to show you the 30 day history. You can use the dropdown to go back 60 and even 90 days for the recipient.
Friday, May 16, 2008
API enhancement allows sending email campaign with on-the-fly personalization data
Traditionally, when using the API to send a personalized email campaign, you would have to first create a Group with AddGroup, then add or import members to the Group with AddGroupMember or ImportGroupMembersFromData, and then send to the Group with SendMassEmail. You can still do this if you prefer, but now there's an easier way as well. The following methods are affected:
Sends a mass e-mail with a plain text and/or HTML e-mail. Returns a string.
New method. Sends a previously saved mass e-mail to a new set of recipients. Returns a string.
Sends a mass e-mail, given a raw message including MIME parts and a MIME boundary. Returns a string.
To pass in personalization data, use the ToOther input parameter to pass in the actual set of data. The set of data can be in comma-separated form or in any other row and column delimited format that you choose. You may use whatever row and comma delimiter you like for the data in ToOther. The ToOther parameter should only contain the data, and not the field names for the data.
Use the Options input parameter to specify the field names and the row and column delimiters for the data in ToOther. The Options parameter is a comma-delimited list of attribute/value pairs. The attributes relevant to this feature are:
ToOtherRowDelimiter
ToOtherColDelimiter
ToOtherFieldNames
You can use these character codes for their corresponding delimiters:
"c" represents a comma
"s" represents a space
"n" represents a newline, or a hard break
"t" represents a tab
The ToOtherFieldNames attribute must be a pipe (|) delimited list of field names corresponding to the data in ToOther.
Let's do an example!
I want to send a personalized email campaign to 3 people, and I want to use First Name and Last Name as additional personalization data.
ToOther=
John,Smith,john@smith.com|David,Gary,david@gary.com|Sheila,
Panther,sheila@panther.com
Options=
ToOtherRowDelimiter=|,ToOtherColDelimiter=c,
ToOtherFieldNames=FirstName|LastName|EmailAddress
Subject=
Hello %%FirstName%%
MessagePlain=
Hello %%FirstName%% %%LastName%% -- your email address is %%EmailAddress%%
Wednesday, May 07, 2008
JangoMail's Integration with Salesforce® is here!
If you have a JangoMail account and want to install it into your Salesforce® account, you can Get It Now.
This is a private link because we're not officially listed on the Salesforce® AppExchange® yet, but we will be in 2-3 weeks after they review and certify us.
If you don't yet have a JangoMail account, you can create one for free once you install "JangoMail for Salesforce®" into your Salesforce® account.
For now, this will only work if you have the Enterprise or Unlimited editions of Salesforce®. After we become officially listed on the AppExchange®, even Professional edition users can use our integration.
What can you do with JangoMail for Salesforce®?
- Create, send, and track targeted email campaigns to your Contacts, Leads, and Campaigns. Send one-off emails to just a single Contact or Lead, send to selected Contacts or Leads based on criteria that you define, send to all of your Contacts or Leads, or send to a pre-defined Salesforce® Campaign. And you can do all of this from with custom JangoMail buttons within your Contacts, Leads, and Campaigns tabs.
- Unparalleled real-time Reporting capabilities, allowing you to track opens/clicks/bounces/unsubscribes/forwards and activity through your web site
- Rendering: See exactly what your email looks like in Yahoo, GMail, AOL, and other email clients before sending
- Historical tracking by recipient. Click on a Contact or Lead and see exactly what email campaigns have been sent to them, and actions (opened/clicked/etc.) that Contact or Lead took.
Tuesday, April 15, 2008
New Features for Mass Email Initiations
New enhancements to this feature allow you to:
- Have a word or phrase automatically pre-pended to the Subject of the email campaign.
- Have JangoMail authenticate the email by the From Address rather than by looking for [password-send] in the Subject line.
- Encompass the message as received within a pre-defined template. For example, if you wish to send a simple text message from your Blackberry, and have that text message inserted into a more aesthetically pleasing template before the email message is sent to Group members, you can now do that.
Monday, April 14, 2008
New Super Reporting Features
1. Numbers now have commas in them, when greater than 3 digits.
2. The Filter box at the top of each report will now clearly indicate when a Filter is in effect. This will eliminate confusion when only certain rows of the Report are displayed due to a previously-set filter.
3. The Campaign Details page now shows all of the individual properties of the e-mail campaign. Here's an example:
4. Under the Recipients section, the Actions report now has a "Bounced" column:
5. Under the Recipients section, there is a new "By Domain / Actions" report:
Tuesday, April 08, 2008
Salesforce.com Integration, Phase I
To use this feature, your Salesforce.com account must allow API access. Salesforce.com Enterprise and Unlimited edition accounts have API access turned on by default, but API access is also available for Professional edition a la carte.
From JangoMail, click the Extract from My Database tab, and then click on the Connect to Salesforce.com button.
Below is a screenshot:
Monday, April 07, 2008
Feature Enhancement: Web database connections now support HTTPS
The form where you specify the URL for the special script file now contain a drop-down where you can specify http:// or https://.
See the below screenshots:
Saturday, April 05, 2008
New Feature: Click Tracking Enhancement
You can choose to append personalization variables to the destinatinon URL by going to My Options --> Click Tracking.
Below is a screenshot:
Here's an example. If your e-mail campaign links to http://www.browniekitchen.com/WelcomeVisitor.html, then the e-mail recipient's browser will go to the following when the link is clicked:
If box is unchecked:
http://www.browniekitchen.com/WelcomeVisitor.html
If box is checked:
http://www.browniekitchen.com/WelcomeVisitor.html?
MassEmailID=24343243&email_id=98434&emailaddress
=john@doe.com&FirstName=John&LastName=Smith&
submission_date=1/1/08&confirmed=True
Therefore, checking the box allows you to program your web page to display a personalized message to the recipient based on the variables in the URL.
Open Tracking Bug Fix
Therefore, we have modified the 1-pixel "dot" to be a transparent GIF rather than a white GIF.
Friday, April 04, 2008
New Feature: Set your own notification preferences
- Sending Complete notifications
- Import Complete notifications
- Scrub Complete notifications
Below is a screenshot:
Saturday, March 15, 2008
New Security Feature
JangoMail will notify the account holder if more than 5 failed login attempts are made within a 30 minute period.
In such cases, the account holder will receive an e-mail like the following:
Subject: JangoMail: Security Alert -- 6 Failed Login Attempts (browniekitchen)
Message:
Dear Kim Cook,
Your account has had a high number of failed login attempts in the last 30 minutes. We are notifying you of this in case you are unaware of this and someone is trying to gain access to your account. If you have a weak password, please change it now by logging into your account and going to the Account Info tab.
Please direct any questions to https://www.jangomail.com/Support/.
Sincerely,
The JangoMail Administrator
https://www.jangomail.com/Support/
http://www.jangomail.com
1-888-709-4099 or 614-343-3864
Lastly, in cases where someone has gained unauthorized access to an account, a simple password change will disable all sending ability of the unauthorized user. Previously, if two or more machines were logged into the same JangoMail account, and the user of one of the machines changed the password on the account, the logged-in user of the second machine could continue using the JangoMail account. Now, when the first user changes the password, the second user will be automatically logged out as soon as he attempts to send anything.
Wednesday, March 05, 2008
New Reporting Enhancements
- The ability to set a local Time Zone, and have all Reporting date/times be localized to your time zone. The only exception is the timestamps that appear in SMTP log files, which will always be on GMT time.
- The ability to turn the AJAX screen refresh feature off. AJAX allows your browser to update reporting statistics on the main campaign summary page or on a campaign detail page right before your eyes, without refreshing the page in the browser. Recently, some customers have requested the ability to turn this feature off.
- The times on the main campaign summary page are now in 24 hour format, making it easier to tell whether a time is in the AM or PM.
- Filters on reports are now memorized, so that the same filter will apply the next time you load the report. For example, if you go to the main campaign summary report, and you set the Job Type filter to be All, then log out and back in, when you go back to the Reporting tab, the report will default to Job Type=All.
Monday, March 03, 2008
Improvements to Google Analytics Integration
utm_source (previously set to "JangoMail")
utm_medium (previously set to "Email")
utm_content (previously set to recipient's email address)
utm_campaign (previously set to campaign Subject followed by campaign ID number)
Previously, these four variables would be set for you by JangoMail, but now you can customize the values of these variables by using certain parameters. The parameters available for use are:
%%Subject%% (subject of your e-mail campaign)
%%CampaignID%% (numeric identifier for your campaign)
%%EmailAddress%% (recipient e-mail address)
Monday, February 25, 2008
New Bounce Handling Options
History:
Prior to switching our SMTP platform in March of 2007, JangoMail was using the Microsoft SMTP service to send e-mails. The MS SMTP service e-mailed back bounced messages to the address used in the MAIL-FROM part of the SMTP transaction. When we switched to our custom JangoMail SMTP Service in March 2007, this functionality disappeared, and instead all bouncebacks were stored in our database, rather than e-mailed back to the sender.
Now:
Under Settings --> Reply Management --> Bounce Handling, you can now specify whether bouncebacks should be e-mailed or not. You can choose to have bouncebacks:
- E-mailed back to the From Address on the e-mail campaign
- E-mailed to a different designated e-mail address
- E-mailed to both.
Thursday, January 31, 2008
A better "My Options" menu
Tuesday, January 29, 2008
Bug Fix: Group fields with dashes in it were not searchable
For example, if your field name was "First-Name", and you were searching for all records where "First-Name" was equal to 'John', this would previously fail. This issue has now been corrected.
Wednesday, January 23, 2008
JangoMail Launches Integration with Google Analytics
While we haven't officially announced this yet, it is available for you to use - our integration with Google Analytics. Google Analytics is a free web site analytics tool that tracks the success of your web site by measuring page views, landing pages, exit pages, funnel paths, conversions, and provides this data to you in various formats as well - raw data, as a map overlay on the world, or as a graphical overlay on top of your web site.
JangoMail's integration with Google Analytics allows you to track the success of your web site specifically after you send a mass e-mail campaign to your recipients through JangoMail.
JangoMail has always provided its own built-in web analytics tool - we simply refer to it as Web Site Activity Tracking, and you can learn more about it in this PDF tutorial.
Now, with our integration with Google Analytics, you can use both -- JangoMail's built-in analytics tool and Google Analytics -- for the best of both worlds.
How to do it
There are a few simple steps to get started with JangoMail and Google Analytics.
- To setup a free Google Analytics account, go to http://www.google.com/analytics/.
- Add the Google Analytics JavaScript code to all pages of your web site that you want tracked.
- Turn Google Analytics on in your JangoMail account by logging in, going to My Options --> Google Analytics.
- Make sure you enable Click Tracking on all of your outbound e-mail campaigns.
utm_source (set to "JangoMail")
utm_medium (set to "EmailMarketing")
utm_content (set to the recipient's email address)
utm_campaign (set to the Subject of your campaign plus the JangoMail Campaign ID in parentheses after the Subject)
For example, if your e-mail campaign links to http://www.silicomm.com then if you enable Click Tracking and you turn on Google Analytics under My Options, when a recipient of your email clicks the link to http://www.silicomm.com, he will actually be taken to:
http://www.silicomm.com/?utm_source=JangoMail&utm_medium=
EmailMarketing&utm_campaign=This+is+just
+a+test+campaign%2878964283%29&
utm_content=ajay%2Egoel%40silicomm%2Ecom
We recommend using JangoMail's inherent Activity Tracking feature in conjunction with our integration with Google Analytics. You can turn on Activity Tracking in your account by going to My Options --> Activity Tracking. Doing so will add two additional parameters to your destination URL (jmid and j):
http://www.silicomm.com/?jmid=1&j=78964283
&utm_source=JangoMail&utm_medium=
EmailMarketing&utm_campaign=This+is+just
+a+test+campaign%2878964283%29&
utm_content=ajay%2Egoel%40silicomm%2Ecom
JangoMail Analytics vs. Google Analytics
Note that JangoMail's Activity Tracking feature works by placing a one-line img tag at the bottom of all of your web pages, while Google Analytics works by placing several lines of JavaScript at the bottom of all your web pages.
Tuesday, January 22, 2008
JangoMail is on the Habeas SafeList!
Here is Habeas's 2 page PDF document on the benefits of being on the SafeList:
http://www.habeas.com/fileadmin/resources/Habeas_SafeList_DS.pdf
Below is a chart summarizing delivery rate improvements in Habeas SafeListed senders:
In addition to the JangoMail shared pool of IP addresses being added to the SafeList, any emails sent through a SafeListed IP address will have these additional headers added to the e-mail message:
Accreditor: Habeas
X-Habeas-Report: Please report use of this mark in spam to http://www.habeas.com/report/
Monday, January 21, 2008
New Bounce Methods for API/Web Service
GetBounceListAll2
Gets the list of all e-mail addresses that have bounced at least once since the specified date. Includes SMTP Diagnostic Code and Definitive columns. Returns a string.
GetBounceListNormal2
Gets the list of e-mail addresses that have bounced X times since specified date, where X is a configurable parameter in your account. Includes SMTP Diagnostic Code and Definitive columns. Returns a string.
GetBounceListNormal_IncludePast2
Gets the list of e-mail addresses that have bounced at least X times in total, and at least once since specified date. X is a configurable parameter in your account. Includes SMTP Diagnostic Code and Definitive columns. Returns a string.
Reports_GetBouncesByCampaign_DataSet2
Retrieves list of bounced addresses for a particular mass e-mail campaign. Includes SMTP Diagnostic Code and Definitive columns. Returns a .NET DataSet.
Reports_GetBouncesByCampaign_String2
Retrieves list of bounced addresses for a particular mass e-mail campaign. Includes SMTP Diagnostic Code and Definitive columns. Returns a string.
Reports_GetBouncesByCampaign_XML2
Retrieves list of bounced addresses for a particular mass e-mail campaign. Includes SMTP Diagnostic Code and Definitive columns. Returns an XML document.
Thursday, January 17, 2008
Super Reporting in Beta
It's here! Login to your account, go to Reporting, and then click the link to try our new Super Reporting (Beta) and get these enhancements:
- Deliverability reports by domain
- AJAX-based campaign summary report with statistics that update right before your eyes, without refreshing your browser.
- All reports are searchable
- Bars, charts, and graphs
- View metrics never seen before - like complaints per campaign, mailbox-full messages per campaign.
- Self-diagnose deliverability issues by viewing the actual SMTP log file for any recipient for any campaign.
- Time based reports showing opens/clicks/unsubscribes/bounces/page views hour by hour or day by day after a campaign launch
- A Recipient Action summary report showing whether each recipient opened/clicked/unsubscribed/bounced/forwarded...all in one report.
- Bounces now show the SMTP bounce code.
- View the processing log for a campaign, showing how your campaign was processed from start to finish.
- Click tracking broken down by HTML clicks vs. plain text clicks.
Note: You can always switch back to the "Classic Reporting" interface.
Wednesday, January 16, 2008
New Feature: Personalizing Subject/Message with the Campaign ID
To use the JangoMail-assigned campaign ID, use the variable %%MassEmailID%%. To use a custom-assigned campaign ID, use the variable %%CustomMassEmailID%%. Custom campaign IDs can be assigned by filling out the Campaign Identifier field on the Send E-mail page.
This feature may be useful if you want to tag links with campaign IDs for your own internal tracking/reporting system.