StickerAI-Front/ANALYTICS_EVENTS.md

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

В этом документе представлен полный список событий для отслеживания в приложении с использованием сервиса 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');
};