События по умолчанию

Примечание

Доступно начиная с SDK 5.2.2

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

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

События по умолчанию доступны «из коробки» для актуальных версий SDK. Они не требуют дополнительных настроек, за исключением PW_InAppPurchase (подробности см. ниже).

Чтобы найти и активировать доступные в Pushwoosh события по умолчанию, выполните следующие действия:

1. Перейдите на вкладку События в разделе Аудитория.
2. Нажмите Создать событие.
3. Выберите Событие по умолчанию из выпадающего меню.
4. Во всплывающем окне выберите желаемое событие и нажмите Активировать.

После активации события по умолчанию можно использовать в сообщениях, основанных на поведении. Например, используйте их как вход по триггеру в Customer Journey или как триггер для In-App сообщений.

Совет

Чтобы узнать, как использовать события по умолчанию для создания маркетинговой кампании в Pushwoosh и автоматического превращения бесплатных пользователей в платных клиентов, посмотрите это руководство:

Видео на YouTube: Как использовать события по умолчанию для создания маркетинговой кампании в Pushwoosh и автоматического превращения бесплатных пользователей в платных клиентов

PW_DeviceRegistered

Это событие срабатывает только один раз для каждого устройства при первом запуске приложения и инициализации SDK. Как следует из названия, это событие отслеживает регистрацию устройства в вашем приложении.

Сценарии использования

• Запустите онбординг-кампанию для новых зарегистрированных пользователей — добавьте вход по триггеру с использованием события PW_DeviceRegistered в онбординг Customer Journey
• Определите, какие каналы привлечения приносят вам больше новых пользователей, с помощью статистики событий
• Вовлекайте пользователей с первого визита: встречайте их In-App сообщениями, срабатывающими по событию DeviceRegistered

PW_DeviceUnregistered

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

Атрибуты события

• message_id (string)
• message_code (string)
• campaign_id (string)

Сценарии использования

• Удерживайте пользователей, когда они решают прекратить использовать ваше приложение. Например, вы можете отправить email со специальным предложением каждому пользователю, который удалил приложение
• Поддерживайте связь с пользователями, которые отписались от одного из ваших каналов. Например, если пользователь больше не хочет получать push-уведомления, вы можете отправить email или показать in-app, чтобы побудить его чаще использовать приложение

PW_ApplicationOpen

Только для мобильных приложений

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

Атрибуты события

• device_type (целочисленный код типа устройства, подробности см. в registerDevice)
• application_version

Сценарии использования

• Собирайте статистику удержания пользователей на основе статистики события ApplicationOpen
• Запускайте in-app кампании для пользователей, которые активны в приложении

PW_ScreenOpen

Только для мобильных приложений

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

Атрибуты события

• application_version
• device_type (целочисленный код типа устройства, подробности см. в registerDevice)
• screen_name (техническое название экрана, полученное из вашего приложения)

Сценарии использования

• Отправляйте идеально релевантные сообщения пользователям, которые проявили интерес к определенным разделам приложения, запуская Customer Journeys с событием PW_ScreenOpen
• Оценивайте и улучшайте эффективность ваших акций: проведите A/B/n тестирование двух или нескольких версий вашего предложения, дождитесь срабатывания события ScreenOpen, а затем посмотрите, какой контент показал лучшие результаты
• Узнайте, какие экраны приложения посещаются чаще всего: отфильтруйте статистику событий по названию экрана

PW_ApplicationMinimized

Только для мобильных приложений

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

Атрибуты события

• device_type (целочисленный код типа устройства, подробности см. в registerDevice)
• application_version

Сценарии использования

• Отслеживайте среднее время сессии между событиями ApplicationOpen и ApplicationMinimized
• Отправляйте push-уведомления, пока приложение работает в фоновом режиме, чтобы привлечь внимание пользователей и вернуть их в приложение

PW_UserIdle

Только для мобильных приложений

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

Чтобы начать получать события PW_UserIdle, вам понадобится помощь вашей команды разработчиков. Поделитесь с ними приведенными ниже заметками по настройке SDK.

Это событие срабатывает, когда пользователь находится в вашем приложении, но не взаимодействовал с экраном в течение настраиваемого периода времени. В отличие от PW_ApplicationMinimized, которое срабатывает после того, как пользователь покинул приложение, PW_UserIdle срабатывает, пока пользователь все еще находится в приложении, — фиксируя момент, когда внимание падает, пользователь колеблется или отвлекается. Используйте его как серверный сигнал, чтобы своевременно показать In-App, предложить помощь или подтолкнуть пользователя к следующему шагу.

Обнаружение бездействия по умолчанию отключено на обеих платформах. Когда ключ тайм-аута отсутствует или установлен на 0, события PW_UserIdle не отправляются. Чтобы включить его, установите тайм-аут (минимум 30 секунд) в конфигурации платформы вашего приложения:

• Для iOS:
  • добавьте ключ Pushwoosh_IDLE_TIMEOUT_SECONDS (Number, минимум 30) в Info.plist вашего приложения.
