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

В отличие от [стандартных событий](/ru/product/audience-data-and-segmentation/events/default-events), которые являются универсальными для многих приложений и секторов, пользовательские события специфичны для вашего приложения. Эти события отслеживают определенные действия, уникальные для ваших нужд, например, завершение тренировки или продление подписки. Они помогают понять, как пользователи взаимодействуют с вашими конкретными функциями. Кроме того, они предоставляют более глубокое понимание поведения пользователей, помогают [отслеживать удержание](/ru/product/statistics-and-analytics/user-retention-statistics) и позволяют создавать персонализированные и эффективные маркетинговые кампании. Это в конечном итоге повышает вовлеченность и удовлетворенность пользователей.

Если пользовательское событие содержит данные о доходе (например, `order_completed` с атрибутом цены), вы можете сопоставить его с источником для [событий-конверсий](/ru/product/audience-data-and-segmentation/events/conversion-events/) без добавления нового кода.

## Создание пользовательских событий

Чтобы создать пользовательское событие в Pushwoosh:

1. Перейдите в **Audience > Events** и нажмите **Create Event**. В появившемся выпадающем меню выберите **Custom Event**.

<img src="/events-custom-events-1.webp" alt="Выпадающее меню Create Event с опцией Custom Event"/>

2. В открывшемся окне введите название вашего события в поле **Event Name**. Например, используйте `level_completed`, чтобы отслеживать, когда пользователь завершает уровень в игре. В поле **Description** дайте краткое описание события. Это поможет быстро понять назначение события.

<img src="/events-custom-events-2.webp" alt="Форма создания пользовательского события с полями Event Name и Description"/>

3. Определите конкретные атрибуты, относящиеся к вашему событию, и выберите тип атрибута. Атрибуты события — это определенные фрагменты информации, которые описывают детали события. Они фиксируют различные аспекты взаимодействия пользователя с вашим приложением. Это предоставляет ценные данные для точного таргетинга сообщений и сегментации. Вы можете добавить до 50 атрибутов к одному событию.

Доступные типы атрибутов:

*   **целое число**
*   **строка**
*   **логический тип**
*   **список**
*   **десятичное число (цена)**
*   **дата**

