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

Примечание

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

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

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

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

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

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

После активации события по умолчанию можно использовать в сообщениях, основанных на поведении. Например, используйте их как вход по триггеру (Trigger-based Entry) в 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 (Number, минимум 30) в Info.plist вашего приложения.
• Android: добавьте метаданные com.pushwoosh.idle_timeout_seconds (integer, минимум 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 (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 (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): статус покупки.

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

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

Совет

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

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

PW_EmailSubscribed

Только для email

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

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

• message_id (string): ID сообщения, которое вызвало подписку, если применимо.
• campaign_id (string): ID связанной кампании, если применимо.
• message_code (string): уникальный идентификатор конкретного сообщения, если применимо.
• categories (array of strings): названия категорий email, на которые подписался пользователь; опускается, если не применимо (например, регистрация без автоматически подписываемых категорий).
• resubscribe (boolean): true для любой отправки из центра предпочтений или по ссылке для повторной подписки — включая первую подписку пользователя, сделанную там; опускается для автоматической подписки при регистрации устройства.

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

• Используйте resubscribe, чтобы отделить подписки, сделанные через центр предпочтений, от автоматических подписок при регистрации.
• Создавайте сегменты пользователей, подписанных на определенную категорию.

PW_EmailUnsubscribed

Только для email

Это событие срабатывает, когда пользователь отписывается от одной или нескольких категорий email, а также при полном отказе от всех маркетинговых писем (тег Unsubscribed Emails) — в этом случае categories опускается. Если пользователь отписывается от нескольких категорий одновременно, categories перечисляет их все.

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

• message_id (string): ID сообщения, от которого пользователь отписался, если применимо.
• campaign_id (string): ID связанной кампании, если применимо.
• message_code (string): уникальный идентификатор конкретного сообщения, если применимо.
• categories (array of strings): названия категорий email, от которых пользователь отписался; опускается при полном отказе.

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

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

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