Amazon Mobile Analytics - User Guide

1 Amazon Mobile Analytics user Guide Amazon Mobile Analytics user Guide Amazon Mobile Analytics : user Guide Copyright 2018 Amazon Web Services, Inc. and/or its a liates. All rights reserved. Amazon 's trademarks and trade dress may not be used in connection with any product or service that is not Amazon 's, in any manner that is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon . All other trademarks not owned by Amazon are the property of their respective owners, who may or may not be a liated with, connected to, or sponsored by Amazon . Amazon Mobile Analytics user Guide Table of Contents What Is Amazon Mobile Analytics ? .. 1. Incorporating Mobile Analytics .. 1. Using the Mobile SDK .. 2. Mobile Analytics Pricing .. 2. Migrating to Amazon Pinpoint .. 4. Migrating from Auto Export .. 5. Step 1: Create a Delivery Stream .. 5. Step 2: Enable Event Streaming .. 7. Step 3: Disable Auto Export .. 8. Migrating to the Mobile SDKs or JavaScript Library.

2 8. Step 1: Look Up Your Project ID .. 9. Step 2: Integrate SDKs or JavaScript Library .. 9. Step 3: Enable Analytics .. 10. Step 4: Delete the Project That Mobile Hub Created .. 10. Step 5: Update Your App Con guration .. 10. Step 6: Update the IAM Role .. 11. Step 7: Build and Test .. 12. Migrating to the Amazon Pinpoint API .. 12. Migrating O of the Mobile Analytics Querying API .. 12. Migrating to the Amazon Pinpoint Console .. 16. Getting Started .. 17. Step 1: Sign Up .. 17. Step 2: Follow the Steps to Add an App .. 17. Step 3: Integrate Mobile Analytics in to Your App .. 17. Step 4: Review the Data in Amazon Mobile Analytics Reports .. 18. Adding and Managing Apps .. 19. Accessing Mobile Analytics .. 19. Adding an App .. 19. If You Have No Existing Identity Pools .. 19. Adding Additional Apps with the Default Cognito Identity Pool .. 22. If You Have Existing Identity Pools but No Default Cognito Identity Pool .. 24. If You Have Existing Identity Pools and a Default Cognito Identity Pool.

3 27. Renaming an App .. 29. Viewing Integration Steps .. 30. Using the Mobile SDK .. 32. Platforms Supported by the Mobile SDK .. 32. Enabling SDK Logging .. 32. Enabling Logging for iOS Apps .. 32. Enabling Logging for Android Apps .. 33. Enabling Logging for JavaScript Apps .. 33. Enabling Logging for Unity Apps .. 34. Enabling Logging for Xamarin Apps .. 34. Identifying the App .. 34. Managing Sessions .. 34. Managing Sessions in iOS or Android Apps .. 35. Managing Sessions in JavaScript Apps .. 35. Managing Sessions in Unity or Xamarin Apps .. 36. Generating Events .. 36. Creating a Monetization Event .. 37. Creating a Custom Event .. 39. Adding Attributes and Metrics .. 41. Reporting Detailed Data Points .. 41. Adding Attributes and Metrics in iOS or Android Apps .. 41. Adding Attributes and Metrics in JavaScript Apps .. 42. iii Amazon Mobile Analytics user Guide Adding Attributes and Metrics in Unity or Xamarin Apps .. 42. Submitting Events .. 43. Submitting Events in iOS Apps.

4 43. Submitting Events in Android Apps .. 43. Submitting Events in JavaScript Apps .. 44. Submitting Events in Unity or Xamarin Apps .. 44. Using the REST API .. 45. Identifying the App in Mobile Analytics .. 45. Tying Analytics to Users .. 45. Managing Sessions .. 46. Users Engage in Sessions .. 46. Collecting KPI Data .. 46. Starting a Session .. 46. Stopping a Session .. 47. Generating Events .. 48. Types of Analytics Events .. 49. Session Events .. 49. De ning a Monetization Event .. 49. Creating a Custom Event .. 51. Adding Attributes and Metrics .. 52. Reporting Detailed Data Points .. 52. Adding Attributes .. 52. Adding Metrics .. 53. Providing a Client Context .. 53. Giving Details of Application Context .. 53. Signing Requests .. 54. Submitting Events .. 54. Event-Based Interaction .. 54. Querying Analytics Data .. 55. Setting IAM Policy .. 55. Getting a List of Apps .. 56. Querying KPIs .. 57. Querying Custom Events .. 62. Using a ResultSet .. 74. Filtering Query Results.

5 75. Reports Overview .. 77. Toolbar .. 77. Using the Console Reports .. 77. Filtering Data Shown by Date Range .. 77. Selecting the Platform Displayed .. 78. Overview Tab .. 79. Active Users Tab .. 80. Sessions Tab .. 80. Revenue Tab .. 81. Retention Tab .. 82. Custom Events Tab .. 83. Working with Charts .. 84. Using Custom Dashboards .. 86. Types of Dashboard Charts .. 86. Viewing Dashboards .. 87. Filtering Charts by Platform .. 88. Switching Chart Display .. 89. Viewing Bar Chart Details .. 90. Viewing Line Chart Details .. 90. Creating Dashboards .. 91. Editing Dashboards .. 96. Exporting Analytics .. 98. iv Amazon Mobile Analytics user Guide Auto Export Overview .. 98. Writing Events to Amazon S3 .. 99. Getting Started with Auto Export to Amazon Redshift or Amazon S3 .. 100. Step 1: Go to Manage Apps .. 100. Step 2: Launch the Auto Export Wizard .. 100. Step 3: Choose Export to Amazon Redshift + Amazon S3 .. 100. Step 4: Con gure an Amazon S3 Bucket .. 101. Step 5: Con gure S3 and S3 to Amazon Redshift Permissions.

