Getting Started with Android Uninstall Tracking

Singular Android Uninstall tracking is available with Singular Android SDK 7.x. An app update is required.

Setting Up Uninstall Tracking

  1. Integrate Android SDK 7.x+: Uninstall tracking is available in Android SDK version 7.x and above. For instructions on upgrading your SDK, review our Android SDK integration guide.
  2. Modify AndroidManifest.xml: See the Android SDK uninstall tracking integration guide details.
  3. Add your Sender ID and Server Key: Singular requires a Google Project Number and Server Key for enabling uninstall tracking. To retrieve these values:
    • Open firebase https://firebase.google.com/.
    • Select Go to Console and select the project.
    • Select the gear icon and go to Project Settings.
    • Select the Cloud Messaging tab.
      Screen_Shot_2017-12-27_at_4.48.09_PM.png
    • In your Singular account, go to Settings > Apps, find the app for which you want to track uninstalls, and select Edit.
    • Under Uninstall Tracking, add the Project Number (Sender ID on Firebase) and Server Key.Screen_Shot_2017-12-27_at_4.56.56_PM.png

Configuring FCM in Your App

  1. Create a Firebase project on the Firebase Console.
  2. After creating the project, It will take you on dashboard from where select the option “Add firebase to your Android App”.
  3. Provide the package id of Android Application.Screen_Shot_2017-12-27_at_4.55.41_PM.png
  4. Download the config file (google-services.json).
  5. Copy the google-services.json file in app module of Android project.
  6. In Project-level build.gradle (<project>/build.gradle):
    buildscript {
    dependencies {
    // Add this line or latest version
    classpath 'com.google.gms:google-services:3.1.0'
    }
    }
  7. In App-level build.gradle (<project>/<app-module>/build.gradle):
    // Add to the bottom of the file
    apply plugin: 'com.google.gms.google-services'
  8. Sync the project.
  9. Create a service in android code (class which will inherit FirebaseInstanceIdService):
    public class FCMService extends FirebaseInstanceIdService {
    @Override
    public void onTokenRefresh() {
    super.onTokenRefresh();
    //now we will have the token
    String token = FirebaseInstanceId.getInstance().getToken();
    }
    }
    In onTokenRefresh method we will get fcm token that we have to store on our server to send Notifications.
  10. Add this service to the Android Manifest file:
    <service android:name=".FCMService">
    <intent-filter>
    <action android:name="com.google.firebase.INSTANCE_ID_EVENT"/>
    </intent-filter>
    </service>
  11. You can test the notification using the console by providing an FCM token:Screen_Shot_2017-12-27_at_4.56.12_PM.png

Singular will now begin to track uninstalls for users using the updated version of your application.

How Does It Work?

Singular has integrated with Google's services to track uninstalls for your applications, as a proxy measure for the quality of traffic you drive through your paid campaigns. This integration uses a different methodology compared to Google - which reports uninstalls directly from the operating system resident on the device.

A few important points to keep in mind:

  • Singular and Google use different methodologies to report uninstalls, which results in a variation in numbers. Use the Singular and Google reports separately for their respective purposes.
  • Uninstalls are tracked as events in Singular and as a result do not remove the attribution link from the originating Install or Re-engagement source. This may result in uninstall rates of higher than 100%, since a user may uninstall an app multiple times in their lifetime.
Was this article helpful?
0 out of 0 found this helpful