mytracker_sdk

Description:

mytracker sdk

myTracker Flutter SDK #



Общая информация
Инициализация

Доступные для настройки параметры

MyTrackerConfig
MyTrackerParams


Включение/выключение режима отладки


События

Общая информация #
myTracker — Мультиплатформенная система аналитики и атрибуции на базе технологий Mail.ru Group.
Минимальные требования #
Android

Android api level 21 (Android 5.0)
Разрешение android.permission.INTERNET
Разрешение android.permission.ACCESS_NETWORK_STATE

Обязательные зависимости, которые будут добавлены автоматически:

Google Play Services (модуль com.google.android.gms:play-services-ads-identifier)
Google Play Install Referrer (модуль com.android.installreferrer:installreferrer)

iOS

Минимальная поддерживаемая версия iOS - 12.4

В случае, если необходимо получение информации об IDFA/IDFV на iOS 14+, то необходимо получение разрешения от пользователя.
Для решения, возможно использовать App Tracking Transparency Plugin. Или реализовать запрос разрешений самостоятельно.
Данные о местоположении #
Если необходим сбор данных о местоположении, то добавление разрешений на доступ к локации и запрос этих разрешений также является обязательным.
Для решения данной задачи можно воспользоваться Location Permission Plugin. Или реализовать запрос разрешений самостоятельно.
Приложения для Huawei App Store #
Если вы делаете сборку приложения для Huawei App Store, то обязательно наличие в проекте подключенной библиотеки
Huawei Media Services
(модуль com.huawei.hms:hms-ads-identifier), для того, чтобы myTracker мог получить
OAID.
Подключение #
pub.dev #
Используйте flutter для добавления зависимости mytracker_sdk в файл pubspec.yaml:
flutter pub add mytracker_sdk
copied to clipboard
или добавьте зависимость вручную в файл pubspec.yaml:
dependencies:
...
mytracker_sdk:
...
copied to clipboard
Вручную #
Скачайте SDK, добавьте его в ваш проект по некоторому пути PATH_TO_SDK и укажите его в качестве зависимости в pubspec.yaml вашего приложения:
dependencies:
...
mytracker_sdk:
path: PATH_TO_SDK
...
copied to clipboard
Инициализация #
При инициализации трекера необходимо указать ваш appId.
При необходимости до инициализации, можно выполнить дополнительную конфигурацию трекера и параметров.
Активность приложения (запуски, сессии) отслеживается автоматически.
// При необходимости настраиваем параметры
MyTrackerParams trackerParams = await MyTracker.getTrackerParams();
MyTrackerParams trackerConfig = await MyTracker.getTrackerConfig();

// ...
// Настройка параметров трекера
// ...

// Инициализируем экземпляр
await MyTracker.init(SDK_KEY);
copied to clipboard
Доступные для настройки параметры #
Конфигурацию трекера можно произвести через экземпляр класса MyTrackerConfig, доступный через метод MyTracker.getTrackerConfig().
Параметры трекера можно настроить через экземпляр класса MyTrackerParams, который доступен через метод MyTracker.getTrackerParams().
MyTrackerConfig
Экземпляр данного класса отвечает за конфигурацию трекера и предоставляет следующие методы.
Future<MyTrackerConfig> setTrackingLaunchEnabled(boolean trackingLaunchEnabled)
copied to clipboard
Отслеживание запусков приложения. По умолчанию true.
Future<MyTrackerConfig> setLaunchTimeout(int seconds)
copied to clipboard
Интервал в секундах, в течение которого не будет засчитываться новый запуск и прерываться сессия при сворачивании приложения.
По умолчанию 30 секунд. Можно установить значение в диапазоне 30-7200 секунд.
Future<MyTrackerConfig> setBufferingPeriod(int seconds)
copied to clipboard
Интервал в секундах, в течение которого события будут накапливаться на устройстве перед отправкой на сервер.
По умолчанию 900 секунд. Можно установить значение в диапазоне 1-86400 секунд.
Future<MyTrackerConfig> setForcingPeriod(int seconds)
copied to clipboard
Интервал в секундах после установки или обновления приложения, в течение которого события будут незамедлительно отправляться на сервер.
По умолчанию 0 секунд (незамедлительная отправка выключена). Можно установить значение в диапазоне 0-432000 секунд (5 суток).
Future<MyTrackerConfig> setAutotrackingPurchaseEnabled(boolean autotrackingPurchaseEnabled)
copied to clipboard
Автоматическое отслеживание покупок в приложении.
По умолчанию true.
Future<MyTrackerConfig> setTrackingLocationEnabled(boolean trackingLocationEnabled)
copied to clipboard
Отслеживание местоположения.
По умолчанию true.
Future<MyTrackerConfig> setRegion(MyTrackerRegion region)
copied to clipboard
Установка региона сервера приёма данных.
Доступные значения:

MyTrackerRegion.EU - Европа.
MyTrackerRegion.RU - РФ.

Future<MyTrackerConfig> setProxyHost(@Nullable String proxyHost)
copied to clipboard
Установка прокси-хоста сервера приёма данных.
MyTrackerParams
Экземпляр данного класса предназначен для настройки пользовательских параметров.
Пользовательские параметры могут быть установлены в любой момент работы приложения.
Future setUserInfo() async
{
MyTrackerParams trackerParams = await MyTracker.getTrackerParams();

// Устанавливаем пол
await trackerParams.setAge(22);
// Устанавливаем возраст
await trackerParams.setGender(MyTrackerGender.FEMALE);
// Устанавливаем айди
trackerParams.setCustomUserIds(["user_id_0", "user_id_1"]);
//Устанавливаем адреса электронной почты
trackerParams.setEmails(["[email protected]", "[email protected]"]);
//Устанавливаем номера телефонаов
trackerParams.setPhones(["84953332211", "84953332212", "84953332213"]);
}
copied to clipboard
Включение/выключение режима отладки #
Включение/выключение режима отладки производится через статические методы класса MyTracker.
Future setDebugMode(boolean debugMode)
copied to clipboard
Включение/выключение режима отладки.
По умолчанию false.
Трекинг событий #
События можно отправлять через статические методы класса MyTracker.
Доступны следующие методы для трекинга различных типов событий:
Future trackLoginEvent(String userId, String? vkConnectId, Map<String, String>? eventParams)
copied to clipboard
Событие логина.
Обязательный параметр userId задаёт идентификатор пользователя.
Дополнительный параметр vkConnectId задаёт VK идентификатор пользователя.
Дополнительный параметр eventParams позволяет задать произвольные параметры ключ-значение для события.
Максимальная длина ключа и значения - 255 символов.
Future trackRegistrationEvent(String userId, String? vkConnectId, Map<String, String>? eventParams)
copied to clipboard
Событие регистрации.
Обязательный параметр userId задаёт идентификатор пользователя.
Дополнительный параметр vkConnectId задаёт VK идентификатор пользователя.
Дополнительный параметр eventParams позволяет задать произвольные параметры ключ-значение для события.
Максимальная длина ключа и значения - 255 символов.
Future trackEvent(String name, Map<String, String>? eventParams)
copied to clipboard
Произвольное событие с заданным именем.
Дополнительный параметр eventParams позволяет задать произвольные параметры ключ-значение для события.
Максимальная длина ключа и значения - 255 символов.
Например:
MyTracker.trackEvent("name", {"key_0": "value_0", "key_1": "value_1"});
copied to clipboard
Future flush()
copied to clipboard
Принудительная отправка всех событий и сброс таймера отправки.