Примеры использования методов
Это архивная версия документации. Актуальная документация по всем платформам находится здесь.
- Инициализация библиотеки с расширенной конфигурацией
- Отправка статистики на дополнительный API key
- Отслеживание аварийных остановок приложения
- Отслеживание аварийных остановок приложения вручную
- Отслеживание нативных аварийных остановок приложения
- Отслеживание нативных аварийных остановок приложения вручную
- Отправка местоположения устройства библиотекой
- Установка местоположения вручную
- Отправка собственного события
- Отправка собственного события с вложенными параметрами
- Отправка события из JavaScript-кода WebView
- Отправка собственного сообщения об ошибке
- Отправка ProfileId
- Отправка атрибутов профиля
- Отправка ECommerce-событий
- Отправка Revenue
- Установка длительности тайм-аута сессии
- Установка версии приложения
- Определение уровня API библиотеки
- Определение версии библиотеки
- Отслеживание источников установки
- Отслеживание открытий приложения с помощью deeplink
- Запрос отложенного deeplink
- Запрос параметров отложенного deeplink
- Учет новых пользователей
- Отключение и включение отправки статистики
Инициализация библиотеки с расширенной конфигурацией
Чтобы инициализировать библиотеку с расширенной стартовой конфигурацией, создайте объект класса YandexMetricaConfig с необходимыми настройками и активируйте библиотеку с помощью метода YandexMetrica.activate(Context context, YandexMetricaConfig config). С помощью расширенной конфигурации можно, например, включить/отключить логирование, установить тайм-аут сессии, передать параметры для отслеживания предустановленных приложений и т. д.
Настройки расширенной конфигурации применяются с момента инициализации библиотеки.
public class MyApp extends Application { @Override public void onCreate() { super.onCreate(); // Creating an extended library configuration. YandexMetricaConfig config = YandexMetricaConfig.newConfigBuilder(API_key) // Setting up the configuration. For example, to enable logging. .withLogs() ... .build(); // Initializing the AppMetrica SDK. YandexMetrica.activate(getApplicationContext(), config); // Automatic tracking of user activity. YandexMetrica.enableActivityAutoTracking(this); } }
Скопировано
Чтобы настроить библиотеку в процессе работы приложения, используйте методы класса YandexMetrica.
Отправка статистики на дополнительный API key
Отправка данных на дополнительный API key позволяет собирать для каждого API key свою статистику. Это можно использовать для управления доступом к информации. Например, чтобы предоставить доступ к статистике для аналитиков, можно продублировать отправку маркетинговых данных на дополнительный API key и предоставить им доступ к этой статистике. Так у них будет доступ только к той информации, которая им необходима.
Для отправки данных на дополнительный API key необходимо использовать репортеры. С помощью них можно отправлять события, сообщения об ошибках, профили и информацию о покупках в приложении. Репортеры могут работать без инициализации AppMetrica SDK.
Шаг 1. (Опционально) Инициализируйте репортер с расширенной конфигурацией
// Creating extended configuration of the reporter. // To create it, pass an API_key that is different from the app's API_key. ReporterConfig reporterConfig = ReporterConfig.newConfigBuilder(API_key) // Setting up the configuration. For example, to enable logging. .withLogs() ... .build(); // Initializing a reporter. YandexMetrica.activateReporter(getApplicationContext(), reporterConfig);
Скопировано
Шаг 2. Настройте отправку данных с помощью репортера
Для отправки данных с помощью репортера, необходимо получить объект, который реализует интерфейс IReporter с помощью метода YandexMetrica.getReporter(Context context, String apiKey) и использовать методы интерфейса для отправки отчетов. Если репортер не был инициализирован с расширенной конфигурацией, то вызов данного метода произведет инициализацию репортера для указанного API key.
Пример отправки события:
YandexMetrica.getReporter(getApplicationContext(), API_key).reportEvent("Updates installed");
Скопировано
public class YourActivity extends Activity { ... @Override protected void onResume() { super.onResume(); YandexMetrica.getReporter(getApplicationContext(), API_key).resumeSession(); } @Override protected void onPause() { YandexMetrica.getReporter(getApplicationContext(), API_key).pauseSession(); super.onPause(); } ... }
Скопировано
Отслеживание аварийных остановок приложения
Отчеты об аварийных остановках приложения отправляются по умолчанию.
Чтобы отключить автоматическое отслеживание, инициализируйте библиотеку с конфигурацией, в которой отправка информации об аварийных остановках приложения отключена. Для этого передайте значение false
в метод withCrashReporting(boolean enabled) при создании расширенной конфигурации библиотеки.
// Creating an extended library configuration.
YandexMetricaConfig config = YandexMetricaConfig.newConfigBuilder(API_key)
// Disabling the data sending about the app crashes.
.withCrashReporting(false)
.build();
// Initializing the AppMetrica SDK.
YandexMetrica.activate(getApplicationContext(), config);
Если автоматическое отслеживание отключено, вы можете отправлять информацию об аварийных остановках вручную.
Отслеживание аварийных остановок приложения вручную
Отчеты об аварийных остановках приложения отправляются по умолчанию. Чтобы избежать дублирования событий при ручной отправке, необходимо отключить автоматическое отслеживание аварийных остановок.
Чтобы отправлять информацию об аварийных остановках приложения вручную, используйте метод YandexMetrica.reportUnhandledException(Throwable exception):
final Thread.UncaughtExceptionHandler previousUncaughtExceptionHandler = Thread.getDefaultUncaughtExceptionHandler(); // Creating a new handler. Thread.UncaughtExceptionHandler uncaughtExceptionHandler = new Thread.UncaughtExceptionHandler() { @Override public void uncaughtException(Thread thread, Throwable exception) { try { // Sending a message about an app crash to the AppMetrica server. YandexMetrica.reportUnhandledException(exception); } finally { // Sending a message about an app crash to the system handler. if (previousUncaughtExceptionHandler != null) { previousUncaughtExceptionHandler.uncaughtException(thread, exception); } } } }; // Setting the default handler. Thread.setDefaultUncaughtExceptionHandler(uncaughtExceptionHandler);
Скопировано
Отслеживание нативных аварийных остановок приложения
Отчеты о нативных аварийных остановках приложения отправляются автоматически, если SO-файлы библиотеки добавлены в проект. По умолчанию SO-файлы отсутствуют. Чтобы добавить их, подключите библиотеку отслеживания нативных крэшей.
Для подключения библиотеки добавьте следующую зависимость в файле build.gradle в блоке dependencies
:
dependencies { ... implementation 'com.yandex.android:mobmetricalib-ndk-crashes:1.1.0' }
Скопировано
Загрузите и добавьте библиотеку в проект.
Библиотека содержит в себе версии для всех платформ (arm, armv7, mips, x86). Используйте abi splits для исключения неиспользуемых библиотек.
Чтобы отключить автоматическое отслеживание, инициализируйте библиотеку с конфигурацией, в которой отправка информации о нативных аварийных остановках приложения отключена. Для этого передайте значение false
в метод withNativeCrashReporting(boolean enabled) при создании расширенной конфигурации библиотеки.
// Creating an extended library configuration. YandexMetricaConfig config = YandexMetricaConfig.newConfigBuilder(API_key) // Disabling the data sending about the native app crashes. .withNativeCrashReporting(false) .build(); // Initializing the AppMetrica SDK. YandexMetrica.activate(getApplicationContext(), config);
Скопировано
Если автоматическое отслеживание отключено, вы можете отправлять информацию о нативных аварийных остановках вручную.
Отслеживание нативных аварийных остановок приложения вручную
Отчеты о нативных аварийных остановках приложения отправляются автоматически, если SO-файлы библиотеки добавлены в проект. Если файлы были добавлены, то необходимо отключить автоматическое отслеживание нативных аварийных остановок, чтобы избежать дублирования событий при ручной отправке.
Чтобы отправлять информацию о нативных аварийных остановках приложения вручную, используйте метод YandexMetrica.reportNativeCrash(String nativeCrash):
String nativeCrashContent = "...\n" + "400ae000-400b7000 r-xp 00000000 103:0c 835 /system/lib/libcutils.so\n" + "400b7000-400b8000 r--p 00008000 103:0c 835 /system/lib/libcutils.so\n" + "400b8000-400b9000 rw-p 00009000 103:0c 835 /system/lib/libcutils.so\n" + "400b9000-400bc000 r-xp 00000000 103:0c 1454 /system/lib/liblog.so\n" + "..."; // Sending native app crash information. YandexMetrica.reportNativeCrash(nativeCrashContent);
Скопировано
Отправка местоположения устройства библиотекой
Начиная с версии 5.0.0 AppMetrica Android SDK отправка местоположения устройства по умолчанию отключена.
true
в метод withLocationTracking(boolean enabled) при создании расширенной конфигурации библиотеки.// Creating an extended library configuration. YandexMetricaConfig config = YandexMetricaConfig.newConfigBuilder(API_key) // Enabling the data sending about the device location. .withLocationTracking(true) .build(); // Initializing the AppMetrica SDK. YandexMetrica.activate(getApplicationContext(), config);
Скопировано
Чтобы включить отправку в процессе работы приложения, используйте метод YandexMetrica.setLocationTracking(boolean enabled):
YandexMetrica.setLocationTracking(true);
Скопировано
AndroidManifest.xml
одно из следующих разрешений:- android.permission.ACCESS_COARSE_LOCATION — для приблизительного определения.
- android.permission.ACCESS_FINE_LOCATION — для точного определения.
Установка местоположения вручную
Перед отправкой собственной информации о местоположении устройства убедитесь, что отправка отчетов была включена.
Библиотека определяет местоположение устройства самостоятельно. Чтобы отправить собственную информацию о местоположении устройства, передайте объект класса android.location.Location в метод YandexMetrica.setLocation(Location location).
// Determining the location. Location currentLocation = ...; // Setting your own location information of the device. YandexMetrica.setLocation(currentLocation);
Скопировано
// Determining the location. Location currentLocation = ...; // Creating an extended library configuration. YandexMetricaConfig config = YandexMetricaConfig.newConfigBuilder(API_key) // Set your own location information of the device. .withLocation(currentLocation) .build(); // Initializing the AppMetrica SDK. YandexMetrica.activate(getApplicationContext(), config);
Скопировано
Чтобы возобновить определение местоположения библиотекой, передайте в метод YandexMetrica.setLocation(Location location) значение null
и настройте отправку местоположения устройства.
YandexMetrica.setLocation(null);
Скопировано
Отправка собственного события
Чтобы отправить собственное событие без вложенных параметров, передайте короткое название или описание события в метод YandexMetrica.reportEvent(String eventName):
YandexMetrica.reportEvent("Updates installed");
Скопировано
Отправка собственного события с вложенными параметрами
AppMetrica SDK позволяет отправлять собственные события с вложенными параметрами, которые могут быть заданы в формате JSON или в виде набора атрибутов (Map).
Чтобы передать вложенные параметры события в формате JSON, используйте метод YandexMetrica.reportEvent(String eventName, String jsonValue):
String eventParameters = "{\"name\":\"Alice\", \"age\":\"18\"}"; YandexMetrica.reportEvent("New person", eventParameters);
Скопировано
Чтобы передать вложенные параметры события в виде набора атрибутов (Map), используйте метод YandexMetrica.reportEvent(String eventName, Map<String, Object> attributes):
Map<String, Object> eventParameters = new HashMap<String, Object>(); eventParameters.put("name", "Alice"); eventParameters.put("age", 18); YandexMetrica.reportEvent("New person", eventParameters);
Скопировано
Веб-интерфейс AppMetrica отображает до пяти уровней вложенности события. Если событие содержит шесть уровней и более, в отчете отобразятся пять верхних. С помощью API отчетов можно выгрузить до десяти уровней.
Подробнее о событиях в разделе События.
Отправка события из JavaScript-кода WebView
AppMetrica SDK позволяет отправлять клиентские события из JavaScript-кода. Инициализируйте отправку вызовом метода initWebViewReporting:
WebView webView = (WebView) findViewById(R.id.myWebView); // do your initialization here webView.getSettings().setJavaScriptEnabled(true); YandexMetrica.initWebViewReporting(webView); webView.loadUrl(myURL);
Скопировано
val webView = findViewById<WebView>(R.id.myWebView) // do your initialization here webView.settings.javaScriptEnabled = true YandexMetrica.initWebViewReporting(webView) webView.loadUrl(myURL)
Скопировано
Вызывайте метод initWebViewReporting
после вызова метода setJavaScriptEnabled
и до вызова loadUrl
.
Для отправки события из JavaScript-кода используйте метод reportEvent(name, value)
интерфейса AppMetrica:
function buttonClicked() { AppMetrica.reportEvent('Button clicked!', '{}'); })
Скопировано
Аргументы метода reportEvent
:
name
— строка. Не может быть null или пустым.value
— JSON-строка. Может быть null.
Отправка собственного сообщения об ошибке
Чтобы отправить собственное сообщение об ошибке, используйте методы:
Методы c groupIdentifier
появились в AppMetrica SDK начиная с версии 3.14.2.
Пример c groupIdentifier
Если ошибки отправляются с помощью методов c groupIdentifier
, они группируются по идентификатору.
try { Integer.valueOf("00xffWr0ng"); } catch (Throwable error) { YandexMetrica.reportError("Your ID", "Error while parsing some integer number", error); }
Скопировано
Не используйте переменные значения в качестве идентификатора для группировки. Иначе количество групп будет увеличиваться и их будет сложно анализировать.
Пример c message
Если ошибки отправляются с помощью метода YandexMetrica.reportError(String message, Throwable error), они группируются по stack trace.
try { Integer.valueOf("00xffWr0ng"); } catch (Throwable error) { YandexMetrica.reportError("Error while parsing some integer number", error); }
Скопировано
Отправка ProfileId
Если идентификатор пользовательского профиля известен до инициализации AppMetrica SDK, передавайте его до инициализации (setUserProfileID) или во время инициализации с расширенной конфигурацией (withUserProfileID).
В противном случае будет создан пользовательский профиль с идентификатором appmetrica_device_id
.
В любой момент можно обновить ProfileId
с помощью вызова setUserProfileID:
YandexMetrica.setUserProfileID("id");
Скопировано
Отправка атрибутов профиля
Чтобы отправить атрибуты профиля, передайте в объект UserProfile необходимые атрибуты и отправьте этот объект с помощью метода YandexMetrica.reportUserProfile(UserProfile profile). Атрибуты профиля создаются с помощью методов класса Attribute.
// Creating the UserProfile instance. UserProfile userProfile = UserProfile.newBuilder() // Updating predefined attributes. .apply(Attribute.name().withValue("John")) .apply(Attribute.gender().withValue(GenderAttribute.Gender.MALE)) .apply(Attribute.birthDate().withAge(24)) .apply(Attribute.notificationsEnabled().withValue(false)) // Updating custom attributes. .apply(Attribute.customString("string_attribute").withValue("string")) .apply(Attribute.customNumber("number_attribute").withValue(55)) .apply(Attribute.customCounter("counter_attribute").withDelta(1)) .build(); // Setting the ProfileID using the method of the YandexMetrica class. YandexMetrica.setUserProfileID("id"); // Sending the UserProfile instance. YandexMetrica.reportUserProfile(userProfile);
Скопировано
Отправка ECommerce-событий
В AppMetrica нет возможности сегментировать ECommerce-события на «тестовые» и «не тестовые». Если для отладки покупок вы используете основной API key, то тестовые события будут попадать в общую статистику. Поэтому, чтобы отладить отправку ECommerce-событий, используйте отправку статистики на дополнительный API key с помощью репортера.
Шаг 1. Настройте отправку ECommerce-событий на тестовый API key
Для различных действий пользователя есть соответствующие типы ECommerce-событий. Чтобы создать конкретный тип события, используйте нужный метод класса ECommerceEvent
.
Ниже приведены примеры отправки конкретных типов событий (Java):
Map<String, String> payload = new HashMap<>();
payload.put("configuration", "landscape");
payload.put("full_screen", "true");
// Creating a screen object.
ECommerceScreen screen = new ECommerceScreen()
.setCategoriesPath(Arrays.asList( // Optional.
"Акции",
"Красная цена"
))
.setName("ProductCardActivity") // Optional.
.setSearchQuery("даниссимо кленовый сироп") // Optional.
.setPayload(payload); // Optional.
ECommerceEvent showScreenEvent = ECommerceEvent.showScreenEvent(screen);
// Sending an e-commerce event.
YandexMetrica.getReporter(getApplicationContext(), "Testing API key").reportECommerce(showScreenEvent);
Map<String, String> payload = new HashMap<>(); payload.put("configuration", "landscape"); payload.put("full_screen", "true"); // Creating a screen object. ECommerceScreen screen = new ECommerceScreen() .setCategoriesPath(Arrays.asList( // Optional. "Акции", "Красная цена" )) .setName("ProductCardActivity") // Optional. .setSearchQuery("даниссимо кленовый сироп") // Optional. .setPayload(payload); // Optional. // Creating an actualPrice object. ECommercePrice actualPrice = new ECommercePrice(new ECommerceAmount(4.53, "USD")) .setInternalComponents(Arrays.asList( // Optional. new ECommerceAmount(30_570_000, "wood"), new ECommerceAmount(26.89, "iron"), new ECommerceAmount(new BigDecimal(5.1), "gold") )); // Creating an originalPrice object. ECommercePrice originalPrice = new ECommercePrice(new ECommerceAmount(5.78, "USD")) .setInternalComponents(Arrays.asList( // Optional. new ECommerceAmount(30_590_000, "wood"), new ECommerceAmount(26.92, "iron"), new ECommerceAmount(new BigDecimal(5.5), "gold") )); // Creating a product object. ECommerceProduct product = new ECommerceProduct("779213") .setActualPrice(actualPrice) // Optional. .setPromocodes(Arrays.asList("BT79IYX", "UT5412EP")) // Optional. .setPayload(payload) // Optional. .setOriginalPrice(originalPrice) // Optional. .setName("Продукт творожный «Даниссимо» 5.9%, 130 г.") // Optional. .setCategoriesPath(Arrays.asList("Продукты", "Молочные продукты", "Йогурты")); // Optional. ECommerceEvent showProductCardEvent = ECommerceEvent.showProductCardEvent(product, screen); // Sending an e-commerce event. YandexMetrica.getReporter(getApplicationContext(), "Testing API key").reportECommerce(showProductCardEvent);
Скопировано
Map<String, String> payload = new HashMap<>(); payload.put("configuration", "landscape"); payload.put("full_screen", "true"); // Creating a screen object. ECommerceScreen screen = new ECommerceScreen() .setCategoriesPath(Arrays.asList( // Optional. "Акции", "Красная цена" )) .setName("ProductCardActivity") // Optional. .setSearchQuery("даниссимо кленовый сироп") // Optional. .setPayload(payload); // Optional. // Creating an actualPrice object. ECommercePrice actualPrice = new ECommercePrice(new ECommerceAmount(4.53, "USD")) .setInternalComponents(Arrays.asList( // Optional. new ECommerceAmount(30_570_000, "wood"), new ECommerceAmount(26.89, "iron"), new ECommerceAmount(new BigDecimal(5.1), "gold") )); // Creating an originalPrice object. ECommercePrice originalPrice = new ECommercePrice(new ECommerceAmount(5.78, "USD")) .setInternalComponents(Arrays.asList( // Optional. new ECommerceAmount(30_590_000, "wood"), new ECommerceAmount(26.92, "iron"), new ECommerceAmount(new BigDecimal(5.5), "gold") )); // Creating a product object. ECommerceProduct product = new ECommerceProduct("779213") .setActualPrice(actualPrice) // Optional. .setPromocodes(Arrays.asList("BT79IYX", "UT5412EP")) // Optional. .setPayload(payload) // Optional. .setOriginalPrice(originalPrice) // Optional. .setName("Продукт творожный «Даниссимо» 5.9%, 130 г.") // Optional. .setCategoriesPath(Arrays.asList("Продукты", "Молочные продукты", "Йогурты")); // Optional. // Creating a referrer object. ECommerceReferrer referrer = new ECommerceReferrer() .setType("button") // Optional. .setIdentifier("76890") // Optional. .setScreen(screen); // Optional. ECommerceEvent showProductDetailsEvent = ECommerceEvent.showProductDetailsEvent(product, referrer); // Referrer is optional — can be null. // Sending an e-commerce event. YandexMetrica.getReporter(getApplicationContext(), "Testing API key").reportECommerce(showProductDetailsEvent);
Скопировано
Map<String, String> payload = new HashMap<>(); payload.put("configuration", "landscape"); payload.put("full_screen", "true"); // Creating a screen object. ECommerceScreen screen = new ECommerceScreen() .setCategoriesPath(Arrays.asList( // Optional. "Акции", "Красная цена" )) .setName("ProductCardActivity") // Optional. .setSearchQuery("даниссимо кленовый сироп") // Optional. .setPayload(payload); // Optional. // Creating an actualPrice object. ECommercePrice actualPrice = new ECommercePrice(new ECommerceAmount(4.53, "USD")) .setInternalComponents(Arrays.asList( // Optional. new ECommerceAmount(30_570_000, "wood"), new ECommerceAmount(26.89, "iron"), new ECommerceAmount(new BigDecimal(5.1), "gold") )); // Creating an originalPrice object. ECommercePrice originalPrice = new ECommercePrice(new ECommerceAmount(5.78, "USD")) .setInternalComponents(Arrays.asList( // Optional. new ECommerceAmount(30_590_000, "wood"), new ECommerceAmount(26.92, "iron"), new ECommerceAmount(new BigDecimal(5.5), "gold") )); // Creating a product object. ECommerceProduct product = new ECommerceProduct("779213") .setActualPrice(actualPrice) // Optional. .setPromocodes(Arrays.asList("BT79IYX", "UT5412EP")) // Optional. .setPayload(payload) // Optional. .setOriginalPrice(originalPrice) // Optional. .setName("Продукт творожный «Даниссимо» 5.9%, 130 г.") // Optional. .setCategoriesPath(Arrays.asList("Продукты", "Молочные продукты", "Йогурты")); // Optional. // Creating a referrer object. ECommerceReferrer referrer = new ECommerceReferrer() .setType("button") // Optional. .setIdentifier("76890") // Optional. .setScreen(screen); // Optional. // Creating a cartItem object. ECommerceCartItem addedItems1 = new ECommerceCartItem(product, actualPrice, 1.0) .setReferrer(referrer); // Optional. ECommerceEvent addCartItemEvent = ECommerceEvent.addCartItemEvent(addedItems1); // Sending an e-commerce event. YandexMetrica.getReporter(getApplicationContext(), "Testing API key").reportECommerce(addCartItemEvent); ECommerceEvent removeCartItemEvent = ECommerceEvent.removeCartItemEvent(addedItems1); // Sending an e-commerce event. YandexMetrica.getReporter(getApplicationContext(), "Testing API key").reportECommerce(removeCartItemEvent);
Скопировано
Map<String, String> payload = new HashMap<>(); payload.put("configuration", "landscape"); payload.put("full_screen", "true"); // Creating a screen object. ECommerceScreen screen = new ECommerceScreen() .setCategoriesPath(Arrays.asList( // Optional. "Акции", "Красная цена" )) .setName("ProductCardActivity") // Optional. .setSearchQuery("даниссимо кленовый сироп") // Optional. .setPayload(payload); // Optional. // Creating an actualPrice object. ECommercePrice actualPrice = new ECommercePrice(new ECommerceAmount(4.53, "USD")) .setInternalComponents(Arrays.asList( // Optional. new ECommerceAmount(30_570_000, "wood"), new ECommerceAmount(26.89, "iron"), new ECommerceAmount(new BigDecimal(5.1), "gold") )); // Creating an originalPrice object. ECommercePrice originalPrice = new ECommercePrice(new ECommerceAmount(5.78, "USD")) .setInternalComponents(Arrays.asList( // Optional. new ECommerceAmount(30_590_000, "wood"), new ECommerceAmount(26.92, "iron"), new ECommerceAmount(new BigDecimal(5.5), "gold") )); // Creating a product object. ECommerceProduct product = new ECommerceProduct("779213") .setActualPrice(actualPrice) // Optional. .setPromocodes(Arrays.asList("BT79IYX", "UT5412EP")) // Optional. .setPayload(payload) // Optional. .setOriginalPrice(originalPrice) // Optional. .setName("Продукт творожный «Даниссимо» 5.9%, 130 г.") // Optional. .setCategoriesPath(Arrays.asList("Продукты", "Молочные продукты", "Йогурты")); // Optional. // Creating a referrer object. ECommerceReferrer referrer = new ECommerceReferrer() .setType("button") // Optional. .setIdentifier("76890") // Optional. .setScreen(screen); // Optional. // Creating a cartItem object. ECommerceCartItem addedItems1 = new ECommerceCartItem(product, actualPrice, 1.0) .setReferrer(referrer); // Optional. // Creating an order object. ECommerceOrder order = new ECommerceOrder("88528768", Arrays.asList(addedItems1)) .setPayload(payload); // Optional. ECommerceEvent beginCheckoutEvent = ECommerceEvent.beginCheckoutEvent(order); // Sending an e-commerce event. YandexMetrica.getReporter(getApplicationContext(), "Testing API key").reportECommerce(beginCheckoutEvent); ECommerceEvent purchaseEvent = ECommerceEvent.purchaseEvent(order); // Sending an e-commerce event. YandexMetrica.getReporter(getApplicationContext(), "Testing API key").reportECommerce(purchaseEvent);
Скопировано
Для различных действий пользователя есть соответствующие типы ECommerce-событий. Чтобы создать конкретный тип события, используйте нужный метод класса ECommerceEvent
.
Ниже приведены примеры отправки конкретных типов событий (Kotlin):
val payload = mapOf("configuration" to "landscape", "full_screen" to "true")
// Creating a screen object.
val screen = ECommerceScreen().apply {
categoriesPath = listOf("Акции", "Красная цена") // Optional.
name = "ProductCardActivity" // Optional.
searchQuery = "даниссимо кленовый сироп" // Optional.
this.payload = payload // Optional.
}
val showScreenEvent = ECommerceEvent.showScreenEvent(screen)
// Sending an e-commerce event.
YandexMetrica.getReporter(applicationContext, "Testing API key").reportECommerce(showScreenEvent)
val payload = mapOf("configuration" to "landscape", "full_screen" to "true") // Creating a screen object. val screen = ECommerceScreen().apply { categoriesPath = listOf("Акции", "Красная цена") // Optional. name = "ProductCardActivity" // Optional. searchQuery = "даниссимо кленовый сироп" // Optional. this.payload = payload // Optional. } // Creating an actualPrice object. val actualPrice = ECommercePrice(ECommerceAmount(4.53, "USD")) .apply { internalComponents = listOf( // Optional. ECommerceAmount(30570000, "wood"), ECommerceAmount(26.89, "iron"), ECommerceAmount(BigDecimal(5.1), "gold") ) } // Creating an originalPrice object. val originalPrice = ECommercePrice(ECommerceAmount(5.78, "USD")) .apply { internalComponents = listOf( // Optional. ECommerceAmount(30590000, "wood"), ECommerceAmount(26.92, "iron"), ECommerceAmount(BigDecimal(5.5), "gold") ) } // Creating a product object. val product = ECommerceProduct("779213") .apply { this.actualPrice = actualPrice // Optional. this.originalPrice = originalPrice // Optional. promocodes = listOf("BT79IYX", "UT5412EP") // Optional. name = "Продукт творожный «Даниссимо» 5.9%, 130 г." // Optional. categoriesPath = listOf("Продукты", "Молочные продукты", "Йогурты") // Optional. this.payload = payload // Optional. } val showProductCardEvent = ECommerceEvent.showProductCardEvent(product, screen) // Sending an e-commerce event. YandexMetrica.getReporter(applicationContext, "Testing API key").reportECommerce(showProductCardEvent)
Скопировано
val payload = mapOf("configuration" to "landscape", "full_screen" to "true") // Creating a screen object. val screen = ECommerceScreen().apply { categoriesPath = listOf("Акции", "Красная цена") // Optional. name = "ProductCardActivity" // Optional. searchQuery = "даниссимо кленовый сироп" // Optional. this.payload = payload // Optional. } // Creating an actualPrice object. val actualPrice = ECommercePrice(ECommerceAmount(4.53, "USD")) .apply { internalComponents = listOf( // Optional. ECommerceAmount(30570000, "wood"), ECommerceAmount(26.89, "iron"), ECommerceAmount(BigDecimal(5.1), "gold") ) } // Creating an originalPrice object. val originalPrice = ECommercePrice(ECommerceAmount(5.78, "USD")) .apply { internalComponents = listOf( // Optional. ECommerceAmount(30590000, "wood"), ECommerceAmount(26.92, "iron"), ECommerceAmount(BigDecimal(5.5), "gold") ) } // Creating a product object. val product = ECommerceProduct("779213") .apply { this.actualPrice = actualPrice // Optional. this.originalPrice = originalPrice // Optional. promocodes = listOf("BT79IYX", "UT5412EP") // Optional. name = "Продукт творожный «Даниссимо» 5.9%, 130 г." // Optional. categoriesPath = listOf("Продукты", "Молочные продукты", "Йогурты") // Optional. this.payload = payload // Optional. } // Creating a referrer object. val referrer = ECommerceReferrer() .apply { type = "button" // Optional. identifier = "76890" // Optional. this.screen = screen // Optional. } val showProductDetailsEvent = ECommerceEvent.showProductDetailsEvent(product, referrer) // Referrer is optional - can be null. // Sending an e-commerce event. YandexMetrica.getReporter(applicationContext, "Testing API key").reportECommerce(showProductDetailsEvent)
Скопировано
val payload = mapOf("configuration" to "landscape", "full_screen" to "true") // Creating a screen object. val screen = ECommerceScreen().apply { categoriesPath = listOf("Акции", "Красная цена") // Optional. name = "ProductCardActivity" // Optional. searchQuery = "даниссимо кленовый сироп" // Optional. this.payload = payload // Optional. } // Creating an actualPrice object. val actualPrice = ECommercePrice(ECommerceAmount(4.53, "USD")) .apply { internalComponents = listOf( // Optional. ECommerceAmount(30570000, "wood"), ECommerceAmount(26.89, "iron"), ECommerceAmount(BigDecimal(5.1), "gold") ) } // Creating an originalPrice object. val originalPrice = ECommercePrice(ECommerceAmount(5.78, "USD")) .apply { internalComponents = listOf( // Optional. ECommerceAmount(30590000, "wood"), ECommerceAmount(26.92, "iron"), ECommerceAmount(BigDecimal(5.5), "gold") ) } // Creating a product object. val product = ECommerceProduct("779213") .apply { this.actualPrice = actualPrice // Optional. this.originalPrice = originalPrice // Optional. promocodes = listOf("BT79IYX", "UT5412EP") // Optional. name = "Продукт творожный «Даниссимо» 5.9%, 130 г." // Optional. categoriesPath = listOf("Продукты", "Молочные продукты", "Йогурты") // Optional. this.payload = payload // Optional. } // Creating a referrer object. val referrer = ECommerceReferrer() .apply { type = "button" // Optional. identifier = "76890" // Optional. this.screen = screen // Optional. } // Creating a cartItem object. val addedItems1 = ECommerceCartItem(product, actualPrice, 1.0) .apply { this.referrer = referrer // Optional. } val addCartItemEvent = ECommerceEvent.addCartItemEvent(addedItems1) // Sending an e-commerce event. YandexMetrica.getReporter(applicationContext, "Testing API key").reportECommerce(addCartItemEvent) val removeCartItemEvent = ECommerceEvent.removeCartItemEvent(addedItems1) // Sending an e-commerce event. YandexMetrica.getReporter(applicationContext, "Testing API key").reportECommerce(removeCartItemEvent)
Скопировано
val payload = mapOf("configuration" to "landscape", "full_screen" to "true") // Creating a screen object. val screen = ECommerceScreen().apply { categoriesPath = listOf("Акции", "Красная цена") // Optional. name = "ProductCardActivity" // Optional. searchQuery = "даниссимо кленовый сироп" // Optional. this.payload = payload // Optional. } // Creating an actualPrice object. val actualPrice = ECommercePrice(ECommerceAmount(4.53, "USD")) .apply { internalComponents = listOf( // Optional. ECommerceAmount(30570000, "wood"), ECommerceAmount(26.89, "iron"), ECommerceAmount(BigDecimal(5.1), "gold") ) } // Creating an originalPrice object. val originalPrice = ECommercePrice(ECommerceAmount(5.78, "USD")) .apply { internalComponents = listOf( // Optional. ECommerceAmount(30590000, "wood"), ECommerceAmount(26.92, "iron"), ECommerceAmount(BigDecimal(5.5), "gold") ) } // Creating a product object. val product = ECommerceProduct("779213") .apply { this.actualPrice = actualPrice // Optional. this.originalPrice = originalPrice // Optional. promocodes = listOf("BT79IYX", "UT5412EP") // Optional. name = "Продукт творожный «Даниссимо» 5.9%, 130 г." // Optional. categoriesPath = listOf("Продукты", "Молочные продукты", "Йогурты") // Optional. this.payload = payload // Optional. } // Creating a referrer object. val referrer = ECommerceReferrer() .apply { type = "button" // Optional. identifier = "76890" // Optional. this.screen = screen // Optional. } // Creating a cartItem object. val addedItems1 = ECommerceCartItem(product, actualPrice, 1.0) .apply { this.referrer = referrer // Optional. } // Creating an order object. val order = ECommerceOrder("88528768", listOf(addedItems1)) .apply { this.payload = payload // Optional. } val beginCheckoutEvent = ECommerceEvent.beginCheckoutEvent(order) // Sending an e-commerce event. YandexMetrica.getReporter(applicationContext, "Testing API key").reportECommerce(beginCheckoutEvent) val purchaseEvent = ECommerceEvent.purchaseEvent(order) // Sending an e-commerce event. YandexMetrica.getReporter(applicationContext, "Testing API key").reportECommerce(purchaseEvent)
Скопировано
Шаг 2. Проверьте отчет тестового приложения
Совершите тестовые покупки в приложении. Через некоторое время в интерфейсе AppMetrica проверьте отчет «Анализ покупок». Убедитесь, что ECommerce-события отображаются в отчете.
Подробнее об отчете в разделе Анализ покупок.
Шаг 3. Настройте отправку на основной API key
После успешного тестирования настройте отправку ECommerce-событий на основной API key.
Чтобы отправить объект ECommerceEvent на основной API key, используйте метод YandexMetrica.reportECommerce(@NonNull ECommerceEvent event).
... // Sending an e-commerce event. YandexMetrica.reportECommerce(ecommerceEvent);
Скопировано
... // Sending an e-commerce event. YandexMetrica.reportECommerce(ecommerceEvent)
Скопировано
Отправка Revenue
AppMetrica поддерживает валидацию покупок, которые реализованы с помощью библиотеки Google Play Billing. Валидация позволяет фильтровать покупки, которые совершаются из взломанных приложений. Если валидация включена и покупка не проходит валидацию, она не отображается в отчетах.
Шаг 1. Настройте отправку Revenue на тестовый API key
В AppMetrica нет возможности сегментировать Revenue на «тестовые» и «не тестовые». Если для отладки покупок вы используете основной API key, то тестовые покупки будут попадать в общую статистику. Поэтому, чтобы отладить отправку Revenue, используйте отправку статистики на дополнительный API key с помощью репортера.
Ниже описаны этапы отправки Revenue на дополнительный API key:
Чтобы покупки на Android валидировались, настройте отправку объекта Revenue.Receipt вместе с Revenue:
- Создайте объект
Revenue.Receipt
с информацией о покупке и подписью. Его необходимо использовать при создании объектаRevenue
в методе Revenue.Builder.withReceipt(Revenue.Receipt receipt). - Создайте объект
Revenue
с помощью конструктора Revenue.Builder. - Отправьте объект
Revenue
на тестовый API key с помощью репортера IReporter. Подробнее о работе репортеров в разделе Примеры использования.
void handlePurchase(Purchase purchase) { ... // Creating the Revenue.Receipt instance. // It is used for checking purchases in Google Play. Revenue.Receipt revenueReceipt = Revenue.Receipt.newBuilder() .withData(purchase.getOriginalJson()) .withSignature(purchase.getSignature()) .build(); // Creating the Revenue instance. Revenue revenue = Revenue.newBuilderWithMicros(99000000, Currency.getInstance("RUB")) .withProductID("com.yandex.service.299") .withQuantity(2) .withReceipt(revenueReceipt) .withPayload("{\"source\":\"Google Play\"}") .build(); // Sending the Revenue instance using reporter. YandexMetrica.getReporter(getApplicationContext(), "Testing API key").reportRevenue(revenue); }
Скопировано
Чтобы отправить информацию о покупке без валидации:
- Создайте объект Revenue с помощью конструктора Revenue.Builder.
- (Опционально) Чтобы группировать покупки по OrderID, укажите его в методе Revenue.Builder.withPayload(String payload).Примечание. Если идентификатор OrderID не указан, AppMetrica генерирует идентификатор автоматически.
- Отправьте объект
Revenue
на тестовый API key с помощью репортера IReporter. Подробнее о работе репортеров в разделе Примеры использования.
// Creating the Revenue instance. Revenue revenue = Revenue.newBuilderWithMicros(99000000, Currency.getInstance("RUB")) .withProductID("com.yandex.service.299") .withQuantity(2) // Passing the OrderID parameter in the .withPayload(String payload) method to group purchases. .withPayload("{\"OrderID\":\"Identifier\", \"source\":\"Google Play\"}") .build(); // Sending the Revenue instance using reporter. YandexMetrica.getReporter(getApplicationContext(), "Testing API key").reportRevenue(revenue);
Скопировано
Шаг 2. Проверьте отчет тестового приложения
В интерфейсе AppMetrica проверьте отчет «Revenue». Убедитесь, что количество покупок увеличилось.
Подробнее об отчете в разделе Revenue.
Шаг 3. Настройте отправку Revenue на основной API key
После успешного тестирования настройте отправку Revenue на основной API key.
Чтобы отправить объект Revenue
на основной API key, используйте метод YandexMetrica.reportRevenue(Revenue revenue).
... // Sending the Revenue instance. YandexMetrica.reportRevenue(revenue);
Скопировано
Установка длительности тайм-аута сессии
По умолчанию длительность тайм-аута сессии равна 10 секундам. Это минимально допустимое значение параметра sessionTimeout
.
Чтобы изменить длительность тайм-аута, передайте значение в секундах в метод withSessionTimeout(int sessionTimeout) при создании расширенной конфигурации библиотеки.
// Creating an extended library configuration. YandexMetricaConfig config = YandexMetricaConfig.newConfigBuilder(API_key) // Setting the length of the session timeout. .withSessionTimeout(15) .build(); // Initializing the AppMetrica SDK. YandexMetrica.activate(getApplicationContext(), config);
Скопировано
Установка версии приложения
По умолчанию версия приложения задается в файле build.gradle.
Чтобы указать версию приложения из кода, передайте версию приложения в метод withAppVersion(String appVersion) при создании расширенной конфигурации библиотеки.
// Creating an extended library configuration. YandexMetricaConfig config = YandexMetricaConfig.newConfigBuilder(API_key) // Setting the app version. .withAppVersion("1.13.2") .build(); // Initializing the AppMetrica SDK. YandexMetrica.activate(getApplicationContext(), config);
Скопировано
где 1.13.2 — версия приложения.
Определение уровня API библиотеки
int libraryApiLevel = YandexMetrica.getLibraryApiLevel();
Скопировано
Определение версии библиотеки
Чтобы определить версию библиотеки из кода приложения, используйте метод YandexMetrica.getLibraryVersion():
String libraryVersion = YandexMetrica.getLibraryVersion();
Скопировано
Отслеживание источников установки
Отслеживание источников установок в AppMetrica SDK работает по умолчанию.
<manifest ... xmlns:tools="http://schemas.android.com/tools"> ... <application ...> ... <receiver android:name="com.yandex.metrica.MetricaEventHandler" tools:node="remove"/> ... </application> </manifest>
Скопировано
Отслеживание открытий приложения с помощью deeplink
Чтобы отслеживать открытия приложения с помощью deeplink, необходимо добавить изменения в Activity, которая обрабатывает deeplink. Отслеживание открытий необходимо для корректного трекинга ремаркетинг-кампаний.
Отслеживание открытий осуществляется с помощью метода reportAppOpen():
public class DeeplinkActivity extends Activity { @Override protected void onCreate(@Nullable final Bundle savedInstanceState) { super.onCreate(savedInstanceState); if (savedInstanceState == null) { YandexMetrica.reportAppOpen(this); } } @Override protected void onNewIntent(final Intent intent) { super.onNewIntent(intent); YandexMetrica.reportAppOpen(intent); } }
Скопировано
Запрос отложенного deeplink
Чтобы запросить отложенный deeplink, передайте в метод YandexMetrica.requestDeferredDeeplink(DeferredDeeplinkListener listener) объект класса, реализующий интерфейс DeferredDeeplinkListener. Метод возвращает отложенный deeplink только при первом запуске приложения после получения Google Play Install Referrer.
YandexMetrica.requestDeferredDeeplink(new DeferredDeeplinkListener() { @Override public void onDeeplinkLoaded(String deeplink) { Log.i("Deeplink", "deeplink = " + deeplink); } @Override public void onError(Error error, String referrer) { Log.i("Deeplink", "Error: " + error.getDescription() + ", unparsed referrer: " + referrer); } });
Скопировано
YandexMetrica.requestDeferredDeeplink(object : DeferredDeeplinkListener { override fun onDeeplinkLoaded(deeplink: String) { Log.i("Deeplink", "deeplink = $deeplink") } override fun onError(error: DeferredDeeplinkListener.Error, referrer: String?) { Log.i("Deeplink", "Error: ${error.description}, unparsed referrer: $referrer") } })
Скопировано
Подробнее об отложенных deeplinks в разделе Поддержка отложенных deeplinks.
Запрос параметров отложенного deeplink
Чтобы запросить параметры отложенного deeplink, передайте в метод YandexMetrica.requestDeferredDeeplinkParameters(DeferredDeeplinkParametersListener listener) объект класса, реализующий интерфейс DeferredDeeplinkParametersListener. Метод возвращает параметры отложенного deeplink только при первом запуске приложения после получения Google Play Install Referrer.
YandexMetrica.requestDeferredDeeplinkParameters(new DeferredDeeplinkParametersListener() { @Override public void onParametersLoaded(Map<String, String> parameters) { // Processing deeplink parameters. for (String key : parameters.keySet()) { Log.i("Deeplink params", "key: " + key + " value: " + parameters.get(key)); } } @Override public void onError(Error error, String referrer) { // Handling the error. Log.e("Error!", error.getDescription()); } });
Скопировано
Подробнее об отложенных deeplinks в разделе Поддержка отложенных deeplinks.
Учет новых пользователей
По умолчанию в момент первого запуска приложения все пользователи определяются как новые. Если AppMetrica SDK подключается к приложению, у которого уже есть активные пользователи, то для корректного отслеживания статистики можно настроить учет новых и старых пользователей. Для этого необходимо инициализировать AppMetrica SDK, используя расширенную стартовую конфигурацию YandexMetricaConfig
:
boolean isFirstLaunch; // Implement logic to detect whether the app is opening for the first time. // For example, you can check for files (settings, databases, and so on), // which the app creates on its first launch. if (conditions) { isFirstLaunch = true; } // Creating an extended library configuration. YandexMetricaConfig config = YandexMetricaConfig.newConfigBuilder(API_key) .handleFirstActivationAsUpdate(!isFirstLaunch) .build(); // Initializing the AppMetrica SDK. YandexMetrica.activate(getApplicationContext(), config);
Скопировано
Отключение и включение отправки статистики
Если для отправки статистических данных требуется согласие пользователя, необходимо инициализировать библиотеку с отключенной опцией отправки статистики. Для этого передайте значение false
в метод withStatisticsSending(boolean value) при создании расширенной конфигурации библиотеки.
// Creating an extended library configuration. YandexMetricaConfig config = YandexMetricaConfig.newConfigBuilder(API_key) // Disabling sending statistics. .withStatisticsSending(false) .build(); // Initializing the AppMetrica SDK. YandexMetrica.activate(getApplicationContext(), config);
Скопировано
// Checking the status of the boolean variable. It shows the user confirmation. if (flag) { // Enabling sending statistics. YandexMetrica.setStatisticsSending(getApplicationContext(), true); }
Скопировано
Пример оповещения
Для информирования пользователей вы можете использовать любой текст. Например:
Это приложение использует сервис аналитики AppMetrica (Яндекс.Метрика для приложений), предоставляемый компанией ООО «ЯНДЕКС», 119021, Россия, Москва, ул. Л. Толстого, 16 (далее — Яндекс) на Условиях использования сервиса.
AppMetrica анализирует данные об использовании приложения, в том числе об устройстве, на котором оно функционирует, источнике установки, составляет конверсию и статистику вашей активности в целях продуктовой аналитики, анализа и оптимизации рекламных кампаний, а также для устранения ошибок. Собранная таким образом информация не может идентифицировать вас.
Информация об использовании вами данного приложения, собранная при помощи инструментов AppMetrica, в обезличенном виде будет передаваться Яндексу и храниться на сервере Яндекса в ЕС и Российской Федерации. Яндекс будет обрабатывать эту информацию для предоставления статистики использования вами приложения, составления для нас отчетов о работе приложения, и предоставления других услуг.