Войти

Подключение SDK

MyTracker SDK — это пакет библиотек для сбора статистики по приложениям. Трекинг работает как на мобильных, так и на веб-платформах и позволяет сформировать единую картину по вашему проекту.

Подключите MyTracker SDK для iOS | Android | Unity | Flutter | React Native | Web.

Сбор данных

По умолчанию SDK собирает следующие данные:

  • настройки и состояние SDK трекера
  • информацию по приложению: версия, идентификаторы, язык
  • информацию об устройстве: идентификаторы, модель, ОС, версия, язык, размер экрана и пр.
  • информацию о сети: оператор, тип соединения, WiFi, Bluetooth
  • местоположение устройства (только с согласия пользователя и если соответствующий запрос встроен в приложение)
  • запуски приложения
  • данные по сессиям
  • данные по платежам (только для iOS, для Android необходима настройка).

Также можно настроить трекинг любых событий внутри приложения:

  • регистрации
  • авторизации
  • достижение уровня и пр.

Чтобы убедиться, что SDK подключён и данные поступают в систему, на странице приложения перейдите на вкладку Статус интеграции. Отслеженные данные можно проанализировать в интерфейсе MyTracker  или выгрузить через API.

В анкетах App Store и Google Play о конфиденциальности и безопасности данных, используйте информацию из раздела Конфиденциальность и безопасность

История версий

Последние версии SDK:

  • iOS 3.2.0 от 6 сентября 2024
  • Android 3.3.2 от 14 августа 2024
  • Unity 3.0.3 от 28 марта 2023
  • Flutter 3.1.0 от 24 июля 2024
  • React Native 1.0.3 от 26 августа 2024
Версия Дата Изменения

iOS

3.2.02024-09-06 Поддержка Xcode 16
3.1.132024-07-30 Небольшие исправления и улучшения
3.1.122024-07-04 Небольшие исправления и улучшения
3.1.112024-06-21 Повышена стабильность
3.1.102024-05-27 Обновлён манифест конфиденциальности
3.1.92024-05-14 Улучшения и исправления
3.1.82024-04-19 Добавлен манифест конфиденциальности
Небольшие исправления и улучшения
3.1.72024-04-03 Улучшен механизм передачи событий на сервер MyTracker. Теперь при отправке кастомных событий учитывается userId на момент возникновения события, а не на момент отправки данных на сервер
Добавлена поддержка Logger для вывода структурированных сообщений в консоль
Улучшения и исправления
3.1.62024-02-27 Исправлены ошибки
3.1.52024-01-23 Добавлена возможность задавать кастомного логгера
Исправлены некоторые ошибки
3.1.42024-01-09 Исправлены ошибки
3.1.32023-12-26 Реализована поддержка iOS 17
Исправлен deadlock
3.1.22023-11-30 Исправлены ошибки
3.1.12023-11-11 Улучшения и исправления
3.1.02023-10-16 Минимальная поддерживаемая версия iOS поднята до 12.4
Добавлена возможность проверить результат принудительной отправки событий — callback для метода flush
3.0.82023-03-08 Добавлена поддержка Personalize API
Небольшие улучшения и исправления
3.0.72022-08-23 Улучшен трекинг сессий
Проведены множественные улучшения и доработки
3.0.62022-02-04 Стандартизировано API для Swift: изменены имена параметров
Небольшие улучшения, которые позитивно скажутся на точности вероятностной атрибуции Probabilistic
3.0.52021-10-28 Включена генерация Bitcode для симуляторов
3.0.42021-09-30 Исправлена ошибка, возникающая при подключении фреймворка AdServices через Swift Package Manager
3.0.32021-09-08 Исправлена ошибка, которая в редких случаях могла привести к падению приложения
3.0.22021-07-29 Реализовано взаимодействие с Apple AdServices для атрибуции по данным Apple Search Ads на iOS 14+
Добавлены зависимости в SPM пакет
3.0.12021-07-05 Прекращена обработка данных от датчика приближения, которая могла привести к выключению экрана
3.0.02021-06-09 Изменён протокол хранения и передачи данных:
  • повышена безопасность протокола: перехватить и подделать запрос к MyTracker теперь гораздо сложнее;
  • снижен объём передаваемых данных;
  • увеличена скорость обработки запросов на стороне сервера.
