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

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

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

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

1. Создайте на платформе Firebase проект приложения для Android (если это еще не сделано) или перенесите свой проект из консоли Google Developer Console (следуйте инструкциям консоли). Подробные сведения см. здесь:

2.  Откройте консоль Firebase:

3.  На странице Firebase Console перейдите в раздел "Project Settings" (Настройки проекта) (нажмите на значок шестеренки рядом с заголовком "Overview" (Обзор) на левой панели страницы).

4. На вкладке "Cloud Messaging" (Облачные сообщения) вы увидите свой идентификатор отправителя "Sender ID" (то есть номер проекта, необходимый в случае использования GCM) и два серверных ключа (см. снимок экрана ниже):

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

5.  Скопируйте серверный ключ.

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

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

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

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

3.  Введите в поле Firebase Server Key только что скопированный серверный ключ (это поле единого серверного ключа для GCM и Firebase-Messaging).

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

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

• Если у вас нет этого файла, вы можете загрузить его в разделе Project Settings (Настройки проекта) своего проекта на консоли Firebase Console.

Затем вам необходимо добавить к своему проекту зависимости Firebase-Messaging:

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

dependencies {
     implementation 'com.google.firebase:firebase-messaging:17.3.4'
}

// ДОБАВИТЬ ВНИЗУ  
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"
}

// ДОБАВИТЬ ВНИЗУ  
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 с функцией измерения количества удалений

При использовании ProGuard необходимо добавить следующие правила, согласно которым используется служба рассылки сообщений (Firebase или 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.  Если вы еще не зарегистрировали идентификатор приложения, нажмите знак + и заполните форму.

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

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

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

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

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

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

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

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

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-уведомления на уровне кода приложения.

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

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

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

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

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

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

Показатели по удалениям в сводной таблице обновляются каждые 24 часа.

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