В этом документе описывается, как начать использовать Google Analytics SDK для Android v3.
Прежде чем вы начнете
Прежде чем внедрять SDK, убедитесь, что у вас есть следующее:
- SDK для разработчиков Android (доступен для Windows, Mac OS X и Linux)
- Google Analytics SDK для Android v3 (с включенным в каталог
/libs
вашего проектаlibGoogleAnalyticsServices.jar
и путь сборки) - Приложение для Android, которое можно использовать для реализации Google Analytics.
- По крайней мере один ресурс 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
, как показано в следующем примере:
package com.example.app; import android.app.Activity; import com.google.analytics.tracking.android.EasyTracker; /** * An example Activity using Google Analytics and EasyTracker. */ 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(this).activityStart(this); // Add this method. } @Override public void onStop() { super.onStop(); ... // The rest of your onStop() code. EasyTracker.getInstance(this).activityStop(this); // Add this method. } }
3. Создание файла Analytics.xml.
Когда вы используете EasyTracker, глобальные параметры конфигурации управляются с помощью ресурсов, определенных в XML. Создайте файл с именем analytics.xml
в каталоге res/values
вашего проекта и добавьте следующие ресурсы:
<?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. В зависимости от требований вашего приложения вы можете изменить период отправки , чтобы убедиться, что вы правильно отправляете обращения. Например, если вы хотите видеть данные в реальном времени, вы можете установить низкое значение, например 5 с.
Поздравляем! Теперь ваше приложение настроено для отправки данных в Google Analytics.
Следующие шаги
С помощью Google Analytics вы можете делать гораздо больше, включая измерение кампаний, платежей и транзакций в приложениях, а также событий взаимодействия с пользователем.
Следующие руководства для разработчиков содержат дополнительную информацию о том, как реализовать функции Google Analytics в вашем приложении:
- Измерение событий . Узнайте, как измерять взаимодействие пользователей с интерактивным контентом, таким как кнопки, видео и другие медиа, с помощью событий.
- Измерение платежей в приложениях . Узнайте, как измерять платежи и транзакции внутри приложений.
- Измерение кампаний . Узнайте, как реализовать измерение кампаний, чтобы понять, какие каналы и кампании приводят к установкам приложений.
- Пользовательское время . Узнайте, как измерять пользовательское время в вашем приложении, чтобы измерять время загрузки, взаимодействие с медиа и многое другое.
- Расширенная конфигурация . Узнайте больше о расширенных параметрах конфигурации, включая использование нескольких трекеров.
- Параметры Analytics.xml — см. полный список параметров конфигурации
analytics.xml
.