2.2.12020-12-21 Улучшен механизм обнаружения Jailbreak устройств
2.2.02020-11-12 Добавлены методы для трекинга событий Mini Apps
Улучшения
2.1.22020-09-22 Для iOS 14 исправлен признак трекинга idfa
Добавлен сбор данных о текущем статусе батареи и уровне заряда
2.1.12020-09-15 Исправлена ошибка, возникающая при подготовке приложений к публикации
2.1.02020-09-09 Реализована поддержка iOS 14 и SKAdNetwork.
Исправлена ошибка двойного декодирования диплинков
2.0.102020-08-26 Увеличен лимит до 255 символов для кастомных событий и их параметров
2.0.92020-08-19 Скорректирована отправка eventParams для событий покупки, созданных вручную
2.0.82020-08-13 Добавлена обработка значений Double.NaN
Скорректирована документация для AdEventBuilder
2.0.72020-07-17 Исправлена ошибка, из-за которой временная метка события могла быть зафиксирована в будущем времени
Улучшен механизм сбора данных о текущем интернет-соединении
2.0.62020-06-26 Добавлен обязательный параметр userId в методы трекинга регистрации и авторизации.
Добавлено API для трекинга встроенной рекламы
2.0.52020-06-04 Улучшен трекинг покупок.
Прочие небольшие улучшения.
2.0.42020-03-10 Исправлена ошибка в определении локаций, которая приводила к падению приложений на iPhone 5/5c c iOS 10.x
2.0.32020-03-06 Исправлена ошибка в iAd атрибуции.
2.0.22020-02-04 Добавлен метод для получения instanceId (идентификатора устройства для S2S API).
Добавлено описание методов.
2.0.12019-12-30 Исправлены ошибки.
2.0.02019-12-23 Улучшена архитектура и производительность библиотеки:
  • Исключён метод createTracker
  • Разграничены настройка трекера (класс MyTrackerConfig) и настройка пользовательских параметров (класс MyTracker.trackerParams)
  • Введена асинхронность в методы трекинга событий (исключён возврат булева значения)
Минимальная поддерживаемая версия iOS поднята до 8
Создано демо-приложение на Swift
1.7.92019-08-22 Реализована поддержка iOS 13.
1.7.82019-06-13 Добавлена возможность установить регион, где расположен сервер сбора статистики.
1.7.72019-05-28 Улучшен трекинг запусков приложений. Запуск с push-уведомления не фиксируется, если приложение осталось в фоновом режиме.
1.7.62019-02-19 Добавлены параметры для сбора данных о цене inApp покупки.
1.7.52018-12-13 Добавлена настройка параметра forcingPeriod позволяющего включить немедленную отправку событий на сервер в течении определенного периода после установки/обновления приложения.
1.7.42018-04-24 Улучшения в трекинге диплинков.
1.7.32018-04-18 Добавлена поддержка трекинга диплинков.
1.7.22018-03-19 Добавлена проверка устройства на наличие Jailbreak.
Ограничено количество одновременных сетевых подключений.
1.7.12018-02-16 Добавлен метод flush() для принудительной отправки событий.
1.7.02018-01-16 Добавлен автоматический трекинг inApp покупок.
Улучшена валидация параметров кастомных событий.
1.6.42017-09-27 Улучшения.
1.6.32017-09-13 Исправления и улучшения.
1.6.02017-07-13 Добавлена поддержка отложенных диплинков.
Добавлено поле original_transaction_id (восстановленные in-app покупки).
Добавлена возможность задавать параметры в единственном числе.
1.5.132017-06-15 Добавлена возможность менять период буферизации.
1.5.122017-04-20 Исправления и улучшения.
1.5.102017-03-03 Исправлены ошибки при работе с CoreTelephony.
1.5.92017-02-14 Исправления и улучшения.
1.5.82017-02-09 Минимальная поддерживаемая версия iOS — 7.0.
1.5.62017-01-23 Методы трекинга событий теперь возвращают булево значение.
1.5.52016-12-15 Исправлена ошибка в трекинге SearchAd Attribution.
1.5.32016-09-20 Добавлена поддержка SearchAd attribution tracking.
Добавлено кеширование IDFV в UserDefaults.
1.5.22016-08-30 Исправления и улучшения.
1.5.12016-08-03 Добавлена поддержка CocoaPods.
Исправления и улучшения.
1.4.82016-07-06 Улучшен трекинг сессий.
Исправлены ошибки.
1.4.32016-02-24 Исправлена ошибка при сборке с bitcode.
1.4.02015-12-22 Добавлен механизм трекинга сессий.
Добавлен трекинг сотовых и Wi-Fi сетей — исправление ошибок.

