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 guide details.
3. In the Singular Apps page > App > Advanced Settings > Uninstall Tracking, enter in the Project ID.
   
   
   

   To create and configure your Project ID

   1. Go to the Firebase Cloud Messenger Console
   2. Select or create a new project
   3. Navigate to Project Overview > Project Settings, and copy your Project ID.  This is the Project ID which you will need to enter in your Singular apps page after the project has been granted the proper roles and permissions in the subsequent steps.
      
      
      
   4. Enable FCM Cloud Messaging for the project by navigating to Cloud Messaging and enabling Firebase Cloud Messaging API (V1)
      
   5. Navigate to Service Accounts > Manage service account permissions
   6. Assign the correct project role and permissions
      
      1. Select Roles in the left navigation menu
      2. Click Create Role and enter the following information
         Title: Singular Uninstall Tracking
         ID: singular_uninstalls
         Role launch stage: General Availability
         
      3. Click Add Permissions and add cloudmessaging.messages.create. You can find this quickly by Filtering on Firebase Cloud Messaging API Admin.
         
      4. Click Create to finish creating the role

   7. Assign Singular to the role

      1. Select IAM in the left navigation menu
      2. In the Permissions tab, click Grant Access
         
         
         
         
      3. Under Add principals > New principals, type in:
         
         singular-uninstall-tracking@singular-uninstall-tracking.iam.gserviceaccount.com
         
         
         
         
      4. Under Assign roles, select the "Singular Uninstall Tracking" created in the prior steps
         
         
         
         The final configuration should match:
         
         
         
      5. Click Save
         
         

To set up uninstall tracking in Android:

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 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:
   • In Firebase, select Go to Console and select the project.

   • Select the gear icon and go to Project Settings > Cloud Messaging.

     

   • 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.

     

4. Configure FCM in your app as follows:

   1. In the Firebase console, create a Firebase project.
   2. In the project dashboard, select Add Firebase to your Android App.

   3. Enter the Android app's package ID.

      

   4. Download the config file (google-services.json) and copy it into the app module of the Android project.
   5. In the project-level build.gradle file (><project>/build.gradle>), add the following:
      

      buildscript {
         dependencies {
           // Add this line or latest version 
           classpath 'com.google.gms:google-services:3.1.0'
         }
       }

   6. In the app-level build.gradle file (><project>/<app-module>/build.gradle>), add the following:
      

      // Add to the bottom of the file
      apply plugin: 'com.google.gms.google-services'

   7. Sync the project.
   8. In the Android code, create the following service:
      

      public class FCMService extends FirebaseInstanceIdService {
          @Override
          public void onTokenRefresh() {
              super.onTokenRefresh();
              //now we will have the token                   
              String token = FirebaseInstanceId.getInstance().getToken();
          }
      }

      The onTokenRefresh method gets an FCM token that is needed in order to send notifications.
   9. Add the service to the Android manifest file:

      <service android:name=".FCMService">
       <intent-filter>
       <action android:name="com.google.firebase.INSTANCE_ID_EVENT"/
       </intent-filter>
      </service>

Singular will now track uninstalls for users who have the updated version of your application.

Testing the Notification

You can test the notification using the console by providing an FCM token: