Как выпустить карту Wallet при входе в геозону

Выпускайте карту Apple или Google Wallet, когда покупатель входит в геозону магазина, а затем отправляйте ссылку установки. Это руководство строит такой journey с элементом Выпуск пасса.

Предварительные требования

• Подключите платформу iOS и завершите настройку карты Apple Wallet, и/или настройте Google Wallet для Android для тех платформ, которые вы поддерживаете.
• Гео-кампаниям нужно разрешение на геолокацию на устройстве и включённое отслеживание местоположения в приложении. См. Как работают гео-кампании.

Создайте кампанию Wallet Pass

Элемент Выпуск пасса может выпускать карты только из существующей кампании, поэтому сначала создайте её. Платформа кампании неизменна, поэтому если вы поддерживаете и Apple Wallet, и Google Wallet, повторите этот раздел для каждой платформы отдельно.

1. Перейдите в Campaigns → Wallet Passes → Campaigns и нажмите Create campaign.
2. Выберите Apple Wallet или Google Wallet в качестве Platform, введите Name для собственного удобства, например Store loyalty (это название кампании внутри Pushwoosh, на самой карте оно не отображается), и выберите стиль карты, например Store Card (Apple) или Loyalty card (Google).

3. В разделе Basic Information установите Pass Name — то, что отображается на самой карте, например Store Loyalty Card.

4. Оформите остальную часть карты, затем просмотрите предпросмотр и создайте кампанию.

Полный пошаговый разбор полей: Создание кампании Wallet Pass.

Создайте геозону магазина

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

1. Перейдите в Campaigns → Geo campaigns и нажмите Create geozone.

2. Введите Campaign name, например Downtown store.

3. В разделе Место срабатывания выберите Circle, найдите адрес магазина и задайте Радиус, м (не менее 50).

4. В разделе Entry actions включите Fire event. Оставьте Event name пустым, тогда будет использовано имя по умолчанию PW_GeozoneEntered.
5. Отключите Send push, если вы хотите, чтобы сообщение покупателю отправлял только journey, а не отдельный пуш геозоны при том же входе.
6. Задайте Cooldown (для начала достаточно Standalone с небольшой длительностью) и Campaign schedule (Always active, если не нужны определённые часы).

7. Нажмите Save. Событие становится доступно в Trigger-based entry сразу после сохранения.

Полный пошаговый разбор полей: Создание геозоны.

Примечание

PW_GeozoneEntered срабатывает, когда устройство входит в геозону и её entry-действиям разрешено выполняться (расписание кампании активно, cooldown допускает доставку, и пользователь предоставил разрешение на геолокацию).

Постройте journey

Перейдите в Campaigns → Customer Journey Builder, нажмите Create campaign и постройте всё описанное ниже на одном холсте.

Настройте вход

1. Добавьте на холст элемент Trigger-based entry.
2. Назовите его Geozone Entry.
3. Выберите PW_GeozoneEntered в качестве Event.

Ограничение одним магазином

В этом руководстве используется имя события по умолчанию. Каждая геозона, у которой поле Event name оставлено пустым, отправляет одно и то же событие PW_GeozoneEntered, поэтому в этот journey попадают покупатели из всех таких магазинов. Чтобы ограничить journey одним магазином, задайте на этой геозоне уникальное Event name и выберите это имя здесь, либо оставьте имя по умолчанию и нажмите + Add condition, чтобы отфильтровать по geozone_code (или geozone_name) для нужного магазина.

Выпустите карту Wallet

1. Добавьте элемент Выпуск пасса сразу после входа.
2. Назовите его Store pass.

3. В Apple Wallet campaign выберите кампанию, созданную для Apple. В Google Wallet campaign выберите кампанию, созданную для Google. Каждый выпадающий список показывает только кампании своей платформы. Элемент выпускает карту для каждой выбранной платформы.

Разветвите по платформе и отправьте пуш

Примечание

Можно было бы также ветвиться по тегу Platform с помощью Condition split, но сохранённое значение тега не подтверждает, что устройство сейчас способно получить пуш. Вместо этого используйте Reachability check: он подтверждает, что устройство зарегистрировано и что Push Alerts Enabled включён, проверяя только то устройство, которое вошло в геозону, если задать соответствующий охват.

1. После элемента Выпуск пасса добавьте элемент Reachability check и назовите его, например, iOS Device?.
2. В разделе Push Notifications нажмите iOS.

3. В разделе Which devices to check выберите Only the device that entered, чтобы проверка учитывала именно то устройство, которое вызвало вход в геозону, а не все устройства покупателя.

4. На ветке Push: iOS добавьте элемент Пуш. Выберите Маркетинговое сообщение или Транзакционное сообщение и отключите Отправлять на все устройства пользователя (по UserID), чтобы пуш ушёл только на то устройство, которое вошло в геозону.
5. В тело сообщения вставьте {apple_install_link|regular|}.
6. Включите Personalise message with event attributes, отметьте Overwrite placeholder, установите Source event в Store pass, а Dynamic attribute — в apple_install_link.

7. После редактирования пуша заново выберите пресет, чтобы маппинг подхватил новый плейсхолдер. Полный пошаговый путь: Отправка ссылки на карту пользователю.
8. На ветке All others добавьте второй Reachability check с именем Android Device?, с Push Notifications, суженным до Android, и той же настройкой Only the device that entered.
9. На его ветке Push: Android добавьте Пуш. Задайте тип сообщения и отключите Отправлять на все устройства пользователя (по UserID), как на ветке iOS. Вставьте {google_save_link|regular|} и замапьте Dynamic attribute google_save_link так же.
10. Оставшуюся ветку All others оставьте без соединения, если у вас нет другого канала для этих пользователей. Ветка без исходящего соединения сама завершает journey в этой точке, поэтому элемент Exit ей не нужен.

Покупатель попадает в All others, когда его устройство не зарегистрировано на проверяемой платформе, либо когда тег Push Alerts Enabled для этого устройства не равен true (push-разрешение выключено).

Когда срабатывает PW_GeozoneEntered, покупатель входит в journey, элемент Выпуск пасса выпускает его карту, а соответствующий элемент Пуш доставляет ссылку установки для его платформы.

Запустите и проверьте

1. Запустите journey, когда холст готов.
2. После тестового входа проверьте количество входов и отвалов на элементе Выпуск пасса и статистику на каждом элементе Пуш.

Повторные визиты

Повторный визит переиспользует ту же карту и повторно отправляет пуш. Повторный визит ограничивает только cooldown геозоны, а не настройка повторного входа элемента входа. Эта настройка блокирует повторное срабатывание только пока предыдущая сессия покупателя ещё активна, а сессия завершается сразу после пуша первого визита, поскольку ни одна из веток не ведёт к дальнейшему шагу. Поэтому настройка по умолчанию Do not allow re-entry не блокирует повторный визит. О стороне выпуска карты см. Что происходит на этом шаге.