Android

3.3.22024-08-14 Исправлены ошибки в работе SDK
3.3.12024-08-05 Небольшое улучшение кода
3.3.02024-06-19
Удалена функция MyTrackerConfig.setRegion.
Удалён метод MyTracker.flush (final @Nullable FlushListener flushListener).
Оптимизирован процесс инициализации MyTracker.
Улучшения и исправления общего характера.
3.2.02023-10-16 Исправления и улучшения
3.1.22023-09-08 Исправлена ошибка в отправке событий
3.1.12023-08-22 Добавлена возможность проверить результат принудительной отправки событий — callback для метода flush.
Ошибка в сборке 3.1.1 исправлена в версии 3.1.2
3.1.02023-07-21 Минимальная поддерживаемая версия Android поднята до 5.0 (API Level 21).
Обновлена минимально поддерживая версия Google Play Billing Library. Поддерживаемые версии: 5-6.
Улучшения и исправления.
Ошибка в сборке 3.1.0 исправлена в версии 3.1.2
3.0.122023-04-17 Добавлен метод для трекинга предустановок в ретейле
3.0.112023-03-01 Добавлена поддержка Personalize API
Небольшие улучшения и исправления
3.0.102022-09-21 Автоматический сбор SSAID и MAC отключён. Добавлен метод для передачи SSAID и MAC в ручном режиме. Подробнее см. раздел Сбор идентификаторов устройств.
3.0.92022-09-05 Сбор данных о местоположении устройства по умолчанию отключён. Чтобы включить отправку данных, используйте параметр TrackingLocationEnabled
Незначительные улучшения и доработки
3.0.82022-08-12 Исправлена ошибка, которая приводила к падению приложения с target API 32
3.0.72022-07-22 Незначительные улучшения
3.0.62022-05-23 Добавлена поддержка AppGallery Install Referrer
3.0.52022-04-15 Обновлены версии зависимостей
3.0.42022-02-02 Небольшие улучшения, которые позитивно скажутся на точности вероятностной атрибуции Probabilistic
3.0.32021-12-23 Обновлена версия BillingClient
Обновлена версия targetSdk до 31
3.0.22021-12-15 Реализована поддержка App Set ID.
App Set ID позволит идентифицировать устройства, в случае если рекламный идентификатор (GAID) будет недоступен. Подробнее см. документацию Google Play Console
3.0.12021-10-05 В манифест добавлено разрешение com.google.android.gms.permission.AD_ID.
Подробнее о предстоящих изменениях на Android 12 см. документацию Google Play Console

Изменено форматирование денежных единиц: десятичная запятая заменена на точку

Внесены изменения для работы в режиме StrictMode
3.0.02021-06-01 Изменён протокол хранения и передачи данных:
  • повышена безопасность протокола: перехватить и подделать запрос к MyTracker теперь во много раз сложнее;
  • снижен объём передаваемых данных;
  • увеличена скорость обработки запросов на стороне сервера.
2.1.22021-03-23 Поддержана новая версия библиотеки Install Referrer (2.2)
2.1.12021-03-05 Поддержана новая схема трекинга предустановок
2.1.02020-11-11 Добавлены методы для трекинга событий Mini Apps
В вызов AttributionListener добавлен сценарий получения данных от API Install Referrer
2.0.112020-10-15 Добавлен сбор данных о текущем статусе батареи и уровне заряда
2.0.102020-08-26 Увеличен лимит до 255 символов для кастомных событий и их параметров
2.0.92020-07-07 Изменено API для трекинга встроенной рекламы: withFormat → withAdFormat
Исправления и улучшения
2.0.82020-06-18 Добавлен обязательный параметр userId в методы трекинга регистрации и авторизации
Добавлено API для трекинга встроенной рекламы
2.0.72020-06-01 Улучшен трекинг покупок
2.0.62020-05-26 Обновлена версия targetSdk до 29
2.0.52020-05-22 Поддержана новая версия библиотеки Install Referrer (1.1.2)
2.0.42020-04-07 Исправлена ошибка трекинга покупок
2.0.32020-03-20 Добавлена поддержка Billing Library 2.1.0 для трекинга покупок
Прекращено использование AIDL-сервиса для запроса информации о продукте
2.0.22020-02-21 Добавлена возможность трекинга предустановок
2.0.12020-02-04 Добавлен метод для получения instanceId (идентификатора устройства для S2S API)
2.0.02020-01-27 Улучшена архитектура и производительность библиотеки:
  • Исключён метод createTracker
  • Разграничены настройка трекера (класс MyTrackerConfig) и настройка пользовательских параметров (класс MyTracker.trackerParams)
  • Введена асинхронность в методы трекинга событий (исключён возврат булева значения)
