Google Analytics SDK для Android позволяет разработчикам легко собирать данные о взаимодействии пользователей из своих приложений. В этом документе представлен обзор преимуществ SDK, а также руководство по началу измерения вашего приложения с использованием единого идентификатора свойства и EasyTracker.
Введение
Google Analytics SDK для Android позволяет разработчикам легко собирать данные о взаимодействии пользователей из своих приложений. Затем разработчики могут использовать отчеты Google Analytics для измерения:
- Количество активных пользователей, использующих свои приложения.
- Из какой точки мира используется приложение.
- Принятие и использование специфических функций.
- Покупки и транзакции внутри приложения.
- Количество и тип приложения вылетает.
- И многие другие полезные показатели.
Кроме того, Google Analytics SDK для Android предоставляет вам инструменты для мониторинга успеха мобильной маркетинговой кампании, обеспечивая сквозной обзор эффективности ваших маркетинговых каналов, от установок Google Play до покупок и транзакций в приложениях.
Прежде чем вы начнете
Прежде чем приступить к внедрению SDK, убедитесь, что у вас есть следующее:
- SDK для разработчиков Android (доступен для Windows, Mac OS X и Linux)
- Google Analytics SDK для Android v2 (с включенным в каталог
/libs
вашего проекта и пути сборкиlibGoogleAnalyticsV2.jar
) - Приложение Android, которое можно использовать для реализации Google Analytics SDK для Android v2.
- Новый ресурс и представление приложения Google Analytics (профиль) .
Начиная
Чтобы начать работу с SDK, необходимо выполнить три шага:
Выполнив эти шаги, вы сможете измерить с помощью Google Analytics следующее:
- Установки приложений
- Активные пользователи и демографические данные
- Экраны и взаимодействие с пользователем
- Сбои и исключения
1. Обновление AndroidManifest.xml
Обновите файл AndroidManifest.xml, добавив следующие разрешения:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
2. Добавление методов EasyTracker
Добавьте методы отправки к методам onStart()
и onStop()
каждого из ваших Activities
, как показано в следующем примере:
/** * An example Activity in your app with Analytics * implemented. */ public class myTrackedActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); } @Override public void onStart() { super.onStart(); ... // The rest of your onStart() code. EasyTracker.getInstance().activityStart(this); // Add this method. } @Override public void onStop() { super.onStop(); ... // The rest of your onStop() code. EasyTracker.getInstance().activityStop(this); // Add this method. } }
Обратите внимание, что EasyTracker требует Context
, прежде чем вы сможете вызывать его методы. В приведенном выше примере эта строка:
EasyTracker.getInstance.activityStart(this);
заботится об установке контекста. Однако если вам нужно выполнить вызовы EasyTracker в других классах или методах, вам нужно сначала вызвать метод setContext(Context ctx)
EasyTracker:
// Set Context before using EasyTracker. Note that the SDK will // use the application context. EasyTracker.getInstance().setContext(this); // EasyTracker is now ready for use.
3. Создание файла Analytics.xml.
В версии 2 Google Analytics SDK для Android параметры конфигурации управляются из XML-файла ресурсов, который в этом руководстве называется analytics.xml
. Вам нужно будет создать этот файл в каталоге res/values
вашего проекта и добавить свой идентификатор отслеживания. В следующем примере показано, как добавить идентификатор отслеживания и включить отслеживание Activity
и исключений:
<?xml version="1.0" encoding="utf-8" ?> <resources> <!--Replace placeholder ID with your tracking ID--> <string name="ga_trackingId">UA-XXXX-Y</string> <!--Enable automatic activity tracking--> <bool name="ga_autoActivityTracking">true</bool> <!--Enable automatic exception tracking--> <bool name="ga_reportUncaughtExceptions">true</bool> </resources>
Программа проверки ворса может предупредить вас об использовании тире ('-') в вашем идентификаторе отслеживания. Вы можете подавить это предупреждение, добавив дополнительные атрибуты в тег <resources>
:
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
Полный список параметров, которые можно использовать для настройки реализации, см. в справочнике по параметрам Analytics.xml.
Поздравляем! Теперь ваше приложение настроено для отправки данных в Google Analytics.
Следующие шаги
С помощью Google Analytics вы можете делать гораздо больше, включая измерение кампаний, платежей и транзакций в приложениях, а также событий взаимодействия с пользователем. См. следующие руководства для разработчиков, чтобы узнать, как добавить эти функции в вашу реализацию:
- Расширенная конфигурация . Узнайте больше о расширенных параметрах конфигурации, включая использование нескольких трекеров.
- Измерение кампаний . Узнайте, как реализовать измерение кампаний, чтобы понять, какие каналы и кампании приводят к установкам приложений.
- Измерение событий . Узнайте, как измерять взаимодействие пользователей с интерактивным контентом, таким как кнопки, видео и другие медиа, с помощью событий.
- Измерение платежей в приложениях . Узнайте, как измерять платежи и транзакции внутри приложений.
- Пользовательское время . Узнайте, как измерять пользовательское время в вашем приложении, чтобы измерять время загрузки, взаимодействие с медиа и многое другое.
- Параметры Analytics.xml — см. полный список параметров конфигурации
analytics.xml
.