6 101. Step 6: Con gure Auto Export to Use Amazon Redshift .. 101. Connecting to Amazon Redshift .. 102. Adding New Metrics and Attributes to Amazon Redshift .. 102. Managing Auto Export .. 104. Enabling Auto Export for Additional Apps .. 104. Disabling Auto Export .. 104. Exporting to an Existing Amazon Redshift Cluster .. 105. Part 1: Con gure Security Roles for Auto Export to Amazon Redshift .. 105. Part 2: Gather Details About the Amazon Redshift Cluster .. 107. Part 3: Create and Con gure an Amazon EC2 Loader Instance .. 108. Part 4: Con gure Amazon EC2 Access to the Amazon Redshift Cluster .. 112. Part 5: Connect and Con gure Event Loader .. 113. Part 6: Create the Schema in Amazon Redshift .. 114. Part 7: Loading Events from Amazon S3 to Amazon Redshift .. 114. Part 8: Con gure CloudWatch .. 115. Exported Event JSON .. 116. Amazon Redshift Schema for Event Data .. 120. Example Amazon Redshift Queries .. 122. Explanation of Infrastructure .. 123. Amazon Redshift Cluster .. 124.

7 Virtual Private Cloud .. 124. EC2 Instance .. 124. CloudWatch Metrics and Logs .. 124. Troubleshooting .. 125. If Default IAM Role Creation Fails .. 125. If Auto Export to S3 Fails .. 127. If New Attributes or Metrics Don't Appear in Auto Export to Amazon Redshift .. 127. If Data Does Not Appear in Amazon Redshift Cluster .. 128. Limits .. 130. Aggregated Custom Events .. 130. Other Custom Events Limits .. 130. Custom Dashboards .. 130. REST API Reference .. 131. HTTP Requests .. 131. HTTP Header Contents .. 131. HTTP Body Content .. 132. PutEvents .. 133. Requests .. 133. Responses .. 138. Examples .. 139. Document History .. 140. v Amazon Mobile Analytics user Guide Incorporating Mobile Analytics What Is Amazon Mobile Analytics ? Amazon Mobile Analytics is a service for collecting, visualizing, understanding, and extracting app usage data at scale. Mobile Analytics easily captures both standard device data and custom events and automatically calculates reports on your behalf. The following reports on key performance indicators are provided in the Mobile Analytics console: Daily Active Users (DAU), Monthly Active Users (MAU), and New Users Sticky Factor (DAU divided by MAU).

8 Session Count and Average Sessions per Daily Active user Average Revenue per Daily Active user (ARPDAU) and Average Revenue per Paid Daily Active user (ARPPDAU). Day 1, 3, and 7 Retention and Week 1, 2, and 3 Retention Custom Events In addition to these aggregated reports, you can also set up your data to be exported automatically to Amazon Redshift and Amazon S3 for further analysis. For more information, see Auto Export. These reports are provided through six reporting tabs in the console: Overview Track nine preselected reports in a simple-to-review dashboard to get a quick idea of engagement: MAU, DAU, New Users, Daily Sessions, Sticky Factor, 1-Day Retention, ARPDAU, Daily Paying Users, ARPPDAU. Active Users Track how many users engage with your app daily and monthly and monitor its stickiness to gauge engagement, appeal, and monetization. Sessions Track how often your app is used on a given day and how often each user opens your app during a day. Retention Track the rate at which customers come back to your app on a daily and weekly basis.

9 Revenue Track in-app revenue trends to identify areas for monetization improvement. Custom events Track custom, de ned user actions speci c to your app. Incorporating Mobile Analytics Mobile Analytics can be used by developers to capture information, through Analytics events created in the application logic, about how their applications are used. Individual bits of data called attributes and metrics are added to an event created in the application. 1. Amazon Mobile Analytics user Guide Using the Mobile SDK. After attributes or metrics have been added, the event is then recorded so a copy of the data is preserved in the device's le storage. When an application is sent to the background by the user , recorded events are then submitted to the Mobile Analytics service; this data contributes to the reports available in the console. There are two ways to incorporate Mobile Analytics into the code of your app: The Mobile Analytics web service provides a REST API your app can invoke using HTTP PUT requests.

10 The REST API is platform- and language-independent; it requires a properly formed HTTP request only. For Mobile app developers, the AWS Mobile SDK provides APIs that enable easier and more robust interaction with Mobile Analytics for apps running on Android, iOS, JavaScript, Unity, or Xamarin. Using the Mobile SDK. If you want to use Mobile Analytics in an Android, iOS, JavaScript, Unity, or Xamarin application, you will probably want to make API calls through the AWS Mobile SDK. For information about working with Mobile Analytics using the AWS Mobile SDK, see: Android Developer Guide iOS Developer Guide Mobile Analytics SDK for JavaScript Unity Developer Guide Xamarin Developer Guide Mobile Analytics Pricing With AWS services, you pay only for what you use, with no contracts or monthly active user charges. Mobile Analytics is free up to 100 million events per month, and costs just $ per million events above the free tier. If you enable the Auto Export (p. 98) options to Amazon Simple Storage Service ( Amazon S3) or Amazon Redshift ( Amazon Redshift), there may be additional charges for the use of those services.