Создание геозоны

Создайте геозону, чтобы определить, где будет срабатывать ваша кампания и что произойдет, когда пользователь войдет в эту область: отправка push-уведомления, событие Customer Journey или и то, и другое.

Перейдите в Campaigns → Geo campaigns. Нажмите Create geozone, чтобы начать.

Экран начала работы с гео-кампаниями с видом карты и действием Create geozone в панели управления Pushwoosh.

Укажите название кампании и агрегированную статистику

В поле Campaign name введите название длиной до 64 символов. Оно должно быть коротким и узнаваемым, например, Весенняя распродажа в центре.

При желании выберите существующую кампанию в поле Aggregated statistics. Push-уведомления гео-кампании будут учитываться вместе с другими точками взаимодействия в статистике агрегированных сообщений этой кампании.

Раздел формы геозоны с полями Campaign name и Aggregated statistics.

Выберите действия при входе

В разделе Entry actions включите любую комбинацию этих действий. Как минимум одно действие должно быть включено. Если включено несколько действий, основанных на событиях, присвойте каждому из них уникальное имя.

Используйте это сравнение, чтобы решить, какие действия включить:

Действие	Когда выбирать	Пример кампании	Хорошо сочетается с
Отправить push	Вы хотите, чтобы люди увидели сообщение в момент прибытия, без необходимости в Journey	Push-уведомление “Скидка 20% сегодня” в момент, когда покупатель входит в магазин	Fire dwell event, чтобы вы также могли отметить людей, которые задержались, для последующего сообщения
Вызвать событие	Вы хотите запустить более длинный автоматизированный сценарий (несколько сообщений со временем), а не одно push-уведомление	`PW_GeozoneEntered` запускает Journey: приветственное сообщение → ожидание 1 день → напоминание о карте лояльности	Fire exit event, чтобы Journey завершился только после того, как вы будете уверены, что человек действительно ушел
Вызвать событие выхода	Вы хотите точно знать, что человек ушел. Это подтверждение может прийти с опозданием, что хорошо для последующего сообщения, отправленного значительно позже визита	`PW_GeozoneExited` запускает опрос “Как прошел ваш визит?”, как только визит будет подтвержден	Fire event, чтобы тот же Journey, который приветствовал их при входе, также корректно завершился, когда они ушли
Вызвать событие пребывания	Вас интересуют только те, кто действительно провел там время, а не те, кто просто прошел мимо	`PW_GeozoneDwell` (Время внутри = 15 мин) отмечает “действительно заинтересованных” посетителей для последующего email-сообщения	Assume exit after silence, чтобы вы получали оба сигнала в вашей CRM, не отправляя сообщений человеку во время визита
Считать выходом после периода тишины	Ваше отслеживание местоположения часто теряет сигнал (в помещениях, при работе приложений в фоновом режиме), поэтому подтвержденный выход ненадежен. Это событие срабатывает в любом случае, по таймеру	`PW_GeozoneExitedByTimeout` (Тишина = 2 часа) завершает визиты на стадионе со слабым сигналом	Fire dwell event, чтобы вы могли надежно завершить визит и при этом знать, действительно ли они были вовлечены во время пребывания

Отправить push

Отправляет push-уведомление, которое вы настраиваете в разделе Составьте push-уведомление ниже. Например, устройство, вошедшее в зону в 10:00, получит push-уведомление сразу, если это позволяет cooldown. Отключите эту опцию, если вам нужно только действие, основанное на событии. Настройки сообщения исчезнут, и вам не нужно будет их заполнять.

Переключатель Send push включен в разделе Entry actions формы геозоны.

Вызвать событие

Вызывает пользовательское событие, когда устройство входит в зону. Используйте его как вход на основе триггера в Customer Journey. Например, устройство, вошедшее в зону в 14:00, вызовет событие PW_GeozoneEntered в 14:00. Вход и событие происходят в один и тот же момент.

Включите Fire event.
Укажите Event name. Оставьте поле пустым, чтобы использовать системное событие по умолчанию PW_GeozoneEntered, или введите свое название (до 128 символов).

Событие несет шесть атрибутов: geozone_code, geozone_name, lat, lng, range и distance. Если геозона назначена кластеру, оно также несет cluster_code и cluster_name.

Переключатель Fire event включен, под ним показаны поле Event name и атрибуты события.

Вызвать событие выхода

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

Как скоро произойдет этот контакт, зависит от ОС устройства и настроек фоновой работы, а не от Pushwoosh, поэтому задержка между фактическим выходом и событием может составлять от нескольких секунд до нескольких часов. Например, устройство, покинувшее зону в 15:00, но не связавшееся с Pushwoosh до 15:45, вызовет событие в 15:45, а не в 15:00.

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

