Аналитика Центра приложений (React Native)

Это важно

Центр приложений Visual Studio был прекращен 31 марта 2025 г., за исключением функций аналитики и диагностики, которые будут поддерживаться до 30 июня 2026 г. Подробнее.

• Андроид
• iOS
• React Native
• Виндоус
• MAUI/Xamarin
• Единство
• macOS
• tvOS

Аналитика Центра приложений помогает понять поведение пользователей и взаимодействие с клиентами для улучшения приложения. Пакет SDK автоматически записывает количество сеансов и свойства устройства, такие как модель, версия ОС и т. д. Вы можете определить собственные пользовательские события для измерения важных для вас элементов. Все данные, полученные на портале Центра приложений, доступны для анализа данных.

Если вы еще не настроили пакет SDK в приложении, следуйте разделу "Начало работы ".

Сведения о сеансе и устройстве

После добавления Аналитики Центра приложений в приложение и запуска пакета SDK он автоматически отслеживает сеансы и свойства устройства, такие как версия ОС, модель и т. д.

Пользовательские события

Отслеживайте созданные вами события с до 20 свойствами, чтобы понять взаимодействие ваших пользователей с приложением.

После запуска пакета SDK используйте trackEvent метод для отслеживания событий с помощью свойств. Вы можете отправлять до 200 различных имен событий. Кроме того, существует максимальное ограничение в 256 символов на имя события и 125 символов на имя свойства события и значение свойства события.

// import App Center Analytics at the top of the file.
import Analytics from 'appcenter-analytics';

Analytics.trackEvent('Video clicked', { Category: 'Music', FileName: 'favorite.avi' });

Эта функция возвращает обещание, случай успешного выполнения возвращает пустую строку, а случай ошибки возвращает ошибку.

Свойства событий являются необязательными; Если вы просто хотите отслеживать событие, используйте следующее:

Analytics.trackEvent('Video clicked');

Включение или отключение аналитики Центра приложений во время выполнения

Вы можете включить и отключить Аналитику Центра приложений во время выполнения. Если отключить его, пакет SDK больше не собирает аналитические сведения для приложения.

await Analytics.setEnabled(false);

Эта функция возвращает обещание, разрешающее пустоту.

Чтобы снова включить аналитику Центра приложений, используйте тот же API, но передайте true его в качестве параметра.

await Analytics.setEnabled(true);

Состояние сохраняется в хранилище устройства во время запуска приложения.

Проверьте, включена ли аналитика Центра приложений

Вы также можете проверить, включена ли аналитика Центра приложений.

const enabled = await Analytics.isEnabled();

Эта функция возвращает обещание, которое разрешается в объект boolean.

Дождитесь, пока JavaScript включит аналитику App Center

Если вы хотите собирать аналитические данные для пользователей приложения, но сначала хотите получить разрешение пользователя, у вас есть возможность не включать аналитику при запуске, а подождать до подходящего момента и включить её в JavaScript.

1. Откройте файл проекта ios/YourAppName/AppDelegate.m и замените [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:true]; на [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:false];.
2. Откройте файл проекта android/app/src/main/res/values/strings.xml и замените <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ALWAYS_SEND</string> на <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ENABLE_IN_JS</string>.

Это означает, что для отправки любой информации в Центр приложений (даже основные сведения о сеансе), необходимо сначала включить Аналитику Центра приложений, добавив следующую строку кода:

await Analytics.setEnabled(true);

Управление начальным сеансом

По умолчанию идентификатор сеанса зависит от жизненного цикла приложения. Если вы хотите управлять началом нового сеанса вручную, выполните следующие действия:

Замечание

Обратите внимание, что каждый вызов API Analytics.StartSession() создаст новый сеанс. Если в режиме ручного отслеживания сеансов этот API не будет вызываться, то все журналы отправки будут иметь значение сеанса null.

Замечание

Обратите внимание, что после запуска нового приложения идентификатор сеанса будет повторно создан.

Чтобы настроить пакет SDK для сеанса отслеживания вручную, необходимо использовать собственные API Аналитики enableManualSessionTracker :

• В iOS вызовите [MSACAnalytics enableManualSessionTracker]; перед [AppCenterReactNative register]; в методе делегата didFinishLaunchingWithOptions приложения AppDelegate.m. Добавьте @import AppCenterAnalytics , если отсутствует в этом файле.

• В Android вызовите Analytics.enableManualSessionTracker(); раньше, чем SoLoader.init в onCreate методе MainApplication.java. Добавьте импорт com.microsoft.appcenter.analytics.Analytics , если отсутствует в этом файле.

Затем вы можете использовать startSession API в проекте React Native:

Analytics.startSession();

Размер локального хранилища

По умолчанию пакет SDK хранит до 10 МБ журналов в хранилище.

Нет доступа к Интернету

Если сетевое подключение отсутствует, пакет SDK сохраняет до 10 МБ журналов в локальном хранилище. После полного завершения хранилища пакет SDK начнет удалять старые журналы, чтобы освободить место для новых журналов. Когда устройство восстанавливает доступ к Интернету, SDK будет отправлять журналы пакетом по 50 или каждые 6 секунд.

Журналы событий пакетной обработки

SDK Центра приложений отправляет журналы партиями по 50, и если в наличии нет 50 журналов для отправки, он все равно отправит журналы через 6 секунд. В параллельном режиме может быть отправлено не более трех пакетов.

Логика повторной попытки и постепенного отступления

Пакет SDK для Центра приложений поддерживает повторные попытки восстановления при возникновении ошибок сети, доступных для восстановления. Ниже приведена логика повторных попыток:

• Максимум 3 попытки на запрос.
• Каждый запрос имеет собственный компьютер состояния повтора.
• Все каналы передачи отключены (до следующего процесса приложения) после того, как один запрос исчерпывает все его повторные попытки.

Логика резервного копирования

• 50% рандомизация, первая попытка перезапуска от 5 до 10 секунд, вторая попытка перезапуска от 2,5 до 5 минут, последняя попытка от 10 до 20 минут.
• Если сетевые переключатели переключаются с выключенного состояния на включенное (или с wi-fi на мобильные устройства), состояния повторных попыток сбрасываются, и запросы повторяются немедленно.