Table of contents Add a Monitored Mobile App as a Managed App to Monitor Custom Activities You can report custom activities from your monitored mobile app by adding it as a managed application in Aternity. Even before you add it as a managed application, a monitored app automatically reports a wealth of performance and usage data to Aternity, but it cannot report custom activities. A monitored mobile app is a regular iOS or Android app which has Aternity's monitoring functionality inside, enabling it to report performance statistics like launch times, errors, crashes, network traffic, and also custom activities performance, and some surrounding data on the underlying mobile device and user. For more information on embedding monitoring within the app itself, see How To Embed Monitoring in a Mobile App. Adding a mobile app for monitoring Before you begin Before adding a mobile app to Aternity to monitor custom activities, verify the following: Verify the access rights and privileges for your user includes Edit Configuration privileges. Make a note of the unique package ID of your mobile app. Locating iOS Bundle Identifier Locating Android Package Name Obtain the .ipa file. For example, appname.ipa. Right-click the file and select Open with > Archive Utility. Open the Payload folder. Right-click the appname.app folder and select Show Package Contents. Open Info.plist. Look for CFBundleidentifier and make a note of the value. For example, com.company.mymobileapp. Obtain the .apk file. For example, appname.apk. Open the Terminal/shell on a computer which has the Android SDK installed. Navigate to the build-tools folder: %ANDROID_HOME%/build-tools/<version>/ Enter the following command: On Windows: aapt dump badging appname.apk On Mac: aapt dump badging path/to/appname.apk | grep package Look for a line starting with package: name=' and make a note of the package name (without the quotes). For example, com.company.mymobileapp. ProcedureStep 1 Open a browser and log in to Aternity. Step 2 Select the Gear Icon > Managed Applications. Step 3 Select Add Application > Mobile Application. Add a mobile app as a managed application Step 4 Enter the details of the mobile app to be monitored. Specify the mobile app details for monitoring Field Description App Name Enter the name of the app to be monitored. This name appears throughout the system's dashboards. Package Name Enter the ID of the app. In iOS, the ID is known as the Bundle Identifier, located in the app's info.plist file. In Android, this is the package name. For more information on how to find this value, see the Before You Begin section above. Add Multiple Package Names Select this option to add more than one app (package ID) to be monitored together as the same app. For example, if you have several versions of an app, each with their own package name, like a smartphone and tablet version, or if you want to monitor your Android and iOS apps together, use this option. Target Users Select the target audience of this monitored app: There are some minor differences in the extent of monitoring for iOS mobile apps: Workforce (B2E) is aimed at employees of your company, and made available through your private enterprise app store. These apps can track additional metrics in iOS like the device's signal strength, or a stronger device ID. Consumer (B2C) is aimed at a general audience, and uploaded to the official App Store. These apps have monitoring capabilities which conform to the store's rules. Step 5 Embed monitoring functionality in the app itself (if you haven't already done so), using any of the following methods: The Aternity iOS Wrapper embeds monitoring in iOS apps without requiring access to the source code. The Aternity Android Wrapper embeds monitoring in Android apps without requiring access to the source code. The Aternity iOS Mobile SDK embeds monitoring in iOS apps, and requires access to the app's source code. It also enables more monitoring functionality through targeted API calls. The Aternity Android Mobile SDK embeds monitoring in Android apps, and requires access to the source code. It also enables more monitoring functionality through targeted API calls. Parent topic View the List of Managed ApplicationsRelated tasksAdd a Windows Desktop Application to be MonitoredUpload a Custom Activity to AternityDefining a Test Group to Roll Out Monitored ApplicationsAdd a Web (Cloud) Application to be Monitored SavePDF Selected topic Selected topic and subtopics All content Related Links
Add a Monitored Mobile App as a Managed App to Monitor Custom Activities You can report custom activities from your monitored mobile app by adding it as a managed application in Aternity. Even before you add it as a managed application, a monitored app automatically reports a wealth of performance and usage data to Aternity, but it cannot report custom activities. A monitored mobile app is a regular iOS or Android app which has Aternity's monitoring functionality inside, enabling it to report performance statistics like launch times, errors, crashes, network traffic, and also custom activities performance, and some surrounding data on the underlying mobile device and user. For more information on embedding monitoring within the app itself, see How To Embed Monitoring in a Mobile App. Adding a mobile app for monitoring Before you begin Before adding a mobile app to Aternity to monitor custom activities, verify the following: Verify the access rights and privileges for your user includes Edit Configuration privileges. Make a note of the unique package ID of your mobile app. Locating iOS Bundle Identifier Locating Android Package Name Obtain the .ipa file. For example, appname.ipa. Right-click the file and select Open with > Archive Utility. Open the Payload folder. Right-click the appname.app folder and select Show Package Contents. Open Info.plist. Look for CFBundleidentifier and make a note of the value. For example, com.company.mymobileapp. Obtain the .apk file. For example, appname.apk. Open the Terminal/shell on a computer which has the Android SDK installed. Navigate to the build-tools folder: %ANDROID_HOME%/build-tools/<version>/ Enter the following command: On Windows: aapt dump badging appname.apk On Mac: aapt dump badging path/to/appname.apk | grep package Look for a line starting with package: name=' and make a note of the package name (without the quotes). For example, com.company.mymobileapp. ProcedureStep 1 Open a browser and log in to Aternity. Step 2 Select the Gear Icon > Managed Applications. Step 3 Select Add Application > Mobile Application. Add a mobile app as a managed application Step 4 Enter the details of the mobile app to be monitored. Specify the mobile app details for monitoring Field Description App Name Enter the name of the app to be monitored. This name appears throughout the system's dashboards. Package Name Enter the ID of the app. In iOS, the ID is known as the Bundle Identifier, located in the app's info.plist file. In Android, this is the package name. For more information on how to find this value, see the Before You Begin section above. Add Multiple Package Names Select this option to add more than one app (package ID) to be monitored together as the same app. For example, if you have several versions of an app, each with their own package name, like a smartphone and tablet version, or if you want to monitor your Android and iOS apps together, use this option. Target Users Select the target audience of this monitored app: There are some minor differences in the extent of monitoring for iOS mobile apps: Workforce (B2E) is aimed at employees of your company, and made available through your private enterprise app store. These apps can track additional metrics in iOS like the device's signal strength, or a stronger device ID. Consumer (B2C) is aimed at a general audience, and uploaded to the official App Store. These apps have monitoring capabilities which conform to the store's rules. Step 5 Embed monitoring functionality in the app itself (if you haven't already done so), using any of the following methods: The Aternity iOS Wrapper embeds monitoring in iOS apps without requiring access to the source code. The Aternity Android Wrapper embeds monitoring in Android apps without requiring access to the source code. The Aternity iOS Mobile SDK embeds monitoring in iOS apps, and requires access to the app's source code. It also enables more monitoring functionality through targeted API calls. The Aternity Android Mobile SDK embeds monitoring in Android apps, and requires access to the source code. It also enables more monitoring functionality through targeted API calls. Parent topic View the List of Managed ApplicationsRelated tasksAdd a Windows Desktop Application to be MonitoredUpload a Custom Activity to AternityDefining a Test Group to Roll Out Monitored ApplicationsAdd a Web (Cloud) Application to be Monitored
Add a Monitored Mobile App as a Managed App to Monitor Custom Activities You can report custom activities from your monitored mobile app by adding it as a managed application in Aternity. Even before you add it as a managed application, a monitored app automatically reports a wealth of performance and usage data to Aternity, but it cannot report custom activities. A monitored mobile app is a regular iOS or Android app which has Aternity's monitoring functionality inside, enabling it to report performance statistics like launch times, errors, crashes, network traffic, and also custom activities performance, and some surrounding data on the underlying mobile device and user. For more information on embedding monitoring within the app itself, see How To Embed Monitoring in a Mobile App. Adding a mobile app for monitoring Before you begin Before adding a mobile app to Aternity to monitor custom activities, verify the following: Verify the access rights and privileges for your user includes Edit Configuration privileges. Make a note of the unique package ID of your mobile app. Locating iOS Bundle Identifier Locating Android Package Name Obtain the .ipa file. For example, appname.ipa. Right-click the file and select Open with > Archive Utility. Open the Payload folder. Right-click the appname.app folder and select Show Package Contents. Open Info.plist. Look for CFBundleidentifier and make a note of the value. For example, com.company.mymobileapp. Obtain the .apk file. For example, appname.apk. Open the Terminal/shell on a computer which has the Android SDK installed. Navigate to the build-tools folder: %ANDROID_HOME%/build-tools/<version>/ Enter the following command: On Windows: aapt dump badging appname.apk On Mac: aapt dump badging path/to/appname.apk | grep package Look for a line starting with package: name=' and make a note of the package name (without the quotes). For example, com.company.mymobileapp. ProcedureStep 1 Open a browser and log in to Aternity. Step 2 Select the Gear Icon > Managed Applications. Step 3 Select Add Application > Mobile Application. Add a mobile app as a managed application Step 4 Enter the details of the mobile app to be monitored. Specify the mobile app details for monitoring Field Description App Name Enter the name of the app to be monitored. This name appears throughout the system's dashboards. Package Name Enter the ID of the app. In iOS, the ID is known as the Bundle Identifier, located in the app's info.plist file. In Android, this is the package name. For more information on how to find this value, see the Before You Begin section above. Add Multiple Package Names Select this option to add more than one app (package ID) to be monitored together as the same app. For example, if you have several versions of an app, each with their own package name, like a smartphone and tablet version, or if you want to monitor your Android and iOS apps together, use this option. Target Users Select the target audience of this monitored app: There are some minor differences in the extent of monitoring for iOS mobile apps: Workforce (B2E) is aimed at employees of your company, and made available through your private enterprise app store. These apps can track additional metrics in iOS like the device's signal strength, or a stronger device ID. Consumer (B2C) is aimed at a general audience, and uploaded to the official App Store. These apps have monitoring capabilities which conform to the store's rules. Step 5 Embed monitoring functionality in the app itself (if you haven't already done so), using any of the following methods: The Aternity iOS Wrapper embeds monitoring in iOS apps without requiring access to the source code. The Aternity Android Wrapper embeds monitoring in Android apps without requiring access to the source code. The Aternity iOS Mobile SDK embeds monitoring in iOS apps, and requires access to the app's source code. It also enables more monitoring functionality through targeted API calls. The Aternity Android Mobile SDK embeds monitoring in Android apps, and requires access to the source code. It also enables more monitoring functionality through targeted API calls. Parent topic View the List of Managed ApplicationsRelated tasksAdd a Windows Desktop Application to be MonitoredUpload a Custom Activity to AternityDefining a Test Group to Roll Out Monitored ApplicationsAdd a Web (Cloud) Application to be Monitored