kazachilo 2bf8cb05b2 добавлена разметка событий аналитики

2025-04-11 17:45:01 +03:00

11 KiB

Raw Blame History

Документация по аналитическим событиям

В этом документе представлен полный список событий для отслеживания в приложении с использованием сервиса customAnalyticsService.ts. События сгруппированы по экранам и функциональным блокам.

1. Общие события приложения

Событие	Категория	Название события	Значение	Единица измерения
Открытие мини-приложения	`app`	`app_open`	-	-

2. Навигация

Событие	Категория	Название события	Значение	Единица измерения
Открытие экрана Главная	`navigation`	`view_home`	-	-
Открытие экрана Галерея	`navigation`	`view_gallery`	-	-
Открытие экрана Стикерпаки	`navigation`	`view_sticker_packs`	-	-
Открытие экрана Профиль	`navigation`	`view_profile`	-	-
Открытие экрана Обрезка фото	`navigation`	`view_crop_photo`	-	-
Открытие экрана Создание стикерпака	`navigation`	`view_create_sticker_pack`	-	-
Открытие экрана Добавление стикера в пак	`navigation`	`view_add_sticker_to_pack`	-	-
Открытие экрана Политика конфиденциальности	`navigation`	`view_terms_and_conditions`	-	-
Открытие экрана Инструкция	`navigation`	`view_how_to`	-	-

3. Политика конфиденциальности

Событие	Категория	Название события	Значение	Единица измерения
Нажатие на ссылку политики	`terms`	`policy_link_click`	-	`link_url`
Принятие политики	`terms`	`accept`	-	-
Отклонение политики	`terms`	`decline`	-	-

4. Главный экран (Home)

4.1 Верхний блок кнопок

Событие	Категория	Название события	Значение	Единица измерения
Нажатие на кнопку обратной связи	`ui_interaction`	`feedback_button_click`	-	-
Нажатие на кнопку инструкции	`ui_interaction`	`instruction_button_click`	-	-
Нажатие на кнопку другого бота	`ui_interaction`	`other_bot_button_click`	-	`bot_url`

4.2 Хедер

Событие	Категория	Название события	Значение	Единица измерения
Нажатие на кнопку баланса	`ui_interaction`	`balance_button_click`	-	-

4.3 Загрузка и обработка фото

Событие	Категория	Название события	Значение	Единица измерения
Нажатие на загрузить фото	`photo`	`upload_photo_click`	-	-
Применение обрезки фото	`photo`	`crop_photo_apply`	-	-

4.4 Выбор стиля и параметров

Событие	Категория	Название события	Значение	Единица измерения
Нажатие кнопки Чиби стиль	`style`	`chibi_style_click`	-	-
Нажатие кнопки Эмодзи стиль	`style`	`emoji_style_click`	-	-
Выбор подкатегории Мем	`style`	`meme_subcategory_select`	-	`meme_id`
Выбор подкатегории Коллекция	`style`	`collection_subcategory_select`	-	`collection_id`

4.5 Генерация стикера

Событие	Категория	Название события	Значение	Единица измерения
Удачная отправка на генерацию	`generation`	`generation_success`	1	`preset_name`
Неудачная отправка на генерацию	`generation`	`generation_failure`	-	`error_type`

4.6 Футер

Событие	Категория	Название события	Значение	Единица измерения
Нажатие на кнопку Главная	`footer`	`home_button_click`	-	-
Нажатие на кнопку Галерея	`footer`	`gallery_button_click`	-	-
Нажатие на кнопку Стикерпаки	`footer`	`sticker_packs_button_click`	-	-
Нажатие на кнопку Профиль	`footer`	`profile_button_click`	-	-

5. Экран Галерея

Событие	Категория	Название события	Значение	Единица измерения
Долгое удерживание на изображении	`gallery`	`image_long_press`	-	`image_id`
Удаление изображения	`gallery`	`image_delete`	-	`image_id`
Нажатие кнопки "Создать стикерпак"	`gallery`	`create_sticker_pack_click`	-	`from_gallery`

6. Экран Стикерпаки

Событие	Категория	Название события	Значение	Единица измерения
Нажатие кнопки "Создать стикерпак"	`sticker_packs`	`create_sticker_pack_click`	-	`from_sticker_packs`
Создание стикерпака	`sticker_packs`	`sticker_pack_created`	-	`pack_url`
Ошибка создания стикерпака	`sticker_packs`	`sticker_pack_creation_error`	-	`error_type`
Удаление стикерпака	`sticker_packs`	`sticker_pack_deleted`	-	`pack_id`

7. Экран Профиль и попап с офферами

Событие	Категория	Название события	Значение	Единица измерения
Нажатие на оффер на экране профиля	`offers`	`profile_offer_click`	-	`offer_id`
Нажатие на оффер в попапе	`offers`	`popup_offer_click`	-	`offer_id`
Успешная покупка	`payment`	`purchase_success`	`stars_amount`	`star`

8. Экраны онбординга

8.1 Экран приветствия (OnboardingWelcome)

Событие	Категория	Название события	Значение	Единица измерения
Открытие экрана приветствия	`navigation`	`view_onboarding_welcome`	-	-
Нажатие кнопки "Далее"	`onboarding`	`welcome_next_click`	-	-
Нажатие кнопки "Пропустить"	`onboarding`	`welcome_skip_click`	-	-

8.2 Экран инструкции (OnboardingHowTo)

Событие	Категория	Название события	Значение	Единица измерения
Открытие экрана инструкции	`navigation`	`view_onboarding_how_to`	-	-
Нажатие кнопки "Далее"	`onboarding`	`how_to_next_click`	-	-
Нажатие кнопки "Назад"	`onboarding`	`how_to_back_click`	-	-
Нажатие кнопки "Пропустить"	`onboarding`	`how_to_skip_click`	-	-
Переключение слайда инструкции	`onboarding`	`how_to_slide_change`	-	`slide_index`

8.3 Экран стикерпаков (OnboardingStickerPacks)

Событие	Категория	Название события	Значение	Единица измерения
Открытие экрана стикерпаков	`navigation`	`view_onboarding_sticker_packs`	-	-
Нажатие кнопки "Начать"	`onboarding`	`sticker_packs_start_click`	-	-
Нажатие кнопки "Назад"	`onboarding`	`sticker_packs_back_click`	-	-

Примеры использования

Отслеживание открытия приложения

import customAnalyticsService from '../services/customAnalyticsService';

// В компоненте App.tsx при монтировании
useEffect(() => {
  customAnalyticsService.trackEvent({
    telegram_id: getCurrentUserId(),
    event_category: 'app',
    event_name: 'app_open'
  });
}, []);

Отслеживание навигации

import customAnalyticsService from '../services/customAnalyticsService';

// В компоненте страницы
useEffect(() => {
  customAnalyticsService.trackNavigation('home');
}, []);

Отслеживание генерации стикера

import customAnalyticsService from '../services/customAnalyticsService';

// При успешной генерации стикера
const handleGenerationSuccess = (presetName) => {
  customAnalyticsService.trackEvent({
    telegram_id: getCurrentUserId(),
    event_category: 'generation',
    event_name: 'generation_success',
    value: 1,
    unit: presetName
  });
};

Отслеживание покупки

import customAnalyticsService from '../services/customAnalyticsService';

// При успешной покупке
const handlePurchaseSuccess = (starsAmount) => {
  customAnalyticsService.trackPayment('purchase_success', starsAmount, 'star');
};

11 KiB Raw Blame History Unescape Escape