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

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

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

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

1. Создайте на платформе Firebase проект приложения для Android (если это еще не сделано) или перенесите свой проект из консоли Google Developer Console (следуйте инструкциям консоли). Подробные сведения см. здесь: https://firebase.google.com/docs/cloud-messaging/android/client.
2. Откройте консоль Firebase https://console.firebase.google.com
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>

5. Использование ProGuard с функцией измерения количества удалений

Если вы используете утилиту ProGuard, добавьте следующее правило:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2.  Выберите пункт File  (Файл) >> Export Items (Экспорт объектов).

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

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

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

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

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

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

7.  Нажмите кнопку Select File (Выбрать файл) и выберите свой файл .p12.

8.  Введите пароль для файла .p12 (не пароль сертификата).

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)
  }

- (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];
  }

Разрешения пользователя для Push-уведомлений 

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

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

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

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

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

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

Важно помнить, что для тестирования локальной сборки необходимо использовать TestFlight и выполнить имитационный тест на своем тестовом устройстве. Тестирование в Xcode работает только при тестировании удалений с использованием физических устройств.

При тестировании удаления важно, чтобы наш SDK знал, что токен сгенерирован в среде Sandbox. Используйте следующий 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 в данное время доступно не всем партнерам.

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

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