Getting Started with Mobile App Performance (MAP) SDK

Enhance App Performance
Prabhu, Karthik

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 the 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 the 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

 

Note: Ignore steps 1 and 2 if you are an existing user of Mobile App Performance SDK and are upgrading from an older version to 20.32. (Steps 1 and 2 are only for first time users who have not yet activated or created an app policy).

 

  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 the 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 the 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 the 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. Use our Maven repository or Cocoapods to ensure you get the latest release of the SDK.MAP License

     

 

Step 3: Identify the MAP SDK app policy responsible for optimizing your app performance

 

  1. Start by navigating to the Akamai Control Center at https://control.akamai.com/

  2. Click on the hamburger menu located at the top left corner.

    Hamburger Menu

     

  3. Click on “Mobile App SDK

    Mobile App SDK

     

  4. Click on the drop-down arrow and then click on “Copy SDK License Key”.

    Copy License

     

  5. Compare the license key copied from Akamai Control Center with the one being used in your app project.

  6. If you have more than one app config, please review and confirm the association by comparing each license key against the one being used in your app project. We usually recommend developers to maintain at least two configs per-app connecting to production and development environment. This would allow you to test changes in development before applying the same in production.

  7. Click on the drop-down arrow once again and this time click on “Edit App Config”. This screen will show you all the optimizations enabled through MAP SDK. To understand more about each configuration/optimization along with steps involved to enable/disable please go through our Configuration Guide.

  8. If you are a first time user and do not see “Mobile app SDK” an app config, refer to steps 1 and 2.

Step 4: Integrate/Configure the SDK

 

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

SDK Type

Download link

Download link

iOS SDK (Objective-C, Swift)

Click for Configuration Guide

Click for Integration Guide

Android SDK (Java, Kotlin)

Click for Integration Guide

Read our configuration guide to understand more about the features of Mobile App Performance SDK and how to enable/disable them along with instructions on how you could leverage analytics to validate functionality.

Integration Guides cover steps on how to download and implement MAP SDK by platform.