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 Adaptively modify TCP/IP and network parameters based on user network conditions to maximize throughput.
SureRoute for Cellular Improve performance and reliability of requests by determining alternate servers with less latency.
QUIC (beta) This is an end-to-end implementation of the low-latency Internet transportation protocol.
Network Awareness Get better visibility into end-user network conditions to tailor the user experience.
Caching / Payload Reduction Contextual Pre-Positioning Proactively download images, videos, and other static content to the user’s device when connectivity is available and congestion is low.
Universal Cache

Get browser-like caching within your mobile app (images and APIs) to improve performance and reliability and to reduce network calls.

Pre-Caching (Beta) Pre-fetch objects in foreground based on machine learning and analytics for better performance
Brotli Provides compression support on Android to improve performance by reducing the number of bits transferred.
Performance Monitoring Event Monitoring Define user-experience-centric events and monitor their performance impact on the app.
A/B Testing Turn features on and off for a percentage of users to measure the latency/improvement. This helps monitor, optimize, and validate enhancements applied.
mPulse Plug-In (Beta) Add app performance data to your mPulse digital performance management dashboard with no additional effort or SDK.

Goals

  • Create a new policy app from Luna.
  • 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 Luna 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 Luna

  1. Start by navigating to the Luna Control Center at https://control.akamai.com/.
  2. Under the Configure tab, click Mobile App Perf SDK. This will take you to the page where you can view the existing policies, and create new ones as well.
  3. Click Add a new App.Click Add new App
  4. On the New App page, fill in details about the app (e.g., its name, its package ID, or its bundle ID.Add app
  5. Optionally, upload your Apple Prod/Dev APNS certificates and/or Google FCM Key. These keys allow Akamai to push changes to the devices that use the SDK.Upload keys
  6. Click Save Changes to save and complete your app configuration.
  7. To use the SDK in the app, you’ll need to initialize it with a license key in your app code. To get the license key, select Copy SDK License Key. This key will be common to both the iOS and Android apps for the given package or build ID name. You’ll use this key in a minute.
  8. Now, click the Actions drop-down list and select the SDK for Android or iOS. This will download a zip file that contains the SDK itself, integration guides, and sample codes.

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.