#40

Product support

Visit this product's website for support.

Categories

  • Miscellaneous

Note: This plugin is no longer maintained. All features are provided as is.

A plugin for tracking app installs. Get information on new installs, device model and manufacturer and other details. It is event-driven, so you can handle app install, re-install events using custom-made or third-party plugins.

Features

  • Dashboard widget to give user app install analytics.

(NOT) Coming Soon

  • More plugins that interact with and extend this plugin. (Eg. Android Campaigns Plugin)
  • Custom profile fields.
  • Settings to change plugin behaviour.
  • Mark user profiles as test account to exclude from analytics.
User Install Analytics in Dashboard

Android Installs Plugin

OctoberCMS plugin that enables tracking Android App installs.

The plugin is a backend component to track user installs from the Android frontend i.e. your Android application. It consists of a list controller to view the installs and details and exposes a REST API node to allow device to communicate with this plugin.

See this demo app sample to see how to write the Android app frontend code to integrate the plugin. In a nutshell, that app pushes the device data to your server where you have installed this plugin.

User Data Fields

The following data is presently collected from the user device:

Instance ID - This is a unique identifier to identify the installed app instance. The example I provided uses Google’s Instance ID API but you can replace it by UUID as described in this article. I recommend you do this only if you plan to be an Android-only app. InstanceID, on the other hand, is better when you have both iOS and Android versions of the app so that you get unique IDs regardless of the platforms.

Device ID - This is the Android ID field that uniquely identifies a device. In practice, while tracking installs this field is ignored but there are many applications where having a unique device ID is better. For example, when you plan to promote your app via referrals with an incentive and want only unique installs to gain the incentive (it wouldn’t be good to have users get the incentive multiple times by re-installing the app). The current version of plugin enforces that if a different instance ID appears but with same device ID, then it replaces the instance ID with the new one and also generates a android.installs.resetInstall event with the old ID.

Extras - Any extra data can be passed as an array. For example you can collect the user’s device manufacturer, user’s device model, Email ID, mobile number, location data, etc.

Events

android.installs.newInstall - This event is generated every time a new user launches the app. This can be used to identify fresh app installs.

android.installs.existingInstall - This event is generated every time an existing user launches the app.

android.installs.resetInstall - This event is generated every time a user re-installs the app. This can occur due to user clearing the app cache, resetting the phone or removing and installing the app again. The old instance ID is included in the event so that any action can be performed.

Any event listeners can return values to these events in the array format ['result' => 'error', 'reason' = 'some-reason']. If the return value has the result value as error the flow breaks out and returns the error which can be handled on the app side.

API Responses

The API generates a JSON response with the following fields:

result - success or error based on whether the install data gets added successfully or not.

reason - If result is error, then this data contains the error message. The value duplicate means that the entry already exists. This would occur if you use the Android app sample I provided as it makes the install request each time the app starts. A proper way to do it would be to check if a installed flag is present using SharedPreferences when the app starts--if not then make the install request and set the installed flag, otherwise ignore and start the app normally.

1.0.4

Added extras column and migrated existing data to it

Mar 31, 2016

1.0.3

Added reports widget to view app installs

Mar 19, 2016

1.0.2

Created table android_installs_installs

Mar 08, 2016

1.0.1

Initialize plugin.

Mar 08, 2016

Update guide from v1.0.2 to v1.0.3

There have been some breaking changes in the table names which need to be fixed manually. It has not been done the right way (via update file rename) so these manual steps are needed to fix it:

  1. Export the android_installs_installs table from the backend. (You can use phpMyAdmin for this)
  2. Open the exported .sql file in any text editor.
  3. Use find and replace to change android_installs_installs to android_installs.

Now go back to your database and upload the new modified .sql file. It will recreate the table as android_installs. Once done you, update the plugin from your backend. You may also delete the old android_installs_installs as it’s no longer needed. And that’s it, you’re done. Go ahead and add the new dashboard widget in v1.0.3. Enjoy!