. . .

Analytics Module

Content

With the Analytics module you will get functionality to track different actions from users of your app. These tracking methods will be automatically in your SDKs (see the supported SDKs below). When the Analytics feature is activated the module will be automatically added to your backend. Using the Analytics module you have a complete dashboard only for analytics purposes. In this dashboard are lots of diagrams and tables which helps you to analyse the behavior of the app users. Beside users behavior you can also see the used devices, resolution and app versions. Additionally to that you have reports from crashes and errors which also helps to improve your app. You can see some functionality of the analytics dashboard in the screenshots below.

images/download/attachments/17238049/analytics.png

Configuration

To enable the Analytics module, you have to install the additional package we provide, contact us for further information.

After the installation, you can set the property "isAnalyticsEnabled" to true in the yambas.conf to enable the ApiOmat-Analytics feature on your installation.

Additionally, you have to set the properties "analyticsHostInternal" - as internal host target of the installation, and "analyticsHostPublic" - as external reachable address of the analytics instance.

The following snippet shows the following lines to add to your apiomat.yaml:

apiomat.yaml
analytics:
enabled : true
hosts :
# The internal address from which the analytics instance is available
internal: http://localhost/analytics
# The external address where the instance is available
public : http://www.yourdomain.yourhost.tld/analytics

A restart of the Tomcat server will initialize your analytics instance and setup the SuperAdmin account on it.

After the Installation of Analytics, you have to set Dashboard-Url-property in your Analytics config.js and then restart it with "countly restart":

ANALYTICSDIR/frontend/express/config.js
aomDashboardUrl: "http://yourDashboardDomain.yourhost.tld/"

This provides that the "back to ApiOmat"-Link in Analytics points to your ApiOmat Dashboard.

Usage

Dashboard

If the ApiOmat-Analytics feature is enabled, every app will automatically use the related analytics module. You can then open the analytics dashboard over the "Use" entry of the context-menu for the module.

images/download/attachments/17238049/analytics_use.png

At the dashboard you can get information about your users' activities, their carriers, devices, resolutions, platforms and many other metadata.

images/download/attachments/17238049/ApiOmatAnalyticsDashboard.png images/download/attachments/17238049/ApiOmatAnalyticsCountries.png images/download/attachments/17238049/ApiOmatAnalyticsEvents.png images/download/attachments/17238049/ApiOmatAnalyticsSessions.png images/download/attachments/17238049/ApiomatAnalyticsPlatforms.png images/download/attachments/17238049/ApiOmatAnalyticsViews.png

SDKs

We currently provide Analytics libraries for the Javascript, Android, Objective-C SDKs and additionally for the React Native SDK ( images/s/de_DE/7202/2b917bf474320363b63231a29396d24a46356543/_/images/icons/emoticons/warning.png Beta). The necessary files are already shipped with your SDK, if the Analytics feature is enabled on your installation.

Please notice, that you have to require the Countly module seperatly when using the React Native SDK:

Include Country in React Native
const Countly = require('lib/com/apiomat/frontend/analytics')

The code snippets on the SDK-page for the specific language at the dashboard already contain simple examples on how to initialize and track events.

images/download/attachments/17238049/codesnippet.png

You can get further information about the SDKs, its configuration and usage at the following links:

Furthermore, our partner count.ly offers community-supported or even unsupported SDKs for other languages and target platforms.

We don't ship and support these SDKs with our SDKs at the moment. However, you can manually add them to your favorite SDK and integrate them in your app.

For a general overview over the SDKs that are officially supported by count.ly: http://resources.count.ly/docs/downloading-sdks

Features

More information about the individual features of ApiOmat Studio can be found below:

Additional information to analytics can be found on our partner's website here.

* link only available in Enterprise Documentation