Mesure des désinstallations
Vue d'ensemble
Complétez les sections suivantes pour configurer, intégrer et tester la mesure des désinstallation sous iOS :
- Creating a
.p12
certificate and sending it to the marketer. - Configuration du SDK pour la mesure des désinstallations.
- Tester la mesure des désinstallations.
Creating a .p12
certificate
.p12
certificateTo enable uninstall measurement, a .p12
certificate is required.
Remarque
Currently,
.p8
certificates are not supported.
To create a .p12
certificate:
Step 1: Create a Certificate Signing Request (CSR)
1.1. On your Mac, open Keychain Access. Go to Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority.
1.2.Remplissez le formulaire. Sélectionnez Sauvegardé sur le disque et cliquez sur Continuer.
Étape 2 : sélectionnez l'ID d'app
2.1.Retrouvez votre ID d'app Apple dans le Centre des membres du développement Apple, ou créez-en un.
Pour créer un ID d'app, dans le Centre des membres du développement Apple, rendez-vous dans Identifiants et cliquez sur +.
2.2 Choose App IDs and click continue
2.3 Choose App and click continue
2.4. In the Register an App ID view, Under Capabilities, check Push Notifications and click Configure (Edit if it was previously configured). If the Configure/Edit button is not available, you might not have the required permissions.
Étape 3 : exportez le CSR
3.1.Choisissez de créer soit un certificat SSL de production, soit un certificat SSL de développement (cf remarque) et cliquez sur Créer un certificat.
Remarque
Vous devez utiliser un certificat SSL de production pour les applications qui ont été publiées. Si votre application n'est pas encore publiée et qu'elle est en cours de développement, vous devez travailler avec un certificat SSL de développement. Si votre app n'est pas encore prête à être publiée, un certificat SSL de développement peut par exemple vous permettre de tester ses fonctionnalités push dans TestFlight.
3.2. Exportez le CSR que vous avez créé à l'étape 1 puis cliquez sur Continuer.
3.3. Lorsque le bouton Télécharger apparaît, vous pouvez procéder au téléchargement. Si le bouton ne s'affiche pas pensez à recharger la page. Téléchargez le nouveau certificat :
Étape 4 : créer un fichier .p12 .
4.1. Open the .cer
certificate. Opening the certificate will open Keychain Access.
4.2. In the Keychain Access, your certificate is shown under My Certificates. Select the certificate that was just added to Keychain Access.
4.3. Right-click on your certificate and select Export.
4.4. Cliquez sur enregistrer. Veillez à bien utiliser le fichier au format Échange d’informations personnelles (.p12) .
Remarque
Si vous renouvelez un certificat SSL push de développement ou de production, veuillez suivre les étapes ci-dessus. Il n'est pas nécessaire de révoquer le certificat précédent pour effectuer cette modification. Il peut exister deux certificats de production en même temps, vous pouvez ainsi continuer à utiliser l'ancien certificat tout en exportant le nouveau.
Step 5: Upload .p12
to AppsFlyer
Send the .p12
certificate to the marketer to upload to AppsFlyer.
Configuration du SDK
Ajoutez le code suivant à votre AppDelegate :
//add UserNotifications.framework
import UserNotifications
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
// ...
application.registerForRemoteNotifications()
return true
}
// Called when the application sucessfuly registers for push notifications
func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
AppsFlyerLib.shared().registerUninstall(deviceToken)
}
// AppDelegate.h
#import <AppsFlyerLib/AppsFlyerLib.h>
@interface AppDelegate : UIResponder <UIApplicationDelegate, AppsFlyerLibDelegate>
// AppDelegate.m
- #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 {
[[AppsFlyerLib shared] registerUninstall:deviceToken];
}
}
Activation des notifications push en mode arrière-plan
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 :
- Dans XCode, sélectionnez votre projet.
- Sélectionnez votre cible.
- Ouvrez l'onglet Capacités.
- Activez les Modes d'arrière-plan.
- Cochez Notifications distantes.
Tester la mesure des désinstallations
Pour tester la mesure des désinstallations IOS :
- Installez l'app.
- Désinstallez l'application. Important ! Vous pouvez désinstaller l'application immédiatement après l'avoir installée.
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 :
AppsFlyerLib.shared().useUninstallSandbox = true
[AppsFlyerLib shared].setUseUninstallSandbox = true;
Remarque
setUseUninstallSandbox
must be called before callingregisterUninstall
.
Attention
Les désinstallations ne s'affichent pas immédiatement dans le tableau de bord AppsFlyer. En raison du service de notifications push Apple :
- Il faut compter en moyenne 9 jours pour que les désinstallations IOS apparaissent dans les rapports
- Il faut parfois plus d'un mois pour que les désinstallations iOS provenant d'environnements sandbox s'affichent dans les rapports.
- La date de désinstallation correspond au jour où la désinstallation a été rapportée. Par exemple :
- Jour 1 : un utilisateur installe votre app
- Jour 4 : l'utilisateur désinstalle votre app
- Jour 12 : le service de notifications push signale la suppression de l'app 8 jours après la désinstallation
- Jour 13 : les données de désinstallation apparaissent sur le tableau de bord AppsFlyer et dans les données brutes
Mis(e) à jour il y a 10 mois