Измерение количества удалений

Измерение количества удалений для устройств на платформе Android

Использовать функцию измерения количества удалений для мобильных приложений на платформе Android можно ТОЛЬКО ПРИ НАЛИЧИИ серверного ключа для проекта GCM или Firebase (см. описание ниже).

1. Получение серверного ключа 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):

• Server Key (Серверный ключ) — используется со службой Firebase-Messaging.
• Legacy Server key (Старый серверный ключ) — используется со службой GCM.
  

5. Copy the Server Key.

• Эти значения можно также получить с помощью старой консоли разработчика Google
  
  https://console.developers.google.com/apis/credentials

2. Ввод серверного ключа на панели управления 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. Настройка Firebase-Messaging в вашем приложении.

После создания проекта на консоли Firebase Console вы должны были загрузить файл JSON своего проекта (google-services.json) и сохранить его в каталоге модулей своего приложения.

• 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. Настройка идентификатора отправителя.

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. Использование услуги измерения количества удалений в 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. Использование ProGuard с функцией измерения количества удалений

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. Тестирование измерения количества удалений для устройств на платформе Android

Тестирование функции измерения количества удалений в устройствах на платформе Android выполняется очень просто.

Независимо от того, работает ли приложение Android в Google Play, ожидает отправки или даже не опубликовано, тестирование выполняется одинаково: приложение просто удаляется с устройства.

Примерно через 24 часа новое событие удаления приложения должно появиться на панели управления — в таблице сводного отчете по эффективности и в отчете необработанных данных об удалениях.

Измерение количества удалений для устройств на платформе iOS

1. Поиск своего приложения.

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. Создание сертификата.

3. Продление сертификата.

Чтобы продлить срок действия SSL-сертификата службы Push-уведомлений (для разработки или рабочий), выполните те же действия, которые описаны выше для первоначального добавления сертификата. При замене сертификата отменять предыдущий сертификат не нужно. Можно одновременно иметь два рабочих сертификата, что позволяет использовать старый сертификат, пока загружается новый.

4. Экспорт файла .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. Интеграция с SDK

Чтобы включить сбор данных об удалениях, необходимо зарегистрировать Push-уведомления на уровне кода приложения.

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. Push-уведомления.

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

7. Тестирование удалений.

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. Просмотр данных об удалениях на панели управления AppsFlyer.

Результаты измерения количества удалений отображаются на главной панели в сводной таблице показателей эффективности.

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.