Mesure des désinstallations

Mesure des désinstallations Android

La mesure des désinstallations à l'aide de la messagerie Firebase est prise en charge à partir du SDK Android version 4.7.0.

1. Obtenir la clé de serveur Firebase

1. Créez un projet d'app Android Firebase (si ce n'est pas déjà fait), ou migrez votre projet de la console développeur Google (suivez les instructions ci-dessous). Pour plus d'informations, rendez-vous sur Firebase. 
2. Ouvrez la Console Firebase.
3. Sur la page Console Firebase, accédez aux paramètres du projet (cliquez sur la roue dentée à côté de Vue d'ensemble du projet dans le volet gauche de la page).
4. Sous l'onglet Cloud Messaging, vous verrez les deux clés de serveur (cf capture d'écran ci-dessous) :
   
   
5. Copiez la clé de serveur.

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

1. Accédez au tableau de bord de votre app sur la plate-forme AppsFlyer.
2. Sélectionnez Paramètres d'app dans le menu de gauche.

   

3. Définissez la clé de serveur Firebase à l'aide de la clé de serveur que vous venez de copier.

3. Configurer Firebase Messaging sur votre app

1. Téléchargez google-services.json depuis la console Firebase.
2. Ajoutez le fichier google-services.json au répertoire du module de votre app
3. Ajoutez des règles à votre fichier build.gradle de niveau racine pour inclure le plug-in google-services :

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

4. Ajoutez la dépendance FCM à votre fichier build.gradle de niveau application :

   dependencies {
      implementation 'com.google.firebase:firebase-messaging:17.3.4'
   }
   
   // ADD THIS AT THE BOTTOM 
   apply plugin: 'com.google.gms.google-services
   

La dernière version de Firebase est disponible ici : Firebase official doc.

Si vous recevez une erreur « Impossible de trouver... », assurez-vous d'avoir le dernier référentiel Google dans le gestionnaire SDK Android. 

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

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

import com.appsflyer.AppsFlyerLib;
import com.google.firebase.messaging.FirebaseMessagingService;

public class MyNewFirebaseManager extends FirebaseMessagingService {

    @Override
    public void onNewToken(String s) {
        super.onNewToken(s);

        // Sending new token to AppsFlyer
       	       AppsFlyerLib.getInstance().updateServerUninstallToken(getApplicationContext(), s);

        // the rest of the code that makes use of the token goes in this method as well
    }
}

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

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

@Override
    public void onMessageReceived(RemoteMessage remoteMessage) {
        
        if(remoteMessage.getData().containsKey("af-uinstall-tracking")){
            return;
        } else {
           // handleNotification(remoteMessage);
        }
    }

5. Utiliser ProGuard avec la fonctionnalité Mesure des désinstallations

Si vous utilisez ProGuard, ajoutez la règle suivante :

-dontwarn com.appsflyer.**
-keep public class com.google.firebase.messaging.FirebaseMessagingService {
  public *;
}

6. Tester la 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'à 48 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. Si vous n'avez pas encore enregistré un ID d'app, cliquez sur le symbole + et remplissez le formulaire.

3.  Cochez la case Notifications push.

4.  Lorsque vous développez l'application, deux paramètres de notifications push apparaissent avec des icônes d'état jaune ou verte :

5.  Cliquez sur Paramètres pour continuer.

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

La dernière étape avant de retourner au tableau de bord AppsFlyer est d'enregistrer votre certificat de signature sous la forme d'un fichier .p12.

1.  Sélectionnez le certificat venant d'être ajouté à Keychain Access. 

2. Rendez-vous dans Fichier > Exporter des éléments.

3.  Sélectionnez Mes certificats sous le menu Catégorie sur le côté inférieur gauche.

Si Mes certificats n'est pas sélectionnable, vous ne pouvez pas exporter le certificat sous la forme d'un fichier .p12.

3.  Lorsque vous enregistrer le fichier, utilisez le format Échange d’informations personnelles (.p12) .

4.  Assurez-vous qu'il indique Apple Push Services et qu'il se présente comme suit :

5. Allez au tableau de bord de votre app sur la plate-forme AppsFlyer.

6. Sélectionnez Paramètres d'app dans le menu de gauche.

7. Cliquez sur l'icône de téléchargement, sélectionnez le fichier P12 à téléverser. 

8. (facultatif) Si le certificat P12 est protégé par un mot de passe, saisissez le mot de passe dans Mot de passe Certificat P12. 

9.  Cliquez sur Valider pour envoyer le certificat à AppsFlyer pour vérifier qu'il est valide. 

