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

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

Когда вы изменяете карту, 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

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

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

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

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

В Control Panel перейдите в Кампании → Apple Wallet, чтобы открыть список карт. На странице перечислены все карты для приложения, включая их название, стиль, User ID, с которым они связаны, а также дату и время последнего обновления.

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

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

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

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

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

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

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

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

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

API Apple Wallet PassKit