Включите Fire exit event.
Укажите Exit event name. Оставьте поле пустым, чтобы использовать системное событие по умолчанию PW_GeozoneExited, или введите свое название.

Переключатель Fire exit event включен, под ним показаны поле Exit event name и атрибуты события.

Вызвать событие пребывания

Вызывает пользовательское событие, как только устройство пробудет внутри зоны в течение времени, указанного в Time inside, отсчитываемого с момента входа.

В отличие от Fire exit event, это действие не ждет, пока устройство свяжется с Pushwoosh. Pushwoosh запускает таймер, когда устройство входит в зону, и вызывает событие по истечении Time inside, даже если устройство не отправляет дальнейших обновлений местоположения.

Срабатывает один раз за пребывание: новый таймер запускается только после того, как устройство выйдет и снова войдет.
Контакт не требуется: устройство, которое перестает отправлять данные сразу после входа, все равно вызовет событие по расписанию.

Например, если Time inside установлено на 10 минут, устройство, вошедшее в 13:00, вызовет событие пребывания в 13:10, даже если оно не связывалось с Pushwoosh в это время.

Включите Fire dwell event.
Установите Time inside на значение от 1 до 1440 минут.
Укажите Dwell event name. Оставьте поле пустым, чтобы использовать системное событие по умолчанию PW_GeozoneDwell, или введите свое название.

Переключатель Fire dwell event включен, под ним показаны поля Time inside и Dwell event name.

Считать выходом после периода тишины

Вызывает пользовательское событие, как только устройство, последнее подтвержденное местоположение которого было внутри зоны, замолкает (перестает отправлять обновления местоположения в Pushwoosh) на время, установленное в Silence before assuming.

В отличие от Fire exit event, это действие не ждет, пока устройство сообщит о выходе из зоны. Оно срабатывает, когда устройство молчит в течение всего периода Silence before assuming, даже если ни одно обновление местоположения не покажет, что оно находится снаружи.

Эти два действия отвечают на разные вопросы:

Fire exit event: устройство отправило обновление местоположения из-за пределов зоны.
Assume exit after silence: Pushwoosh считает визит завершенным, потому что устройство перестало отправлять обновления.

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

Например, если Silence before assuming установлено на 30 минут, устройство, последнее местоположение которого было зафиксировано внутри зоны в 16:00, вызовет событие предполагаемого выхода в 16:30, если оно будет молчать все это время.

Включите Assume exit after silence.
Установите Silence before assuming на значение от 5 до 1440 минут.
Укажите Assumed exit event name. Оставьте поле пустым, чтобы использовать системное событие по умолчанию PW_GeozoneExitedByTimeout, или введите свое название.

Переключатель Assume exit after silence включен, под ним показаны поля Silence before assuming и Assumed exit event name.

События выхода, пребывания и предполагаемого выхода несут один дополнительный атрибут помимо шести перечисленных выше: dwell_seconds — время, которое устройство провело внутри зоны с момента входа до события.

Fire exit event также несет атрибут distance, так как оно происходит от фактического обновления местоположения.
Fire dwell event и Assume exit after silence не несут атрибут distance. Оба срабатывают по таймеру на сервере, а не от обновления местоположения.

Составьте push-уведомление

Если включена опция Send push, выберите способ составления уведомления:

Write a message: введите текст push-уведомления непосредственно в форме (до 1024 символов). Используйте эту опцию для быстрого одноразового сообщения в одной геозоне.
Use an existing preset: выберите сохраненный пресет для полного шаблонирования с заголовком, диплинком, пользовательским звуком и специфичными для платформы данными.

Форма создания гео-кампании, показывающая название кампании, настройки push-уведомления и опции звука и инбокса для iOS.

Настройте необязательные параметры сообщения:

Play default sound on iOS: использует системный звук push-уведомлений на устройствах iOS.
Save to inbox: сохраняет push-уведомление в инбоксе приложения на устройстве после доставки, чтобы пользователь мог вернуться к нему позже. Если включено, установите Inbox expire (1–30 дней) и, при необходимости, Inbox icon URL. Узнать больше.

Задайте местоположение триггера

Выберите форму для местоположения триггера:

Circle: найдите адрес, вставьте необработанные координаты в строку поиска или щелкните в любом месте на карте, чтобы поставить маркер. Перетащите маркер на окружности, чтобы установить Range. Радиус может быть установлен от 50 м до 100 км. По умолчанию — 200 м.

Местоположение триггера в режиме Circle с результатом поиска адреса и кругом радиуса, нарисованным вокруг местоположения в Нью-Йорке.

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

Местоположение триггера в режиме Polygon с пятиугольной фигурой, нарисованной вокруг городского квартала, количеством углов и производным кругом мониторинга, показанными под картой.

