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. Créez un projet d'application Android Firebase (si ce n'est pas déjà fait), ou migrez votre projet de la console développeur Google (suivez les instructions). Pour plus d'informations, consultez ce lien :

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 dans le volet gauche de la page).

4. Sous l'onglet Cloud Messaging, vous pouvez voir votre ID expéditeur (appelé également numéro de projet, qui est indispensable si vous utilisez GCM) et deux clés de serveur (voir la capture d'écran ci-dessous) :

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

5. Copiez la clé de serveur.

• 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.  Rendez-vous sur le tableau de bord de votre app sur la plate-forme AppsFlyer.

2. Sélectionnez Paramètres d'application dans le menu de gauche.

3. Configurez la clé de serveur Firebase  avec la clé de serveur que vous venez de copier (il s'agit d'un champ de clé de serveur unifié pour GCM et 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.

• Si vous ne posséder pas ce fichier, vous pouvez le télécharger depuis vos Paramètres de projet dans la console Firebase.

Ensuite, vous devez ajouter les dépendances de Firebase Messaging à votre projet :

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

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

//AJOUTEZ ÇA EN BAS 
appliquez le plug-in : 'com.google.gms.google-services

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

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

//AJOUTEZ ÇA EN BAS 
appliquez le plug-in : '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

Lorsque vous utilisez ProGuard, il est nécessaire d'ajouter les règles suivantes en fonction du service de messagerie utilisé (Firebase ou 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. 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.  Allez à 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'application dans le menu de gauche.

7.  Cliquez sur Sélectionner un fichier pour sélectionner votre fichier .p12.

8.  Saisissez le mot de passe du fichier .p12 (pas le mot de passe du certificat).

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.

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

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

Il est important de se rappeler que pour tester une version en local, vous devez utiliser TestFlight et simuler le test sur votre appareil de test. Le test ne fonctionne pas directement à partir de 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é.

Les métriques des désinstallations sont mises à jour et agrégées toutes les 24 heures.

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