Get Started with the Mobile App Performance SDK

The Akamai Mobile App Performance software development kit (MAP SDK) helps you build the best possible mobile experience for your Android and iOS users. The SDK effectively extends Akamai's intelligent edge platform all the way to the mobile device, allowing developers to customize and deliver superior app experiences using caching, network awareness, and last-mile optimization technologies.

MAP SDK helps create seamless mobile experiences when connection speeds are slow (or even unavailable) by intelligently pre-positioning content on the mobile device. The SDK also provides you with network performance statistics from real user app usage, time to first byte, and total download time for requests (e.g., APIs, images, etc.) by domains. In addition, MAP SDK helps create custom events to ensure that your most important app features are not impacted by network latency. These features allow developers to not only achieve and maintain peak app performance, but also to tune mobile experiences over time.

The features of MAP SDK can be grouped into three main categories as listed below: network optimization, caching/payload reduction, and performance monitoring.

Group Feature Description
Network Optimization Adaptive Network Optimization Optimizes the TCP profile to improve time to first byte and total download time of objects. This is not configurable, but part of the MAP SDK.
SureRoute for Cellular Two lookups race against each other to determine a primary and secondary path to the Akamai Edge. The winning path is used for subsequent requests for up to 20 seconds. Improves performance and reliability of requests.
QUIC (beta) End to end implementation of the low-latency Internet transportation protocol
Network Awareness Determines real-time network quality and makes it available via an API. Use knowledge of the current network conditions to tailor the app experience.
Image Manager Delivers images optimized for the device and viewing areas.
Brotli Compression Brotli can improve performance by reducing the number of bits transferred.
Cache Control Contextual Pre-Positioning Proactively downloaded Images, videos, and other static content to the user’s device when connectivity is available and congestion is low
Universal Cache Browser-like caching within your mobile app (Images & API) to improve performance, reliability and to reduce network calls.
Pre-Caching (Beta)

Pre-fetch objects in foreground based on Machine Learning and Analytics for better performance.

Performance Monitoring Event Monitoring Define User Experience centric events and monitor performance impact on the App experience.
A/B Testing Turn features on and off for a percentage of users to measure the latency improvement, and to phase the rollout of enhancements, or set a percentage of users with all enabled features to compare against a holdout group of users.
mPulse Plug-In (Beta)

Plug In-App performance data to your mPulse DPM Dashboard with no additional effort or SDK.

Goals

  • Create a new policy app from Akamai Control Center.
  • Download MAP SDK and include it in your app.
  • Register the SDK and start using it.

Prerequisites

You must be an Akamai Ion customer to use this SDK. If you are not an Ion customer, please reach out to us at specialist@akamai.com

Step 1: Activate MAP SDK from Marketplace

  1. Log in to the Akamai Control Center at https://control.akamai.com/.
  2. In the top-right corner, click Marketplace.Log in to Marketplace
  3. From the list, choose Web & Mobile Performance.Choose Web and Mobile Performance
  4. Click the tile for Akamai SDK - Mobile App Performance.Click the tile
  5. In the Get for free section, click Add.Click Add
  6. Select a contract under which you would like to activate Mobile App Performance SDK (MAP SDK is a part of Ion and hence can be activated for free under any contract with Ion).
  7. Follow through by accepting the terms & conditions and click Add to contract.Accept terms and conditions

You should receive an email shortly confirming MAP SDK activation for your Akamai account.

Step 2: Create a New Policy App from Control Center

  1. Start by navigating to Akamai Control Center at https://control.akamai.com/.
  2. Click on the hamburger menu located at the top left corner.Click the menu
  3. Click on Mobile app SDK.Select Mobile app SDK
  4. Click the Add a new App tileAdd a new app tile
  5. Fill in a name for your app config along with the iOS Bundle ID and/or Android Package Name. These are the only two fields that are mandatory.Add app
  6. Scroll down and click Save Changes. You will receive a confirmation once the settings have been saved.
  7. Click back to return to Mobile App Performance SDK config page and now you should be able to see your app config.
  8. Click on the drop-down arrow to copy your license key or to download the SDK manually.Click back

Step 3: Integrate/Configure the SDK

Use the links below to download MAP SDK and integration guides/documentation for iOS and Android

SDK name

Download link

Documentation link

iOS SDK (Objective-C, Swift)

Click for SDK

Click for documentation

Android SDK (Java)

Click for SDK

Click for documentation

The tables below clarify the size of MAP SDK along with other optional packages.

Android

Library Name

Size (MB)

map-sdk*.aar (MAP SDK core)

0.55

mPulse*.aar (optional)

0.27

*.Cronet*.aar (optional)

3.72

*.brotli*.aar (optional)

0.10

Total download size

0.55 - 4.63 depending on usage of optional libraries

iOS

Framework Name

Fat size in SDK (MB)

arm64 size
on device (MB)

armv7 size
on device (MB)

VocSdk (MAP SDK core)

20.5 (includes bitcode)

2

1.7

mPulse (optional)

137.2 (includes bitcode)

3

2.4

Cronet (optional)

14.7 (no bitcode)

3.9

3

Total download size

 

2.0-8.9 depending on usage of
optional frameworks

1.7-7.1 depending on usage of optional frameworks

Once you integrate MAP SDK, you can learn all about all the features and configuration settings in our MAP SDK Configuration Guide.