• Для Android:
  • добавьте метаданные com.pushwoosh.idle_timeout_seconds (integer, минимум 30) в ваш AndroidManifest.xml.

Атрибуты события

• screen_name (string) — экран, на котором пользователь стал неактивным. Форматируется как ActivityName/FragmentName на Android и ParentVC/ChildVC на iOS, когда текущий экран является вложенным; в противном случае — имя activity или view controller
• idle_seconds (integer) — настроенный тайм-аут бездействия, который истек
• session_duration (integer) — секунды с момента последнего вывода приложения на передний план
• device_type (целочисленный код типа устройства, подробности см. в registerDevice)
• application_version (string)

Поведение

• Срабатывает не более одного раза за сессию на переднем плане. Возврат в фоновый режим и обратно на передний план начинает новую сессию.
• Таймер автоматически приостанавливается, когда открыта экранная клавиатура, когда на экране отображается модальное диалоговое окно или системный запрос, а также когда приложение находится в фоновом режиме.
• Физическое взаимодействие с экраном — касания, прокрутка и ввод текста — сбрасывает таймер.

Сценарии использования

• Запускайте In-App предложение или контекстного помощника, когда пользователи задерживаются на экране с высоким намерением — корзина, цены, оформление заказа — не предпринимая никаких действий
• Показывайте подсказку или руководство, когда пользователи застревают на этапе онбординга
• Определяйте, где пользователи теряют интерес, фильтруя статистику событий бездействия по screen_name

PW_ApplicationExit

Только для мобильных приложений

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

Чтобы начать получать события PW_ApplicationExit, вам понадобится помощь вашей команды разработчиков. Поделитесь с ними приведенными ниже заметками по настройке SDK.

Это событие срабатывает, когда пользователь переводит приложение в фоновый режим и не возвращается в течение настраиваемого тайм-аута. В отличие от PW_ApplicationMinimized, которое срабатывает немедленно, когда пользователь уходит, PW_ApplicationExit срабатывает только после истечения настроенной задержки — подтверждая, что пользователь действительно покинул сессию, а не просто ненадолго переключился между приложениями. Используйте его для повторного вовлечения пользователей, которые прервали сессию на полпути, или для запуска последующих кампаний после подтвержденного выхода.

Обнаружение намерения выхода по умолчанию отключено. Чтобы включить его, установите тайм-аут (10–30 секунд, значения за пределами этого диапазона автоматически ограничиваются) в конфигурации платформы вашего приложения:

• Для Android:
  • добавьте метаданные com.pushwoosh.exit_intent_timeout_seconds (integer, 10–30) в ваш AndroidManifest.xml.
• Для iOS:
  • добавьте ключ Pushwoosh_APPLICATION_EXIT_TIMEOUT_SECONDS (Number, 10–30) в Info.plist вашего приложения.

Атрибуты события

• screen_name (string) — последний активный экран, когда пользователь перевел приложение в фоновый режим
• session_duration (integer) — секунды с момента последнего вывода приложения на передний план
• exit_intent_seconds (integer) — фактический тайм-аут, который истек до срабатывания события (10–30 с)
• device_type (целочисленный код типа устройства, подробности см. в registerDevice)
• application_version (string)

Поведение

• Таймер запускается, когда приложение переводится в фоновый режим, и отменяется, если пользователь возвращается до истечения тайм-аута.
• Имя экрана и продолжительность сессии фиксируются в момент перехода в фоновый режим, а не в момент срабатывания события.
• Событие не срабатывает, если обнаружение намерения выхода отключено (ключ тайм-аута равен 0 или не установлен).

Сценарии использования

• Повторно вовлекайте пользователей, которые бросили процесс покупки или регистрации — запустите push-уведомление или email с напоминанием или скидкой
• Запустите Customer Journey по возвращению пользователей, которые выходят, не завершив ключевое действие (например, оставив корзину или прервав онбординг)
• Определяйте экраны с высоким показателем отказов, фильтруя статистику событий по screen_name

PW_SiteOpened

Только для веб-платформ

Событие SiteOpened срабатывает каждый раз, когда пользователь открывает любую из страниц вашего веб-сайта.

Атрибуты события

• device_type (целочисленный код типа устройства, подробности см. в registerDevice)
• title – заголовок посещенной страницы
• url – URL посещенной страницы

Сценарии использования

• Анализируйте распределение трафика на вашем сайте и сравнивайте количество раз, когда пользователи открывают определенные страницы сайта. Для этого отфильтруйте статистику событий по его атрибутам
• Продолжайте общение с пользователем после его визита на сайт с помощью релевантной коммуникации: создайте journey, начинающийся с события SiteOpened, настроенного на определенный атрибут ‘title’ или ‘url’

PW_InAppPurchase

Только для мобильных приложений

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

Чтобы настроить событие In-App Purchase, вам понадобится помощь вашей команды разработчиков. Поделитесь с ними этим руководством.

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

