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

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

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

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

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

Реализация

1. Создайте события в Pushwoosh Control Panel

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

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

Совет

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

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

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

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

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

Примечание

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

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

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

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

Совет

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

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

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

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

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

Функция 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.