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

Примечание

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

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

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

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

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

1. Перейдите на вкладку Events в разделе Audience.
2. Нажмите Create Event.
3. Выберите Default Event из выпадающего меню.
4. Во всплывающем окне выберите желаемое событие и нажмите Activate.

После активации события по умолчанию можно использовать в сообщениях, основанных на поведении. Например, используйте их в качестве входа на основе триггера в 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 (integer): код типа устройства. Подробности см. в registerDevice.
• application_version (string): версия приложения.

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

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

PW_ScreenOpen

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

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

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

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

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

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

PW_ApplicationMinimized

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

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

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

• device_type (integer): код типа устройства. Подробности см. в registerDevice.
• application_version (string): версия приложения.

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

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

PW_UserIdle

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

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

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

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

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

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

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

• screen_name (string): экран, на котором пользователь стал неактивным. На Android форматируется как ActivityName/FragmentName, когда текущий экран является вложенным. В противном случае — название activity. На iOS форматируется как ParentVC/ChildVC при вложенности. В противном случае — название view controller.
• idle_seconds (integer): настроенный тайм-аут бездействия, который истек.
• session_duration (integer): секунды с момента последнего вывода приложения на передний план.
• device_type (integer): код типа устройства. Подробности см. в 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 (целое число, 10–30) в ваш AndroidManifest.xml.
• iOS: добавьте ключ Pushwoosh_APPLICATION_EXIT_TIMEOUT_SECONDS (число, 10–30) в файл Info.plist вашего приложения.

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

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

Поведение

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

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

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

Веб

PW_SiteOpened

Только для веба

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

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

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

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

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

Коммерция

PW_InAppPurchase

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

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

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

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

Примечание

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

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

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

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

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

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

• Собирайте статистику по внутриигровым покупкам.
• Проводите акции и отслеживайте их успешность. Установите событие «Ожидание триггера» после промо-сообщения.

Push-уведомления

PW_NotificationSend

Только для мобильных устройств и веба

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

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

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

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

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

PW_NotificationOpen

Только для мобильных устройств и веба

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

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

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

Email

PW_EmailSent

Только для email

Это событие срабатывает, как только email отправляется провайдеру электронной почты. Проверьте status_code для получения результата.

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

• message_id (string): ID сообщения.
• message_code (string): уникальный идентификатор конкретного email-сообщения.
• status_code (integer): код статуса доставки, возвращенный провайдером электронной почты для этой попытки отправки.
• campaign_id (string): ID кампании. Включается только в том случае, если email был отправлен в рамках кампании.
• campaign_code (string): уникальный код кампании. Включается, когда отправка является частью кампании и поиск кампании успешен. campaign_code может отсутствовать, даже если campaign_id присутствует.

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

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

PW_EmailOpen

Только для email

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

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

• campaign_code (string): уникальный код кампании, связанной с email.
• campaign_id (string): ID кампании.
• message_code (string): уникальный идентификатор конкретного email-сообщения.
• message_id (string): ID сообщения.
• opened_by (string): кто или что вызвало открытие: user для подлинного открытия получателем или ampp для автоматического открытия, вызванного Apple Mail Privacy Protection, предварительно загрузившим пиксель отслеживания.

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

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

PW_EmailLinkClicked

Только для email

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

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

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

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

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

In-app сообщения

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-уведомление.

SMS

PW_SMSSent

Только для SMS

Это событие срабатывает, как только SMS отправляется провайдеру SMS. Проверьте status_code для получения результата.

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

• message_id (string): ID сообщения.
• message_code (string): уникальный идентификатор конкретного SMS-сообщения.
• status_code (integer): код статуса доставки, возвращенный провайдером SMS для этой попытки отправки. Используйте его, чтобы отличить успех от неудачи.
• campaign_id (string): ID кампании. Включается только в том случае, если SMS было отправлено в рамках кампании.
• campaign_code (string): уникальный код кампании. Включается, когда отправка является частью кампании и поиск кампании успешен. campaign_code может отсутствовать, даже если campaign_id присутствует.

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

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

WhatsApp

PW_WhatsAppSent

Только для WhatsApp

Это событие срабатывает, как только сообщение WhatsApp отправляется провайдеру WhatsApp. Проверьте status_code для получения результата.

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

• message_id (string): ID сообщения.
• message_code (string): уникальный идентификатор конкретного сообщения WhatsApp.
• status_code (integer): код статуса доставки, возвращенный провайдером WhatsApp для этой попытки отправки. Используйте его, чтобы отличить успех от неудачи.
• campaign_id (string): ID кампании. Включается только в том случае, если сообщение WhatsApp было отправлено в рамках кампании.
• campaign_code (string): уникальный код кампании. Включается, когда отправка является частью кампании и поиск кампании успешен. campaign_code может отсутствовать, даже если campaign_id присутствует.

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

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

PW_WhatsAppReceived

Только для WhatsApp

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

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

• message (string): содержимое полученного сообщения. Для сообщений о местоположении содержит координаты в формате "широта,долгота" (например, "55.751244,37.618423").
• latitude (number): широта переданного местоположения. Включается только тогда, когда пользователь делится своим текущим местоположением.
• longitude (number): долгота переданного местоположения. Включается только тогда, когда пользователь делится своим текущим местоположением.

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

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