Понимание событий в Pushwoosh

События (Events) предназначены для записи различных действий, которые пользователь совершает в приложении. В отличие от тегов (Tags), которые хранят плоские данные (например, страна, модель устройства или данные об установке), данные о событиях хранятся в исторической перспективе. Это создает историю поведения пользователя, а не статическую информацию об устройстве. Вся контекстная информация о событии может быть передана в виде атрибутов и их значений.

События в Pushwoosh делятся на три категории: события по умолчанию, доступные «из коробки», пользовательские события, которые вы определяете для своего приложения, и события-конверсии для отслеживания дохода в едином формате.

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

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

Реализация

1. Создайте события в панели управления Pushwoosh

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

Чтобы создать событие, перейдите в раздел Events в вашей панели управления и нажмите кнопку Add event. Введите название и описание и при необходимости добавьте атрибуты.

Совет

Данные о событиях ценны только в том случае, если они отправлены правильно. Поэтому мы настоятельно рекомендуем следовать простым рекомендациям ниже:

• Старайтесь давать событиям как можно более короткие названия.
• Называйте события в честь действий, которые пользователь совершает в приложении — «LoggedIn», «SignedOut», «Subscribed» и т. д.
• Помните, что названия событий чувствительны к регистру.
• Объединяйте события, описывающие одно действие, в одно событие. Например, используйте событие «Subscribed» с соответствующими атрибутами вместо отдельных событий «SubscribedToSports», «SubscribedToPolitics», «SubscribedToTechnology».

2. Задайте атрибуты

Все детали, описывающие событие, предоставляются с его атрибутами. Атрибуты — это пары ключ/значение. В панели управления вы можете выбрать один из следующих типов:

• integer
• string
• boolean
• list
• decimal (price)
• date

Примечание

Вы можете добавить до 50 атрибутов к событию, при этом полезная нагрузка (содержимое) каждого атрибута ограничена 10 КБ.

Например, вы можете отслеживать входы пользователей в систему и собирать учетные данные для входа (например, вход через Facebook, Google, Twitter или по электронной почте), тип интернет-соединения (wifi, cellular, unknown) и успешность входа (значения true или false) с помощью одного события Login, указав его атрибуты следующим образом:

атрибут	тип	значение
type	string	facebook, google, twitter, email
connection	string	wifi, cellular, unknown
success	boolean	true, false

Это событие будет записано в Pushwoosh со значениями атрибутов и временной меткой, чтобы позже его можно было использовать для создания сегментов, таргетинга сообщений и сбора статистики.

Совет

Чтобы фильтровать пользователей по значениям атрибутов событий при создании сегмента, см. Создание сегментов по событиям.

3. Вызовите API /postEvent

Требуется помощь разработчика

Для этого шага вам понадобится помощь вашей команды разработчиков. Пожалуйста, поделитесь с ними этой ссылкой для получения подробных инструкций по настройке событий.

Импорт событий

Функция Import events позволяет загружать данные о событиях из CSV-файла, что упрощает массовое отслеживание и анализ активности пользователей. Вы можете импортировать события из различных аналитических и CRM-систем, чтобы обогатить свои данные и улучшить сегментацию.

Чтобы импортировать события, перейдите в Audience → Import CSV → Import events.

Шаг 1. Загрузите CSV

Загрузите CSV-файл, содержащий данные о событиях. Файл должен включать следующие обязательные столбцы:

• Event name: название события.
• Event date: дата и время, когда произошло событие.
• HWID или User ID: уникальный идентификатор пользователя, связанного с событием.

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

Чтобы загрузить файл, перетащите CSV-файл в область загрузки или нажмите, чтобы выбрать файл с вашего устройства. Максимально допустимый размер файла — 100 МБ.

Шаг 2. Сопоставьте столбцы

После загрузки файла необходимо сопоставить столбцы CSV с соответствующими атрибутами событий в Pushwoosh.

• Назначьте каждое обязательное поле (Event Name, Event Date, HWID или User ID) правильному столбцу в вашем файле.
• Если ваш CSV-файл содержит пользовательские атрибуты, сопоставьте их с осмысленными именами, которые соответствуют вашим потребностям в отслеживании данных.
• Нажмите Add attribute, чтобы при необходимости добавить дополнительные поля.

Когда все столбцы будут правильно сопоставлены, нажмите Import events.

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

При необходимости вы можете загрузить другой файл, чтобы продолжить импорт дополнительных данных.

Вы можете найти импортированные события в разделе Events History в User Explorer.