Телефон может отслеживать только круг, а не полигон. Когда вы рисуете полигон, Pushwoosh вычисляет круг, который полностью его содержит, с центром в центре фигуры и радиусом, достигающим самой дальней его точки (минимум 50 м). Устройство “просыпается” и сообщает свое местоположение, как только входит в этот круг.

Само push-уведомление в этот момент еще не отправляется. Оно отправляется только после того, как сервер подтвердит, что устройство действительно находится внутри нарисованного вами полигона. Вот почему push-уведомление может “разбудить” устройство раньше, чем оно достигнет вашей фигуры, но доставляется оно только после того, как пользователь действительно вошел в область.

Вы можете изменить форму при редактировании сохраненной геозоны:

Чтобы преобразовать геозону-полигон в круг, выберите Circle и установите центр и радиус как обычно.
Чтобы преобразовать геозону-круг в полигон, выберите Polygon и нарисуйте новые углы.
Удаление всех углов полигона (Clear shape) также возвращает его к форме круга.

Выберите кластер и cooldown

Cooldown — это период тишины после отправки push-уведомления. Для отдельной геозоны одно и то же устройство не получит от нее другого уведомления до истечения cooldown, даже если оно выйдет и снова войдет. Если геозона принадлежит кластеру, cooldown применяется ко всему кластеру: устройство будет молчать для всех геозон в этом кластере, а не только для той, которая отправила push-уведомление.

В поле Cooldown выберите один из трех режимов:

Режим	Как устанавливается cooldown	Поведение
Standalone	Установите дни, часы и минуты непосредственно для этой геозоны. Минимум — 1 минута. Максимум — 41 день.	Cooldown применяется только к этой геозоне.
Use existing cluster	Примените cooldown из существующего кластера.	Cooldown кластера переопределяет собственный cooldown этой геозоны.
New cluster	Создайте новый кластер и установите его cooldown. См. Создание кластера.	Cooldown кластера переопределяет собственный cooldown этой геозоны.

Выпадающий список режима Cooldown, показывающий опции Standalone, Use existing cluster и New cluster в Geo campaigns.

Настройте расписание срабатывания кампании

Раздел Campaign schedule ограничивает время срабатывания действий при входе. Push-уведомление или событие входа срабатывают только в том случае, если геозона активна в данный момент и cooldown позволяет доставку.

Ограничьте кампанию диапазоном дат

Эти поля необязательны. Установите их, если вы хотите, чтобы вся кампания проходила в определенном диапазоне дат, например, праздничная акция с 10 сентября по 23 октября или открытие магазина на ограниченное время.

Runs from: первый день, когда геозона может сработать.
Runs until: последний день, когда геозона может сработать.

Обе даты включительны. Геозона продолжает срабатывать до конца дня, указанного в Runs until.
Недельное расписание. Диапазон дат работает вместе с дневным режимом ниже, а не вместо него.
Часовой пояс. Runs from, Runs until и недельные часы используют часовой пояс расписания, установленный из часового пояса вашего браузера в момент сохранения геозоны. Сохраняйте из того часового пояса, которому должна следовать кампания, особенно если ваша команда работает в разных регионах. У совершенно новой геозоны Always active еще нет часового пояса расписания, поэтому ее даты оцениваются в UTC, пока вы не отредактируете и не сохраните ее хотя бы один раз.

Поля расписания кампании Runs from и Runs until установлены на 10 сентября 2026 г. и 23 октября 2026 г.

Выберите режим работы геозоны

Выберите Always active, чтобы кампания работала круглосуточно, или On selected days and hours, чтобы ограничить срабатывание определенными временными окнами для каждого дня недели.

Always active

Кампания срабатывает 24/7. Дальнейшая настройка расписания не требуется.

On selected days and hours

Кампания срабатывает только в установленные вами временные окна:

Включите каждый день недели, в который вы хотите, чтобы кампания срабатывала.
Установите время начала и окончания для этого дня.

Расписание кампании установлено в режим On selected days and hours с диапазоном дат Any date и временем с понедельника по пятницу с 09:00 до 18:00.

Нажмите Save, чтобы завершить, независимо от выбранного режима. Геозона будет включена немедленно. Если вы установили расписание, push-уведомления будут срабатывать только в настроенные временные окна.

Какие действия следуют расписанию

Send push, Fire event и другие действия, которые срабатывают при входе устройства в зону, выполняются только в активное окно расписания и когда cooldown позволяет доставку.
Fire exit event, Fire dwell event и Assume exit after silence следуют за визитом, а не за расписанием. Если устройство вошло, когда расписание было активным, эти действия все равно могут сработать после закрытия дневного окна.