Создано демо-приложение на Kotlin
1.5.142019-12-03 Улучшения
1.5.132019-11-21 Незначительные улучшения
1.5.122019-11-06 Скорректированы сообщения консоли
1.5.112019-10-31 Добавлена поддержка Bluetooth маячков
1.5.102019-10-18 Добавлена поддержка Huawei OAID (Open Advertising Identifier)
1.5.92019-09-18 Поддержаны новые механизмы Android 10 по защите геолокационных данных
1.5.82019-06-14 Добавлена возможность установить регион, где расположен сервер сбора статистики.
1.5.72019-05-20 Добавлены параметры для сбора данных о цене inApp покупки.
1.5.62019-03-18 Исправлена ошибка зависимостей в файле pom.xml.
1.5.52018-12-14 Добавлена настройка параметра forcingPeriod, позволяющего включить немедленную отправку событий на сервер в течении определенного периода после установки/обновления приложения.
Минимальная поддерживаемая версия Android поднята до 4.0 (API Level 14).
Удалены методы onStartActivity/onStopActivity, использовавшиеся в версиях до Android 4.0 для получения данных об активности пользователя.
1.5.42018-05-16 Добавлена поддержка диплинков.
1.5.32018-05-03 Отключен сбор идентификаторов IMEI/MEID.
1.5.22018-03-21 Добавлена проверка на наличие root на устройстве.
Добавлен метод trackLaunchManually() который необходимо вызвать при инициализации MyTracker из активности а не из класса Application.
1.5.12018-02-12 Добавлен метод flush() для принудительной отправки событий.
1.5.02018-02-05 Добавлен автоматический трекинг inApp покупок.
Улучшена валидация параметров кастомных событий.
1.4.52017-12-21 Добавлена поддержка Google Install Referrer API.
Добавлено автоматическое получение данных о запусках активностей.
Для получения идентификатора устройства в версиях API 26+ теперь используются функции getImei()/getMeid, вместо устаревшей getDeviceId().
1.4.42017-12-06 Добавлена обработка ошибки записи при переполнении памяти устройства.
1.4.32017-10-27 Добавлен класс MultipleInstallReceiver облегчающий использование нескольких трекинг систем в одном приложении.
1.4.22017-09-13 Исправления и улучшения.
1.4.02017-07-13 Добавлена поддержка отложенных диплинков.
1.3.142017-06-09 Добавлена возможность менять период буферизации.
1.3.132017-04-20 Исправлены ошибки.
1.3.102017-01-23 Методы трекинга событий теперь возвращают булево значение.
Дополнительно в сведениях об устройстве добавлены xdpi и ydpi.
1.3.92016-12-23 Исправлены ошибки.
1.3.82016-10-03 Незначительные улучшения.
1.3.62016-09-23 Добавлена в зависимости play-services-basement.
Исправления и улучшения.
1.3.52016-08-30 Исправления и улучшения.
1.3.42016-08-15 Добавлено ограничение на 64 символа в полях событий.
1.3.32016-08-03 Добавлены дополнительные проверки разрешений для устройств с Android 6+.
1.3.22016-08-01 Исправлены ошибки.
1.3.12016-06-10 Библиотека опубликована в публичном репозитории JCenter. Теперь её можно подключать через однострочную зависимость в build.gradle файле вашего проекта.
Пакет классов библиотеки сменился с ru.mail.android на com.my.tracker.
Улучшен механизм трекинга сессий.
Добавлен трекинг инсталлера (установщика, из которого было установлено приложение) для событий install, referrer, update.
1.2.22016-02-03 Улучшен механизм отправки реферрера при установке.
1.2.02015-12-16 Добавлен механизм трекинга сессий.
Добавлен трекинг сотовых и Wi-Fi сетей.

Unity

