В этом руководстве по миграции описаны новые возможности SDK версии 2, а также даны разработчикам советы по переходу с реализации версии 1.x. Разработчики, которым не требуется переход с реализации версии 1.x, могут начать работу с версией 2 прямо сейчас.
Введение
Google Analytics недавно выпустила обновленный Google Analytics SDK для Android версии 2. Версия 2 SDK содержит поддержку новых функций и новый интерфейс отчетов, разработанный специально для разработчиков приложений.
Мы рекомендуем всем существующим разработчикам Google Analytics перейти на версию 2 Google Analytics SDK для Android, чтобы воспользоваться преимуществами новых функций и отчетов.
Что нового в версии 2
Google Analytics SDK для Android версии 2 представляет новый интерфейс отчетности, предназначенный для разработчиков приложений, новые мощные параметры и показатели и многое другое. Вот что разработчики получают от версии 2:
- Более мощные отчеты для разработчиков приложений
- Стандартные отчеты были переработаны для разработчиков приложений: добавлены новые отчеты, такие как «Поток взаимодействия» и «Источники Google Play», которые помогут разработчикам получить новое представление о привлечении пользователей и взаимодействии с ними. Прочтите наши рекомендации по настройке учетной записи , чтобы узнать больше о том, как лучше всего настроить свой ресурс для версии 2.
- Новые параметры и показатели приложения
- Во второй версии SDK были представлены новые параметры и показатели, специфичные для приложения, включая имя экрана и количество просмотров экрана, имя приложения, версию приложения и многое другое.
- Измерение сбоев и исключений
- В Google Analytics SDK для Android реализованы методы измерения исключений и тип попадания в исключения. Используя измерение исключений, вы можете измерить количество и тип сбоев и нефатальных исключений. Чтобы узнать, как реализовать измерение исключений, см. Руководство разработчика исключений .
- Специальные параметры и показатели
- Создавайте специальные параметры, чтобы сегментировать данные по-новому. Узнайте больше о специальных параметрах и показателях.
- Измеряйте социальные взаимодействия
- Получите новое представление о ценности социальных сетей в вашем приложении, измеряя взаимодействие пользователей с помощью встроенных социальных плагинов и виджетов. Узнайте больше об измерении социальных взаимодействий.
Прежде чем вы начнете
Все разработчики захотят выполнить эти два шага перед началом миграции:
- Загрузите Google Analytics SDK для Android v2.
- Создайте представление (профиль) приложения , которое вы будете использовать для доступа к новым отчетам и данным приложения.
Выполнив вышеуказанные шаги, следуйте инструкциям ниже для вашего пути миграции.
Миграция с EasyTracker
Чтобы перенести приложение с версии 1 на версию 2 библиотеки EasyTracker, необходимо выполнить три шага:
- Обновите параметры в файле ресурсов GoogleAnalytics.xml.
- Обновить имена методов
- Обновите приемник вещания (отслеживание кампаний в Google Play).
1. Обновите параметры в GoogleAnalytics.xml.
При переходе на версию 2 обновите параметры в файле ресурсов GoogleAnalytics.xml, поскольку некоторые из них изменились по сравнению с версией 1.x, а в версии 2 были добавлены новые параметры.
В таблице ниже показаны параметры, которые были обновлены в версии 2:
| имя параметра v1.x | имя параметра v2.x |
|---|---|
| ga_api_key | ga_trackingId |
| ga_auto_activity_tracking | ga_autoActivityTracking |
| ga_dryRun | устарел |
Чтобы узнать больше, ознакомьтесь с новыми и обновленными параметрами EasyTracker .
2. Обновить имена методов
Хотя большая часть синтаксиса во второй версии EasyTracker осталась прежней, есть некоторые заметные различия в именах методов и синтаксисе, которые потребуют обновления вашей реализации:
-
trackPageView()— этоsendView()в версии 2. Дополнительную информацию см. в Руководстве разработчика по отслеживанию экрана. - Реализация электронной коммерции была упрощена. Узнайте, как реализовать отслеживание электронной торговли во второй версии .
- Пользовательские переменные заменены специальными параметрами и показателями. Любые вызовы
setCustomVar()должны быть обновлены, чтобы воспользоваться преимуществами новой функции. Узнайте, как реализовать специальные параметры и показатели.
3. Обновите приемник широковещательной рассылки (отслеживание кампаний в Google Play).
Разработчики, реализовавшие отслеживание кампаний Google Play с помощью версии 1.x, должны учитывать, что путь к классам получателя изменился. Дополнительную информацию см. в Руководстве по отслеживанию кампаний Google Play .
Миграция из пользовательской реализации
Если вы не использовали библиотеку EasyTracker в версии 1.x Analytics SDK для Android, мы рекомендуем вам начать использовать EasyTracker в версии 2.
Библиотека EasyTracker теперь включена в SDK и рекомендуется всем разработчикам. Начните использовать EasyTracker в Google Analytics SDK v2 .
Если у вас есть дополнительные потребности в сборе данных, например использование нескольких идентификаторов свойств в одной реализации, прочтите Руководство по расширенной настройке, чтобы узнать больше об использовании расширенных функций версии 2.x SDK.