10.  Cliquez sur Enregistrer les paramètres.

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.

	//add UserNotifications.framework
	import UserNotifications
	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)
  }

- #import <UserNotifications/UserNotifications.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // The userNotificationTypes below is just an example and may be changed depending on the app
 UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
          center.delegate = self;
          [center requestAuthorizationWithOptions:(UNAuthorizationOptionSound | UNAuthorizationOptionAlert | UNAuthorizationOptionBadge) completionHandler:^(BOOL granted, NSError * _Nullable error) {
          }];
   [[UIApplication sharedApplication] 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];
  }
  }

#import <AppsFlyerLib/AppsFlyerTracker.h>
@interface AppDelegate : UIResponder <UIApplicationDelegate, AppsFlyerTrackerDelegate>

The code snippets above request permissions from the user to send push notifications. However, if you are only using push notifications in background mode to measure uninstalls, there is no need to ask for user approval. This is because these push notifications are silent push notifications that do not require you to ask permission from users.

User permission for push notifications in background mode 

Si vous utilisez uniquement des notifications push silencieuses, veillez à activer les Notifications distantes dans les Modes d'arrière-plan des Fonctionnalités de votre app :

1. Dans XCode, sélectionnez votre projet
2. Sélectionnez la cible
3. Accédez à l'onglet Fonctionnalités
4. Activez les Modes d'arrière-plan
5. Cochez Notifications distantes
   
   

6. Notifications push

Assurez-vous d'ajouter Notification push à votre onglet de capacités XCode. Sans cela, le deviceToken ne sera pas recueilli.

7. Tester les désinstallations

Lorsque vous testez les désinstallations de Xcode ou TestFlight, il est important d'informer notre SDK que le jeton est généré depuis un environnement Sandbox. Utilisez les API suivantes :

AppsFlyerTracker.shared().useUninstallSandbox = true

[AppsFlyerTracker sharedTracker].useUninstallSandbox = true;

Il n'est pas nécessaire d'attendre entre l'installation et la désinstallation. Vous pouvez installer l'application et la désinstaller immédiatement.

Toutefois, l'affichage de la désinstallation réelle sur votre tableau de bord peut prendre jusqu'à 9 jours à compter de la date d'installation. De plus, la date de désinstallation est 9 jours après la date de désinstallation réelle. Consultez la section ci-dessous pour en savoir plus.

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

En raison d'un changement récent du service de notifications push Apple, il faut un minimum de 9 jours pour que les désinstallations apparaissent sur le tableau de bord.

Pour plus de détails, reportez-vous à la section Mesurer les désinstallation d'app iOS du guide d'intégration SDK.

Postbacks d'évènement de désinstallation

AppsFlyer vous permet d'envoyer aux partenaires avec lesquels vous travaillez un postback d'évènement de désinstallation pour chaque utilisateurs connu procédant à une désinstallation. L'évènement de désinstallation porte le nom af_uninstall dans le tableau de bord AppsFlyer.

Mappage de l'évènement de désinstallation

Vous pouvez mapper l'évènement af_uninstall comme vous le feriez pour n'importe quel évènement in-app de votre app.

Comme pour n'importe quel évènement in-app, AppsFlyer peut envoyer le postback uniquement si l'évènement a réellement lieu et a été enregistré par AppsFlyer. Par conséquent, le mappage d'af_uninstall fonctionne uniquement pour les implémentations de désinstallation terminées. Si aucune désinstallation ne figure sur la page de présentation ou dans les rapports de données brutes des désinstallations, aucun postback de désinstallation n'est transmis aux partenaires, même si vous avez mappé l'évènement af_uninstall.

Timing d'af_uninstall

Contrairement aux postbacks des évènements in-app standard envoyés en temps réel, l'évènement af_uninstall ne l'est pas.

L'heure à laquelle l'évènement af_uninstall a été enregistré dans les données brutes d'AppsFlyer et les postbacks des partenaires correspond à l'heure à laquelle AppsFlyer détecte la désinstallation. C'est-à-dire dans les 24 heures à compter de la désinstallation effective de l'app.

Limites

Les événements af_uninstall ne sont pas inclus dans les rapports de postbacks d'évènements in-app.

L'évènement af_uninstall n'est actuellement pas disponible pour tous les partenaires.

Si vous souhaitez le mapper avec un partenaire, mais que l'évènement n'est pas disponible pour le partenaire, contactez votre responsable clientèle dédié ou écrivez à hello@appsflyer.com.

Si vous êtes un partenaire et souhaitez recevoir les évènements af_uninstall, contactez votre PDM dédié ou écrivez à partners@appsflyer.com.