Mesure des désinstallations

Mesure des désinstallations Android

Pour commencer à utiliser la mesure des désinstallations pour les applications mobiles Android, vous DEVEZ posséder GCM ou la clé de serveur du projet Firebase (comme décrit ci-dessous).

1. Obtenir la clé de serveur Firebase/GCM

1. Create a Firebase Android Application project (if you have not already done so), or migrate your project from Google Developer Console (follow the instructions there). For more information, visit this link:

2. Open the Firebase Console:

3. In the Firebase Console page, navigate to the Project Settings (click on the cogwheel next to Overview on the left pane of the page).

4. Under the Cloud Messaging tab, you can see your Sender ID (A.K.A Project Number, which is essential if you are using GCM) and two Server Keys (see screenshot below):

• Clé de serveur - utilisée avec Firebase Messaging
• Clé de serveur existante - utilisée avec GCM
  

5. Copy the Server Key.

• Vous pouvez également utiliser la console développeur Google obsolète pour obtenir ces valeurs
  
  https://console.developers.google.com/apis/credentials

2. Saisir la clé de serveur sur le tableau de bord AppsFlyer

1. Go to your app's dashboard on the AppsFlyer platform.

2. Select App Settings from the left menu.

3. Set the Firebase Server Key with the Server Key you just copied (this is a unified Server Key field for both GCM & Firebase-Messaging).

3. Configurer Firebase Messaging sur votre app

Une fois que vous avez créé le projet sur la console Firebase, vous devriez aussi avoir téléchargé le fichier JSON : google-services.json de votre projet et l'avoir enregistré dans le répertoire du module de votre application.

• If you do not have this file, you can download it from your Project Settings in the Firebase Console.

Then, you must add the Firebase-Messaging dependencies to your project:

buildscript { 
    // ... 
    dependencies { 
      // ... 
      classpath 'com.google.gms:google-services:4.2.0' // google-services plugin 
    } 
  }

dependencies {
   implementation 'com.google.firebase:firebase-messaging:17.3.4'
}

// ADD THIS AT THE BOTTOM 
apply plugin: 'com.google.gms.google-services

buildscript { 
    // ... 
    dependencies { 
      // ... 
      classpath 'com.google.gms:google-services:4.1.0' // google-services plugin 
    } 
  }

dependencies {
   implementation "com.google.android.gms:play-services-gcm:16.0.0"
}

// ADD THIS AT THE BOTTOM 
apply plugin: 'com.google.gms.google-services'

<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="your.app.name.permission.C2D_MESSAGE" />
<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />

4. Configurer l'ID de l'expéditeur

In your Application Class / MainActivity's onCreate method, provide the AppsFlyer SDK with the your project's SenderID (AKA - Project Number), as the following example:

@Override
protected void onCreate(Bundle savedInstanceState) {

/* ... */

  String senderId = "Your-Sender-ID"; /* A.K.A Project Number */
  AppsFlyerLib.getInstance().enableUninstallTracking(senderId); /* ADD THIS LINE HERE */

/* ... */

  AppsFlyerLib.getInstance().startTracking(getApplication(), "YOUR_DEV_KEY");

/* ... */
}

5. Implémenter le service de mesure des désinstallations AppsFlyer

<application
   <!-- ... -->
      <service
        android:name="com.appsflyer.FirebaseInstanceIdListener">
        <intent-filter>
          <action
   android:name="com.google.firebase.INSTANCE_ID_EVENT"/>
        </intent-filter>
      </service>
   <!-- ... -->
</application>

import com.appsflyer.AppsFlyerLib; 
import com.google.firebase.iid.FirebaseInstanceId; 
import com.google.firebase.iid.FirebaseInstanceIdService; 
   
  public class MyNewInstanceIdService extends FirebaseInstanceIdService { 
   
    @Override 
    public void onTokenRefresh() { 
    super.onTokenRefresh(); 
    
    /* Get updated InstanceID token. */ 
    FirebaseInstanceId instance = FirebaseInstanceId.getInstance(); 
    String refreshedToken; 
    if (instance != null) { 
     refreshedToken = instance.getToken(); 
         
	 sendTokenToMyBackend(refreshedToken); /* example for general use case / 3rd party SDK */
     /* pass the token to the AppsFlyer SDK */
     AppsFlyerLib.getInstance().updateServerUninstallToken(getApplicationContext(), refreshedToken); 
	} 
  } 
}

AppsFlyerLib.getInstance().updateServerUninstallToken(getApplicationContext(), refreshedToken); 

<application>
   <!-- ... -->
      <service
      android:name="com.appsflyer.GcmInstanceIdListener"
      android:exported="false">
      <intent-filter>
       <action android:name="com.google.android.gms.iid.InstanceID" />
      </intent-filter>
     </service>
   <!-- ... -->
</application>

public class RegistrationIntentService extends IntentService {
  /* ... */

  @Override
  public void onHandleIntent(Intent intent) {
    /* ... */
    InstanceID instanceID = InstanceID.getInstance(this);
    String token = instanceID.getToken(getString(R.string.gcm_defaultSenderId),
                      GoogleCloudMessaging.INSTANCE_ID_SCOPE, null);
    /* ... */
sendTokenToMyBackend(token); // example for general use case / 3rd party SDK
   AppsFlyerLib.getInstance().updateServerUninstallToken(getApplicationContext(), token); // pass the token to the AppsFlyer SDK
  }