Примечание

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

Чтобы реализовать событие In-App Purchase:

• Для iOS:
  • активируйте событие PW_InAppPurchase в вашей Control Panel;
  • установите параметр Pushwoosh_PURCHASE_TRACKING_ENABLED в Pushwoosh iOS SDK на ‘yes’.
• Для Android:
  • активируйте событие PW_InAppPurchase в вашей Control Panel;
  • настройте отправку информации о покупках в Pushwoosh с помощью этого руководства.

Атрибуты события

• productIdentifier (получено из App Store)
• quantity – количество купленных предметов
• transactionDate – дата покупки
• status – статус покупки

Сценарии использования

• Собирайте статистику по внутриигровым покупкам
• Проводите акции и отслеживайте их успех: установите событие “Ожидание триггера” после промо-сообщения

PW_NotificationOpen

Для мобильных и веб-платформ

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

Сценарии использования

• Настройте оптимальное время для отправки push-уведомлений
• Создавайте сегменты на основе эффективности уведомлений за определенный период времени

PW_NotificationSend

Для мобильных и веб-платформ

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

Атрибуты события

• message_id (string)
• message_code (string)
• campaign_id (string)

Сценарии использования

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

PW_EmailLinkClicked

Только для email-платформы

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

Атрибуты события

• message_id (string)
• message_code (string)
• campaign_id (string)
• redirect_link (string)
• original_link (string)

Сценарии использования

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

PW_EmailOpen

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

Атрибуты события

• campaign_code (string): Уникальный код кампании, связанной с письмом.
• campaign_id (string): ID кампании.
• message_code (string): Уникальный идентификатор конкретного сообщения электронной почты.
• message_id (string): ID сообщения

Сценарии использования

• Отслеживайте открытия писем, чтобы выявлять пользователей, которые активно взаимодействуют с вашими рассылками. Используйте эти данные для создания последующих кампаний, например, отправки кодов скидок пользователям, которые открывают рекламные письма
• Если пользователи открывают письмо, но не совершают желаемого действия (например, не совершают покупку), вы можете запустить отправку последующих писем с напоминаниями или персонализированными предложениями
• Анализируйте показатели открытий по кампаниям, чтобы улучшать темы писем и стратегии времени отправки для таких кампаний, как запуск продуктов или сезонные акции

PW_InAppShown

Это событие срабатывает, когда пользователю отображается in-app сообщение.

Атрибуты события

• message_code (string): Уникальный идентификатор конкретного сообщения, связанного с in-app.
• message_id (integer): ID сообщения
• campaign_code (string): Уникальный код кампании, связанной с in-app.
• campaign_id (integer): ID кампании, которая вызвала показ in-app.
• rich_media_code (string): Уникальный идентификатор rich media контента, отображаемого в in-app.
• inapp_code (string): Уникальный код, идентифицирующий конкретное показанное in-app сообщение.

Сценарии использования

• Отслеживайте частоту просмотров in-app сообщений, чтобы корректировать свою стратегию обмена сообщениями, например, удаляя избыточные сообщения, которые могут раздражать пользователей
• Используйте данные о показах in-app для оценки охвата рекламных кампаний, таких как срочные распродажи или предложения по обновлению подписки
• Если in-app сообщение было показано, но на него не кликнули, вы можете запустить последующее действие, например, отправить push-уведомление с аналогичным содержанием, чтобы усилить сообщение

PW_InAppClicked

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

Атрибуты события

• message_code (string): Уникальный идентификатор конкретного сообщения, связанного с in-app.
• message_id (integer): ID сообщения.
• campaign_code (string): Уникальный код кампании, связанной с in-app.
• campaign_id (integer): ID кампании, которая вызвала показ in-app.
• rich_media_code (string): Уникальный идентификатор rich media контента, отображаемого в in-app (если применимо).
• inapp_code (string): Уникальный код, идентифицирующий конкретное нажатое in-app сообщение.
• element_id (string): Идентификатор конкретного элемента в in-app сообщении, на который был сделан клик (например, кнопка или ссылка).
• link (string): URL или диплинк, связанный с нажатым элементом.

Сценарии использования

• Анализируйте поведение кликов, чтобы определить, с какими кнопками или ссылками пользователи взаимодействуют чаще всего, и оптимизировать дизайн будущих in-app сообщений. Например, тестируйте разные CTA в кампаниях по обновлению подписки
• Запускайте автоматизированные действия на основе кликов пользователей, например, перенаправляйте пользователей на определенную страницу продукта или отправляйте push-уведомление

PW_WhatsAppReceived

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

Атрибуты события

• message (string): Содержимое или идентификатор полученного сообщения WhatsApp.

Сценарии использования

• Автоматизируйте последующие действия в ответ на входящие сообщения WhatsApp (например, запуск Customer Journey или отслеживание событий вовлеченности пользователей).
• Сегментируйте пользователей на основе их взаимодействий с сообщениями WhatsApp для целевой рассылки или персонализированных кампаний.