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

Примечание

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

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

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

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

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

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

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

Совет

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

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

Использование устройства и приложения

PW_DeviceRegistered

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

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

• platform (string): название платформы зарегистрированного устройства.
• platform_id (integer): код платформы, то же значение, что и device_type в registerDevice.

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

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

PW_DeviceUnregistered

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

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

• message_id (string)
• message_code (string)
• campaign_id (string)
• platform (string)
• platform_id (integer)

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

• Удерживайте пользователей, когда они решают прекратить использование вашего приложения. Например, вы можете отправить 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, когда текущий экран является вложенным. В противном случае — название активности. На 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 в вашей Control Panel. Установите параметр Pushwoosh_PURCHASE_TRACKING_ENABLED Pushwoosh iOS SDK в значение yes.
• Android: активируйте событие PW_InAppPurchase в вашей Control Panel. Настройте отправку информации о покупках в 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 (массив строк): названия категорий 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 (массив строк): названия категорий email, от которых пользователь отписался; опускается при полной отписке.

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

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

Совет

В конструкторе сегментов выпадающий список атрибута categories для PW_EmailSubscribed и PW_EmailUnsubscribed содержит фактические категории 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 отправляет их, в первом сообщении разговора Click-to-WhatsApp:

• ctwa_clid (string): ID клика рекламы Click-to-WhatsApp, которая начала разговор. Используйте его для атрибуции конверсий — каждое значение уникально для клика, поэтому оно не полезно для сегментации.
• referral_source_id (string): ID рекламы или поста, который начал разговор. Когда источником является реклама, это тот же ID рекламы, который отображается в Meta Ads Manager; посты там не перечислены.
• referral_source_type (string): тип источника перехода, например, реклама или пост.
• referral_source_url (string): URL рекламы или поста, который начал разговор.
• referral_headline (string): текст заголовка рекламы.
• referral_body (string): текст тела рекламы.

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

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