  /* ... */
}

<service android:name="[.MyInstanceIDService]" android:exported="false">
   <intent-filter>
       <action android:name="com.google.android.gms.iid.InstanceID"/>
   </intent-filter>
</service>

6. Utilisation de ProGuard avec la fonctionnalité Mesure des désinstallations

When using ProGuard it is required to add the following rules according to which Messaging Service is used (Firebase or GCM).

-dontwarn com.appsflyer.**
-keep public class com.google.firebase.iid.FirebaseInstanceId {
  public *;
}

-dontwarn com.appsflyer.**
-keep public class com.google.android.gms.iid.InstanceID {
  public *;
}

7. Test de la fonctionnalité Mesure des désinstallations Android

Tester l'implémentation de la mesure des désinstallations d'Android est très simple.

Quel que soit l'état de l'app Android, sur Google Play, en attente de soumission ou même hors boutique, le test est le même : il suffit de désinstaller l'app de l'appareil.

Attendez jusqu'à 24 heures pour que le nouvel événement de désinstallation d'app s'affiche dans le tableau du rapport de performance agrégé du tableau de bord et dans le rapport de données brutes des désinstallations.

Mesure des désinstallations iOS

1. Trouver votre app

2. If you have not registered an App ID yet, click the + symbol and complete the form.

3. Check the Push Notifications checkbox.

4. When you expand the application, there are two settings for push notifications with yellow or green status icons:

5. Click Settings to continue.

2. Générer votre certificat

3. Renouveler votre certificat

Si vous renouvelez votre certificat SSL push de développement ou de production, suivez les étapes ci-dessus, comme si vous téléchargiez le certificat pour la première fois. Il n'est pas nécessaire de révoquer le précédent certificat pour effectuer cette modification. Il peut y avoir deux certificats de production en même temps, pour vous permettre de continuer à utiliser l'ancien certificat pendant le téléchargement du nouveau.

4. Exporter le fichier .p12

The final step before heading back over to the AppsFlyer dashboard is to save your signing certificate as a .p12 file.

1. Select the certificate that was just added to Keychain Access

2. Go to File >> Export Items.

3. Select My Certificates under the Category menu on the lower left-hand side.

If My Certificates is not highlighted, you cannot export the certificate as a .p12 file.

3. When saving the file, use the Personal Information Exchange (.p12) format.

4. Make sure it states Apple Push Services and appears as follows:

5. Go to your app's dashboard on the AppsFlyer platform.

6. Select App Settings on the left menu.

7. Click Select File to select your .p12 file.

8. Enter the password for the .p12 file (not the certificate password).

9. Click Validate to send the certificate to AppsFlyer to check if it is valid.

10. Click Save Settings.

5. intégration avec le SDK

Les notifications push doivent être enregistrées au niveau du code de l'app pour permettre la collecte des données de désinstallation.

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    //...
    // iOS 10 support
    if #available(iOS 10, *) {
      UNUserNotificationCenter.current().requestAuthorization(options:[.badge, .alert, .sound]){ (granted, error) in }
      application.registerForRemoteNotifications()
    }
    // iOS 9 and iOS 8 support
    else if #available(iOS 8, *), #available(iOS 9, *) {
      UIApplication.shared.registerUserNotificationSettings(UIUserNotificationSettings(types: [.badge, .sound, .alert], categories: nil))
      UIApplication.shared.registerForRemoteNotifications()
    }

    // iOS 7 support
    else {
      application.registerForRemoteNotifications(matching: [.badge, .sound, .alert])
    }
    
    return true
  }

 // Called when the application sucessfuly registers for push notifications
  func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    AppsFlyerTracker.shared().registerUninstall(deviceToken)
  }

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // The userNotificationTypes below is just an example and may be changed depending on the app
    UIUserNotificationType userNotificationTypes = (UIUserNotificationTypeAlert |
                          UIUserNotificationTypeBadge |
                          UIUserNotificationTypeSound);
    UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:userNotificationTypes
                                       categories:nil];
    [application registerUserNotificationSettings:settings];
    [application registerForRemoteNotifications];

    // if you do not use push notificaiton in your app, uncomment the following line
    //application.applicationIconBadgeNumber = 0;
  }
  
  - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [[AppsFlyerTracker sharedTracker] registerUninstall:deviceToken];
  }

6. Notifications push

Make sure you add Push Notification in your XCode capabilities tab. Without it, the deviceToken is not collected.

7. Tester les désinstallations

It is important to remember that to test a local build, you must use TestFlight and simulate the test on your test device. Testing does not work directly from xcode.

8. Visualisation des données de désinstallation dans le tableau de bord AppsFlyer

La mesure des désinstallations est affichée sur le tableau de bord principal dans le tableau de performance agrégé.

Metrics for uninstalls are updated and aggregated every 24 hours.

For more details, refer to the iOS Measure App Uninstalls section of the SDK Integration Guide.