Подробнее о типах атрибутов см. в разделе [Общие сведения о событиях](/ru/product/audience-data-and-segmentation/events/#2-set-attributes).

<img src="/events-custom-events-3.webp" alt="Настройка атрибутов события, показывающая типы и поля атрибутов"/>

Для каждого произошедшего события будут соответствующие значения атрибутов. Например, атрибутами для события **level\_completed** могут быть **level\_number, completion\_time, score** или **points\_earned**. Когда событие будет записано в Pushwoosh, оно будет включать эти значения атрибутов вместе с временной меткой. Эти данные впоследствии можно использовать для создания сегментов, таргетинга сообщений и сбора статистики.

После заполнения необходимых данных и добавления атрибутов нажмите **Create**, чтобы завершить настройку события. Если вы решите не создавать событие, нажмите **Cancel**, чтобы отменить изменения.

<Aside type="caution" icon="setting" title="Требуется помощь разработчика">
 После того как вы настроите пользовательское событие в Панели управления, вам понадобится помощь команды разработчиков для его интеграции в ваше приложение. Поделитесь с ними кодом интеграции, который вы найдете рядом с созданным событием, а также [этой ссылкой](/ru/developer/guides/audience-and-segmentation/events#custom-events-implementation) с инструкциями.
</Aside>

## Управление пользовательскими событиями

Список событий предоставляет обзор всех пользовательских событий, которые вы создали для своего приложения. Каждое событие помогает отслеживать определенные взаимодействия или поведение пользователей.

**Детали события**

*   **Event Name**, которое идентифицирует событие (например, "button\_clicked", "video\_watched")
*   **Attributes** или ключевые фрагменты информации, связанные с событием, предоставляющие дополнительный контекст (например, "button\_id", "video\_category")
*   **7-Day Activity** — количество раз, когда событие произошло за последние семь дней, что дает быстрый обзор недавней активности

<img src="/events-custom-events-4.webp" alt="Список пользовательских событий с деталями и опциями управления"/>

У каждого события есть меню для дальнейшего управления:

*   Нажмите **View Code**, чтобы получить доступ к фрагменту кода, необходимому для интеграции этого события в кодовую базу вашего приложения.
*   Нажмите **Event Statistics**, чтобы углубиться в подробную статистику по выбранному событию, что дает представление о поведении пользователей.
*   Нажмите **Edit Event**, чтобы изменить настройки события, включая его название и связанные атрибуты, для обеспечения точного сбора данных.

<img src="/events-custom-events-6.webp" alt="Меню управления событием с опциями View Code, Event Statistics и Edit Event"/>

## Использование пользовательских событий в Pushwoosh

После настройки событий вы можете использовать их для:

1. [Создания Customer Journey](/ru/product/customer-journey/create-a-customer-journey-for-your-project), которое будет запускаться по вашему пользовательскому событию, используя элемент [**Trigger-based entry**](/ru/product/customer-journey/journey-elements#trigger-based-entry).
2. [Создания сегментов по событиям](/ru/product/audience-data-and-segmentation/segmentation/create-segments/by-events/), включая фильтрацию по значениям атрибутов событий и операторам.
3. Сегментации пользователей по таким критериям, как количество раз, когда они совершили пользовательское событие, или когда событие произошло в последний раз. Используйте эти сегменты для настройки [Audience-based entries](/ru/product/customer-journey/journey-elements/#audience-based-entry) в Customer Journeys или используйте опцию [Segment Split](/ru/product/customer-journey/journey-elements#segment-split) внутри Journey.
4. Установки [временной задержки в вашем Customer Journey](/ru/product/customer-journey/journey-elements#delay-based-on-user-or-event-data) на основе пользовательского события, которое пользователи вызывают в своем Journey.
5. Использования пользовательского события в шаге [Wait for Trigger](/ru/product/customer-journey/journey-elements#wait-for-trigger) для настройки различных сценариев коммуникации в зависимости от того, вызывает ли пользователь это конкретное событие или несколько событий в течение указанного времени.

## Примеры использования пользовательских событий

| Тип приложения                      | Пользовательское событие      | Описание                                                         | Пример использования                                                                                                                                                                                                                                                                               |
| ----------------------------- | ----------------- | ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Фитнес и здоровье       | workout\_complete | Пользователь завершает тренировку.                                 | Отправляйте мотивационные сообщения или награды, чтобы поддерживать вовлеченность пользователей и поощрять регулярные тренировки.                                                                                                                                                                                            |
| E-commerce               | cart\_abandoned   | Пользователь добавляет товары в корзину, но не завершает покупку. | <p>Отправьте напоминание по электронной почте или push-уведомление со специальным предложением или скидкой на товары, оставленные в корзине.</p><p><a href="/product/audience-data-and-segmentation/events/recommended-events-for-e-commerce">Изучите рекомендуемые события для e-commerce приложений</a></p> |
| Образование и e-Learning | complete\_course  | Пользователь завершает курс.                                          | Отправляйте поздравительные сообщения и рекомендуйте продвинутые курсы или связанные темы.                                                                                                                                                                                                         |
| Медиа и развлечения  | watch\_video      | Пользователь смотрит видео.                                             | <p>Отправляйте уведомления о похожем контенте или новых релизах. Рекомендуйте другие видео.</p><p><a href="/product/audience-data-and-segmentation/events/recommended-events-for-media">Изучите рекомендуемые события для медиа-приложений</a></p>                                    |
| Путешествия и гостеприимство   | book\_flight      | Пользователь бронирует авиабилет.                                              | Отправляйте напоминания о поездке, советы по упаковке и рекомендации по мероприятиям в месте назначения.                                                                                                                                                                                          |
| Приложения по подписке             | start\_trial      | Пользователь начинает бесплатный пробный период.                                         | <p>Отправляйте онбординговые сообщения с советами, предлагайте помощь и выделяйте ключевые функции.</p><p><a href="/product/audience-data-and-segmentation/events/recommended-events-for-subscription-management">Изучите рекомендуемые события для приложений по подписке</a></p>           |
| Мобильность или каршеринг   | ride\_completed   | Пользователь завершает поездку на каршеринге.                                 | Отправьте последующее in-app сообщение, запросите обратную связь или предложите скидку на следующую поездку.                                                                                                                                                                                               |
| Игровые приложения                   | level\_completed  | Пользователь завершает уровень в игре.                                      | <p>Отправляйте поздравительные сообщения и предлагайте советы или награды за прохождение следующего уровня. </p><p><a href="/product/audience-data-and-segmentation/events/recommended-events-for-gaming-apps">Изучите рекомендуемые события для игровых приложений</a></p>                        |

## Отслеживание пользовательских событий

#### Статистика событий

Вы можете отслеживать каждое созданное вами событие. Для этого:

1. Перейдите в **Audience > Events**.
2. В списке **Events** найдите событие, которое вы хотите отслеживать, и нажмите на три точки рядом с ним. Выберите **Event Statistics**.
3. Установите диапазон дат, за который вы хотите проанализировать данные о событии.
4. Уточните анализ данных о событии, добавив определенные условия или фильтры на основе атрибутов, таких как сегменты пользователей, типы устройств или другие пользовательские критерии.
5. Просмотрите график, который визуализирует частоту срабатывания выбранного события за указанный диапазон дат.
6. Вы также можете экспортировать данные о событии в файл CSV для дальнейшего анализа или отчетности.

<img src="/events-custom-events-7.webp" alt="Дашборд статистики событий с графиком частоты и опциями экспорта данных"/>

Чтобы обновить данные о событии, отображаемые на дашборде, нажмите кнопку **Refresh**.

#### Дашборды

Pushwoosh также позволяет отслеживать пользовательские события с помощью дашборда Events, который содержит статистику, связанную с событиями, используемыми в ваших кампаниях, или путем создания собственного дашборда. [Узнать больше](/ru/product/statistics-and-analytics/dashboards/)

#### Вкладка Retention

Используйте вкладку **Retention** для отслеживания удержания, связанного с конкретными событиями, имеющими отношение к вашему бизнесу. [Узнать больше](/ru/product/statistics-and-analytics/user-retention-statistics)