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

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

Измерение количества удалений с использованием службы Firebase Messaging поддерживается в SDK Android начиная с версии 4.7.0.

1. Получение серверного ключа Firebase

1. Создайте на платформе Firebase проект приложения для Android (если это еще не сделано) или перенесите свой проект из консоли Google Developer Console (следуйте инструкциям консоли). Чтобы получить дополнительную информацию, смотрите Firebase. 
2. Откройте консоль Firebase.
3. На странице консоли Firebase перейдите в раздел "Project Settings" (Настройки проекта) (нажмите на значок шестеренки рядом с заголовком "Project Overview" (Обзор проекта) на левой панели страницы).
4. На вкладке "Cloud Messaging" (Облачные сообщения) вы увидите два серверных ключа (см. снимок экрана ниже):
   
   
5. Скопируйте серверный ключ.

2. Ввод серверного ключа на панели управления AppsFlyer.

1. Перейдите на панель управления своего приложения на платформе AppsFlyer.
2. Выберите App Settings (Настройки приложения) в меню слева.

   

3. Ведите в поле Firebase Server Key только что скопированный серверный ключ.

3. Настройка Firebase-Messaging в вашем приложении.

1. Загрузите файл google-services.json с консоли Firebase.
2. Добавьте файл google-services.json в каталог модулей своего приложения,
3. Добавьте правила в файл build.gradle корневого уровня, чтобы включить в проект плагин google-services:

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

4. Добавьте зависимость GCM в файл build.gradle уровня приложения:

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

Последняя версия Firebase доступна здесь: официальный документ Firebase.

В случае появления ошибки "Could not find..." (Не удалось найти...), убедитесь, что программа Android SDK Manager использует последний репозиторий Google. 

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 выполняется очень просто.

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

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

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

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

2.  Если вы еще не зарегистрировали идентификатор приложения, нажмите знак + и заполните форму.

3.  Установите флажок "Push Notifications" (Push-уведомления).

4.  При добавлении службы в приложение на экране появятся два параметра для push-уведомлений со значками состояния желтого или зеленого цвета:

5.  Чтобы продолжить, нажмите кнопку Settings  (Настройки).

2. Создание сертификата.

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

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

4. Экспорт файла P12.

Последний этап перед возвратом на панель управления AppsFlyer, это сохранение подписанного сертификата в виде файла .р12.

1.  Выберите сертификат, который только что был добавлен в окно "Keychain Access" (Связка ключей). 

2. Откройте Файл > Экспорт.

3.  Выберите в меню "Category" (Категория) на левой панели пункт My Certificates (Мои сертификаты).

Если пункт My Certificates (Мои сертификаты) не выделен, невозможно экспортировать сертификат в виде файла формата .p12.

3.  Для сохранения файла используйте формат Personal Information Exchange (.p12) .

4.  Убедитесь, что окно выглядит, как показано ниже, и в нем есть строка Apple Push Services (Служба Push-уведомлений Apple):

5.  Перейдите на панель управления своего приложения на платформе AppsFlyer.

6. Выберите App Settings (Настройки приложения) в меню слева.

7. Щелкните на значке загрузки и выберите файл P12 для загрузки. 

8. (вариант) Если сертификат P12  защищен паролем, введите пароль в поле P12 certificate Password. 

9.  Нажмите кнопку Validate  (Проверка), чтобы отправить сертификат в AppsFlyer и проверить, действителен ли он. 

10.  Нажмите кнопку Save Settings (Сохранить настройки).

5. Интеграция с SDK

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

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

Если вы используете только бесшумные Push-уведомления, включите функцию Remote Notifications ("Удаленные уведомления") в разделе Background Modes ("Фоновые режимы") на вкладке Capabilities ("Возможности"):

1. Выберите свой проект в XCode.
2. Выберите цель.
3. Перейдите на вкладку Capabilities ("Возможности").
4. Включите Background Modes ("Фоновые режимы").
5. Установите флажок Remote notifications ("Удаленные уведомления").
   
   

6. Push-уведомления.

На вкладке "Capabilities" (Возможности) своего проекта в XCode обязательно добавьте возможность Push-уведомлений. Без этого получить токен устройства будет невозможно.

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

При тестировании удаления  из Xcode или TestFlight важно, чтобы наш SDK знал, что токен сгенерирован в безопасной среде. Используйте следующий API:

AppsFlyerTracker.shared().useUninstallSandbox = true

[AppsFlyerTracker sharedTracker].useUninstallSandbox = true;

Между установкой и удалением приложения задержка не требуется. Приложение можно удалить сразу после установки.

Однако от момента установки до появления удаления на панели управления может пройти до 9 дней. Кроме того, будет указана дата удаления на 9 дней позже фактической даты удаления. Дополнительные сведения см. в следующем разделе.

8. Просмотр данных об удалениях на панели управления AppsFlyer.

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

В результате последних изменений в службе Push-уведомлений Apple данные об удалениях появляются на панели управления не раньше чем через 9 дней.

Подробные сведения см. в «Руководстве по интеграции SDK», раздел «Измерение количества удалений для устройств на платформе iOS».

Постбэки событий удаления

AppsFlyer позволяет отправлять партнерам, с которыми вы работаете, постбэки событий удаления для всех известных пользователей, удаляющих приложение. На панели управления AppsFlyer событие удаления называется af_uninstall.

Сопоставление события удаления

Событие af_uninstall можно сопоставить так же, как сопоставляются другие внутренние события приложения.

AppsFlyer отправляет постбэк внутреннего события приложения только в том случае, если событие действительно произошло и зарегистрировано в AppsFlyer. Поэтому сопоставление события af_uninstall действует только для завершенных операций удаления. Если удаления не отображаются на странице обзора или в отчетах об удалениях по необработанным данным, то постбэки удаления не отправляются партнерам, даже если событие af_uninstal сопоставлено.

af_uninstall Timing

Постбэки для обычных внутренних событий приложения отправляются в режиме реального времени, а для события af_uninstall — нет.

Время регистрации события af_uninstall в необработанных данных AppsFlyer и постбэках для партнеров — это время, когда AppsFlyer узнаёт об удалении. Это происходит в течение 24 часов после фактического удаления приложения.

Ограничения

События af_uninstall не включаются в отчеты обратной передачи событий в приложении.

Событие af_uninstall в данное время доступно не всем партнерам.

Если вам нужно сопоставить это событие с событием партнера, но оказывается, что оно для партнера недоступно, обратитесь к своему менеджеру по работе с клиентами или напишите по адресу hello@appsflyer.com.

Если вы являетесь партнером и хотите получать события af_uninstall, обратитесь к своему менеджеру по работе с партнерами или напишите по адресу partners@appsflyer.com.