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

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

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

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

С картами Apple Wallet в Pushwoosh вы можете:

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

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

Требуется помощь разработчика

Для выпуска карт Apple Wallet требуется учетная запись Apple Developer и сертификаты подписи. Поделитесь этим разделом с вашей командой разработчиков, чтобы выполнить однократную настройку.

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

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

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

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

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

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

   Как настроить сертификат подписи

2. Создайте дизайн карты

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

3. Сгенерируйте подписанный .pkpass

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

4. Распространите карту

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

5. Обновите содержимое карты

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

6. Отправляйте сообщения владельцам карт

   Как только пользователи добавят карту в Wallet, вы сможете взаимодействовать с ними с помощью разовых push-уведомлений, обновлений карт или автоматизированных Customer Journey.

   Отправка сообщений владельцам карт Apple Wallet

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

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

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

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

Обновления доставляются в виде тихих push-уведомлений

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

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

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

Ссылка для установки, которую вы копируете в конструкторе (Скопировать ссылку для установки), является обычным 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

Просмотр владельцев карт в User Explorer

Когда пользователь добавляет вашу карту в Wallet, Pushwoosh отображает ее на вкладке Devices and platforms в User Explorer.

1. Перейдите в Audience → User Explorer и откройте профиль пользователя.
2. Откройте вкладку Devices and platforms.
3. Выберите Apple Wallet в боковой панели.

В профиле платформы вы можете просмотреть:

• Статус подписки: например, SUBSCRIBED
• Идентификатор платформы: идентификатор карты, отображаемый под названием платформы
• Метаданные: First subscription, Timezone и другие поля, если они доступны
• Теги: теги платформы, включая те, которые вы установили при выпуске карты

Узнать больше