From an API point of view, our mobile email tests work exactly the same way to our regular email tests. The new mobile email clients are simply additional 'Testing Applications' that we've added. You'll access them using the exact same API calls. The mobile results are returned amongst your regular email test results, and consist of URLs to the screenshots.

 

However, there is one crucial difference. Mobile email tests are interactive - in some cases even animated. We use a handful of different image files, some CSS magic, and a touch of Javascript to achieve this. In order to include these types of results in your application, you'll need to add our Javascript to your site, and load in our HTML/CSS code rather than just the screenshot image. We've tried to make it as easy as possible for you to do, and there is a full code sample to download below.

 

Before you can perform live mobile tests, your API account will need to be activated for mobile email tests. Please contact your account manager to request mobile testing be added to your account.

 

 

Code sample

 

In this sample you'll find the client-side code for each mobile email client. These examples show a bare-bones implementation of displaying a mobile result.

 

Note that each mobile device requires different client-side (HTML/CSS/JS) code. Your application should check which mobile device is being viewed and serve up the appropriate client-side code. A list of mobile devices and their associated Application IDs can be found at the end of this document.

 

Sample HTML, CSS, Javascript as well as transparent devices images can be found at: https://github.com/litmus/litmus-mobile-samples

 

 

What are the Application IDs and OS details for these mobile devices?

 

Phone model Operating System Mail Client Application ID

HTC Wildfire

Andrid 2.3 (Gingerbread) default android23
Samsung Galaxy Nexus Android 4.2.2 (Jellybean) default android4
Samsung Galaxy Nexus
Android 4.2.2 (Jellybean)
Gmail App androidgmailapp
Blackberry 8900 BlackBerry OS 4.5 (plain text) default blackberry8900
Blackberry Curve Blackberry OS 5 (HTML) default blackberryhtml

iPhone 4S

iOS 6 default iphone4
iPhone 5 iOS 6 default iphone5
iPhone 5S iOS 7 default iphone5s
iPhone 6 iOS 8 default iphone6
iPhone 6+ iOS 8 default iphone6plus
iPad (Retina) iOS 7 default ipad
iPad Mini iOS 7 default ipadmini
Nokia N96 Symbian S60 default symbians60
Nokia Lumia 810 Windows Phone 8 default windowsphone8

 

 

Questions?

As usual, please direct all technical questions to resellers@litmus.com, so that you can speak directly with a member of our development team.