卸载评估

安卓卸载测量

Android SDK 版本4.7.0及以上支持使用 Firebase 消息进行卸载监测。

1. 获取 Firebase/GCM 服务器密钥

1. 创建一个Firebase安卓应用项目（如果已完成），或者把您的项目从Google Developer Console中迁出（按照下列步骤说明）想了解更多信息，请访问Firebase。
2. 打开 Firebase Console.
3. 在Firebase 控制台页面，导航至项目设置（点击项目总览旁边的设置图标）。
4. 在云消息选项卡下,您可以看到两个服务器密钥(请参阅下面的屏幕截图):
   
   
5. 复制该服务器密钥。

2. 在 AppsFlyer 控制面板上输入服务器密钥

1. 转到 AppsFlyer 平台上的控制面板。
2. 选择左侧菜单上的应用设置。

   

3. 用复制的服务器密钥设置 Firebase 服务器密钥。

3. 在应用上配置 Firebase-Messaging

1. 从Firebase console下载google-services.json。
2. 把 google-services.json添加到您应用的模块目录中，
3. 将规则添加到您的 root-level build.gradle文件, 包括 google-services 插件:

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

4. 将 FCM dependency 添加到 app-level build.gradle file:

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

可以在这里找到最新的Firebase版本： Firebase official doc.

如果您收到"找不到..."错误,请确保您在 Android SDK 管理器中有最新的 Google Repository。

4. 实施 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. 使用带有卸载测量功能的 ProGuard

如果您使用的是ProGuard，请添加下列规则：

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

6. 测试安卓卸载测量

测试 Android 卸载测量的配置是非常直接的。

无论 Android 应用是否已经发布在 Google Play 上, 或等待提交, 甚至是不在商店中, 测试都是一样的--只需从设备上卸载该应用即可。

在控制面板上的汇总表格和卸载的原始数据报告上显示新应用卸载事件最多需要48小时。

iOS 卸载测量

1. 查找您的应用程序

2. 如果您尚未注册应用 ID，请单击 + 符号并填写表单。

3. 选中"推送通知"复选框。

4. 展开应用程序时,有两种带有黄色或绿色状态图标的推送通知设置:

5. 单击"设置"以继续。

2. 生成证书

3. 更新您的证书

如果要续订 Development 或者 Production Push SSL 证书, 请按照上面列出的步骤操作, 就像您是第一次上传证书一样。无需撤消以前的证书即可进行此更改。可能同时有两个生产证书, 以允许您在上传新证书时继续使用旧证书。

4. 导出 P12文件

返回 AppsFlyer 控制面板之前的最后一步是将签名证书另存为 .p12。

1. 选择刚刚添加到钥匙串访问的证书

2.转到文件 > 导出项目 。

3. 在左下边的"类别"菜单下选择"我的证书"。

如果未突出显示"我的证书",则无法将证书导出为 .p12文件。

3. 保存文件时,使用 Personal Information Exchange (.p12)格式。

4. 确保它符合 Apple Push Services ,如下所示:

5. 转到 AppsFlyer 平台上的控制面板。

6.在左侧菜单上选择“ 应用程序设置” 。

7.单击上传图标，选择要上传的P12文件。

8. （可选） 如果 P12 证书 受密码保护，请填写P12 证书密码中的密码 。

9. 单击验证将证书发送到 AppsFlyer 以检查其是否有效。

10. 单击保存设置。

5. 与 SDK 集成

推送通知必须在应用的代码级别配置, 以启用卸载数据收集。

	//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>

上述代码段需要请求用户权限才可以发送推送通知。但是，如果您仅在后台模式下使用推送通知来衡量卸载情况，则无需请求用户权限。这是因为这个推送消息是静默通知-无需请求用户权限。

后台模式下推送通知的用户权限 

如果您仅使用静默推送通知, 请确保在应用的功能中启用后台模式的远程通知:

1. 在 XCode 中, 选择您的项目
2. 选择您的目标
3. 切换到功能选项卡
4. 打开后台模式
5. 勾选远程通知
   
   

6. 推送通知

请确保在 XCode 功能选项卡中添加推送通知。如果没有它, deviceToken 将不会被收集。

7. 测试卸载

当从 Xcode 或 TestFlight 测试卸载时，重要的是让我们的SDK知道 token 是从沙盒环境生成的。使用以下 API:

AppsFlyerTracker.shared().useUninstallSandbox= true

[AppsFlyerTracker sharedTracker].useUninstallSandbox= true;

无需在安装和卸载之间等待。您可以安装该应用程序并立即将其卸载。

但是,在控制面板上看到实际卸载可能需要一些时间。此外，卸载日期是实际卸载日期后的9天。有关详细信息,请参阅以下部分。

8. 在 AppsFlyer 控制面板中查看卸载数据

卸载测量显示在 "汇总业绩" 表中的主控制面板上。

由于 Apple 推送通知服务最近的更改，至少需要 9 天才可以在控制面板上显示卸载。

有关详细信息, 请参阅 SDK 集成指南中的 iOS 测量应用程序卸载部分。

卸载事件回传

AppsFlyer 使您能够向与您合作的合作伙伴发送每个已知卸载用户的卸载事件回传。卸载事件在 AppsFlyer 的控制面板中称为 af_uninstall。

映射卸载事件

你可以映射 af_uninstall 事件, 就像映射你的应用的任何应用内事件一样。

与任何应用内事件一样, AppsFlyer 只有在事件实际发生并由 AppsFlyer 记录的情况下才能发送回传。因此, 映射 af_uninstall 仅适用于已完成的卸载。如果在概述页或卸载原始数据报告中看不到卸载, 则不会向合作伙伴发送卸载回传, 即使您已映射了 af_uninstall 事件也是如此。

af_uninstall 计时

虽然常规应用内事件的回传是实时发送的,  但 af_uninstall 事件不会。

在 AppsFlyer 的原始数据和合作伙伴回传中, af_uninstall 记录的事件时间是 AppsFlyer 了解卸载的时间。这种情况发生在实际应用卸载后的 24 小时内。

限制

af_uninstall 事件未包含在应用内事件回发报告中。

af_uninstall 事件目前不适用于所有合作伙伴。

如果您希望与合作伙伴进行映射,但看到该活动不适用于合作伙伴,请联系您的专用 CSM 或写信给 hello@appsflyer.com。

如果您是合作伙伴, 并希望接收 af_uninstall, 请联系我们的 PDM 或发邮件至 partners@appsflyer.com。