Начало работы с картами Apple Wallet

Карты Apple Wallet — это цифровые карты, такие как карты лояльности, купоны, билеты на мероприятия, посадочные талоны и клубные карты, которые пользователи хранят в приложении Wallet на iPhone и Apple Watch. С помощью Pushwoosh вы можете визуально спроектировать карту в Панели управления, поделиться ею, а затем в любое время отправлять обновления, не требуя от пользователей ничего переустанавливать.

Когда вы изменяете карту, Pushwoosh уведомляет каждое устройство, на которое она добавлена, и iOS незаметно загружает новую версию. Штрихкод, баланс, номер выхода на посадку или срок действия на телефоне пользователя обновляются самостоятельно.

Что можно делать с картами Apple Wallet

С помощью карт Apple Wallet в Pushwoosh вы можете:

Визуально проектировать карты с цветами, полями, логотипом, фоновым изображением и штрихкодом, не создавая pass.json вручную.
Создавать карты лояльности, купоны, билеты на мероприятия, посадочные талоны и универсальные клубные карты.
Распространять карты среди пользователей в виде файла .pkpass, установочной ссылки или QR-кода.
Обновлять содержимое карты и доставлять изменения на устройства, на которые она добавлена.

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

Прежде чем вы создадите свою первую карту, убедитесь в следующем:

Программа Apple Developer: Вам потребуется активное членство для регистрации Pass Type ID и создания сертификатов подписи. Зарегистрироваться или управлять учетной записью
Платформа iOS: Ваше приложение должно быть подключено к iOS в Pushwoosh, прежде чем вы сможете добавить сертификат подписи для карт. Настроить iOS

Начало работы с картами Apple Wallet

После выполнения предварительных требований пройдите следующие шаги:

Настройте карты Wallet в Pushwoosh

Прежде чем вы сможете создавать карты, в Pushwoosh должен быть загружен ваш сертификат подписи Apple для приложения. Ваша команда разработчиков создает его в Apple Developer и загружает в Pushwoosh. Это однократная настройка для каждого приложения.

Как настроить сертификат подписи
Создайте дизайн карты

В конструкторе карт выберите стиль карты, настройте поля и брендинг, а также проверьте предварительный просмотр в реальном времени.
Сгенерируйте подписанный .pkpass

После создания и проверки карты в конструкторе карт выберите Generate. Pushwoosh подготовит изображения в необходимых разрешениях и подпишет файл вашим сертификатом.
Распространите карту

Отправьте пользователям файл .pkpass, установочную ссылку или QR-код. См. раздел Поделитесь картой с пользователями через каналы Pushwoosh. Когда пользователи добавляют карту в Wallet, их устройство регистрируется для получения будущих обновлений.
Обновите содержимое карты

Отредактируйте карту в конструкторе или через API и сохраните. Pushwoosh уведомит зарегистрированные устройства, и iOS загрузит новую версию в фоновом режиме. Пользователям не нужно переустанавливать карту.

Просмотр и управление существующими картами

В Панели управления перейдите в Campaigns → Wallet Passes и откройте вкладку Apple Wallet. В таблице All passes перечислены все карты для приложения, включая их название, стиль, связанный с ними User ID, а также дату и время последнего обновления.

В списке карт откройте меню действий (⋮), чтобы:

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

Скачать: скачать подписанный файл .pkpass.
QR-код: показать QR-код для установки, который пользователи могут отсканировать, чтобы добавить карту в Wallet и зарегистрировать свое устройство для получения обновлений. В этом окне вы также можете использовать Copy install link под QR-кодом.
Скопировать установочную ссылку: скопировать URL для установки, чтобы поделиться картой в ваших каналах обмена сообщениями. Узнать больше.
Удалить: удалить карту. Копии, уже установленные на устройствах, перестанут получать обновления и станут недействительными при следующем обновлении.

Поделитесь картой с пользователями через каналы Pushwoosh

Установочная ссылка, которую вы копируете в конструкторе (Copy install link), является обычным URL-адресом. Открытие ее на iPhone добавляет карту в Apple Wallet. Вы можете использовать эту ссылку в тех же каналах Pushwoosh, которые вы уже используете для охвата вашей аудитории:

Email: добавьте ссылку на кнопку или текстовую ссылку в редакторе email-сообщений, например, в призыв к действию «Добавить в Apple Wallet».
Push-уведомления: установите ссылку в качестве действия при открытии уведомления, чтобы нажатие открывало карту.
SMS: включите ссылку в содержимое SMS.

Каждая установочная ссылка привязана к одной карте (она содержит серийный номер и токен этой карты), поэтому одна ссылка работает для одной общей карты, что удобно для общего купона или билета на мероприятие. Чтобы предоставить каждому получателю собственную карту, сгенерируйте карту для каждого пользователя с помощью PassKit API и отправьте каждому пользователю его собственную ссылку. Карты Wallet устанавливаются только на устройства Apple — iPhone и Apple Watch.

Управление картами через API

Все, что делает конструктор карт, также доступно программно через PassKit Designer API: создание, обновление, получение списка, скачивание и удаление карт.

Apple Wallet PassKit API