3.0.32023-03-28 Обновлены версии iOS (3.0+) и Android (3.0+) библиотек
Добавлен параметр RegisterForSkAdAttribution для вкл/выкл SKAdNetwork атрибуции
3.0.22022-09-08 Обновлены версии iOS (3.0.7) и Android (3.0.9) библиотек
Для платформы Android сбор данных о местоположении устройства по умолчанию отключён. Чтобы включить отправку данных, используйте параметр TrackingLocationEnabled
3.0.12022-08-18 Обновлена версия EDM4U (External Dependency Manager 4 Unity)
3.0.02021-10-28 Обновлены версии iOS (3.0.4) и Android (3.0.1) библиотек
Обновлена версия GPSR до EDM4U
2.0.42020-11-11 Доработан метод TrackPurchaseEvent(String, String, String, IDictionary<String, String>)
2.0.32020-09-16 Обновлены версии iOS (2.1.1) и Android (2.0.10) библиотек
2.0.22020-07-20 Изменено API для трекинга встроенной рекламы: AdFormat.Interstial → Interstitial
Обновлены версии iOS (2.0.7) и Android (2.0.9) библиотек
2.0.12020-07-07 Добавлен обязательный параметр userId в методы трекинга регистрации и авторизации
Добавлено API для трекинга встроенной рекламы
Обновлены версии iOS (2.0.6) и Android (2.0.9) библиотек
2.0.02020-02-26 Улучшена архитектура и производительность библиотеки:
  • Исключён метод createTracker
  • Разграничены настройка трекера (класс MyTrackerConfig) и настройка пользовательских параметров (класс MyTracker.trackerParams)
  • Введена асинхронность в методы трекинга событий (исключён возврат булева значения)
Реализован переход на управление зависимостями с помощью GPSR.
Добавлен метод для получения instanceId (идентификатора устройства для S2S API).
Минимальная поддерживаемая версия iOS поднята до 8
1.2.82019-11-26 Исправлена ошибка в трекинге покупок.
1.2.72019-07-16 Добавлена возможность установить регион, где расположен сервер сбора статистики.
1.2.62018-12-25 Добавлена настройка параметра forcingPeriod позволяющего включить немедленную отправку событий на сервер в течении определенного периода после установки/обновления приложения.
Минимальная поддерживаемая версия Android поднята до 4.0 (API Level 14).
1.2.52018-08-20 Исправлена ошибка Unity 2018.2
1.2.42018-05-18 Актуализированы версии iOS (1.7.4) и Android (1.5.4) библиотек.
Исправлена ошибка возникающая при сборке проекта при помощи Gradle.
1.2.32018-03-21 Актуализированы версии iOS и Android библиотек.
Добавлена проверка на наличие Jailbreak/Root на устройстве.
1.2.22018-03-15 Исправлена ошибка обработки inApp платежей в Android.
1.2.12018-03-12 Исправлена ошибка валидации inApp платежей в iOS.
1.2.02018-03-05 Добавлена поддержка автоматического трекинга покупок в iOS.
Добавлена поддержка автоматического трекинга запусков в Android.
Добавлен метод Flush() для принудительной отправки событий.
1.1.02017-09-27 Добавлены события покупок.
1.0.02017-09-21 Реализована базовая функциональность трекера.

Flutter

3.1.02024-07-24 Обновлены версии iOS (3.1.11) и Android (3.3.0) библиотек:
  • Минимальная поддерживаемая версия iOS поднята до 12.4, Android до 5.0.
  • Улучшен механизм передачи событий на сервер MyTracker. Теперь при отправке кастомных событий учитывается userId на момент возникновения события, а не на момент отправки данных на сервер.
  • Добавлен метод для получения instanceId (идентификатора устройства для S2S API).
  • Реализована поддержка App Set ID.
    App Set ID позволит идентифицировать устройства, в случае если рекламный идентификатор (GAID) будет недоступен. Подробнее см. документацию Google Play Console
  • В манифест добавлено разрешение com.google.android.gms.permission.AD_ID.
  • Сбор данных о местоположении устройства по умолчанию отключён. Чтобы включить отправку данных, используйте параметр TrackingLocationEnabled.
3.0.02021-08-13 Реализована базовая функциональность трекера.

React Native

1.0.32024-08-26 Обновлены версии iOS (3.1.12) и Android (3.3.0) библиотек:
  • Минимальная поддерживаемая версия iOS поднята до 12.4, Android до 5.0.
  • Улучшен механизм передачи событий на сервер MyTracker. Теперь при отправке кастомных событий учитывается userId на момент возникновения события, а не на момент отправки данных на сервер.
  • Обновлен метод для сбора данных о местоположении пользователя. По умолчанию включён для iOS и выключен для Android.
1.0.22023-09-12 Реализована базовая функциональность трекера.
Была ли эта статья полезна?