Разметка приложений

Краткое содержание

Требования к передаче параметров событий
Для передачи дополнительных параметров событий в МТС Аналитику необходимо использовать только поля из указанного списка. Обязательное поле eventName должно быть заполнено, иначе параметры не будут обработаны.

iOS

• Используйте MTAppEvent для стандартных событий, например, для отслеживания открытия экрана укажите eventName как scrn.
• MTError применяется для передачи параметров крэшей.
• MTECommerceGA4 или MTECommerceUA — для событий электронной коммерции.

Android

• AppEvent — шаблон события с обязательным полем eventName. Для отслеживания открытия экрана используйте scrn.
• ErrorEvent — для нефатальных ошибок, с ограничением длины stacktrace.
• EcommerceGA4Name или EcommerceGA4 — для событий электронной коммерции.

Flutter

• mtsEvent — для стандартных событий, например, для отслеживания открытия экрана укажите eventName как scrn.
• ErrorEvent — для нефатальных ошибок.
• ECommerceGA4Event или ECommerceUAEvent — для событий электронной коммерции.

Дополнительно
В статье указаны ссылки на инструкции по настройке SDK и контактная почта для вопросов.

Основная часть параметров событий передаётся автоматически после установки SDK. В статье описаны способы передачи дополнительных параметров событий в МТС Аналитику — для этого требуется разметка.

Требования описаны в контексте установки и настройки SDK:

• iOS
• Android
• Flutter

Требования

Важно

• Для выбранных событий заполните только поля из этого списка. Если передавать другие поля, значения не будут обрабатываться МТС Аналитикой

• Поле eventName — обязательное. Если его не заполнить, параметры событий передаваться не будут

iOS

1. MTAppEvent — для передачи событий. Например,

        let event = MTAppEvent(...)

Заметка

Чтобы отслеживать событие открытия экрана, передайте в поле eventName значение scrn.

2. MTError — для передачи параметров крэшей. Например,

let error = MTError(errorName: "error", stacktrace: "stacktrace", parameters: ["test": "123"])

3. MTECommerceGA4 или MTECommerceUA — для отправки событий электронной коммерции. Подробнее.

Android

1. AppEvent — для событий разметки. Это шаблон события с обязательным полем eventName и набором опциональных nullable полей для хранения пар ключ-значение

val event = ru.mts.analytics.sdk2.publicapi.event.Event.AppEvent(...)

Заметка

Чтобы отслеживать событие открытия экрана, передайте в поле eventName значение scrn

Event.AppEvent(
    eventName = "scrn",
)

2. ErrorEvent — для передачи параметров нефатальных ошибок. Длина stacktrace с учётом errMsg и символов переноса обрезается до 5000 символов.

3. EcommerceGA4Name или EcommerceGA4 — для отправки событий электронной коммерции. Подробнее.

Flutter

1. mtsEvent — для передачи стандартных событий. Например,

  MtsEvent mtsEvent = MtsEvent(
    eventCategory: "eventCategoryTest",
    eventLabel: "eventLabelTest",
    eventContent: "eventContentTest",
    eventContext: "eventContextTest",
    eventValue: 124,
    actionGroup: const action_group.NonInteractions(),
    touchPoint: const touch_point.App(),
    buttonLocation: const button_location.TopBar(),
    target: const tg.Banner(),
    action: const act.Play(),
    clientId: "ebtQL47cHrk",
    mClientId: "93270144851671100000",
    sessionId: "93270144851671100000_1680427772409",
    hitId: "93270144851671100000_1680439999409",
    timestamp: DateTime.now().millisecondsSinceEpoch.toString(),
    userId: "userTestId",
    grClientId: "1a2b3c4grClient",
    grId: "fCj6fvgxypE_20080610152447302",
    aId: "br7ac10b-55cc-4372-a534-0e02b2c3d479",
    dId: "d24b5a970278d1d8",
    userAuth: const auth_type.Auth(),
    projectName: "2memory",
    filterName: "time|single|high|low",
    productName: "2memoryAndroid",
    productId: "productId",
    funnelName: "fnl_sales",
    funnelStep: "fnl_sales_st1",
    formId: "form1",
    formOrderId: "formOrderId",
    mAccountType: const m_account_type.Parent(),
    accountType: const account_type.Fix(),
    bannerName: "DCM_nabber_cashback",
    bannerId: "4534534",
    region: "Ufa",
    abName: "a/b test",
    abVariant: "a/b test variant",
    currentTariff: const current_tariff.Trial(),
    paymentType: const payment_type.InstallmentPaymentOnline(),
    deliveryType: const delivery_type.Pickup(),
    eventPosition: "23",
    eventProductPromoLabel: const eppl.NotSet(),
    eventProductAvailable: const ep_availability.PreOffer(),
    eventProductDeliveryTerms: const epdt.Pickup(),
    appTheme: const app_theme.Dark(),
    eco: const m_eco.Payments(),
    prtp: "employee",
    prCat: const pr_cat.BankCard(),
    appsflyerId: "1661431768043-2213402944332562490",
    screenName: "MainActivity",
    eventName: e_name.Custom(value: "test"),
    customDimensions: <String, String>{
      "customParameter": "1",
      "customParameter2": "2"
    }
  );
  MtsAnalyticsPlugin().trackEvent(mtsEvent);

Заметка

Чтобы отслеживать событие открытия экрана, передайте в поле eventName значение scrn.

2. ErrorEvent — для передачи параметров нефатальных ошибок. Например,

final ErrorEvent event = ErrorEvent(
      eventName: 'bottomNavigationClick',
      errMsg: "Error message",
      screenName: 'MainScreen',
    );
    mtsAnalyticsPlugin.trackEvent(event);

3. ECommerceGA4Event или ECommerceUAEvent — для отправки событий электронной коммерции. Подробнее.

Сконфигурируйте SDK и настройте отправку событий в МТС Аналитику по инструкциям.

По возникающим вопросам обращайтесь на почту analytics.support@mts.ru