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

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

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

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

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

* Визуально проектировать карты с цветами, полями, логотипом, фоновым изображением и штрихкодом, не создавая `pass.json` вручную.
* Создавать карты лояльности, купоны, билеты на мероприятия, посадочные талоны и универсальные клубные карты.
* Распространять карты среди пользователей в виде файла `.pkpass`, ссылки для установки или QR-кода.
* Обновлять содержимое карты и доставлять изменения на устройства, добавившие карту.
* Взаимодействовать с владельцами карт с помощью разовых push-уведомлений, обновлений карт или Customer Journey. См. [Как отправлять сообщения владельцам карт Apple Wallet](/ru/product/messaging-channels/apple-wallet-passes/message-pass-holders/).

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

<Aside type="caution" icon="setting" title="Требуется помощь разработчика">
Для выпуска карт Apple Wallet требуется учетная запись Apple Developer и сертификаты подписи. Поделитесь этим разделом с вашей командой разработчиков, чтобы выполнить однократную настройку.
</Aside>

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

* **Программа Apple Developer:** Вам необходима активная подписка для регистрации Pass Type ID и создания сертификатов подписи. [Зарегистрируйтесь или управляйте своей учетной записью](https://developer.apple.com/programs/)
* **Платформа iOS:** В вашем приложении должна быть подключена платформа iOS в Pushwoosh, прежде чем вы сможете добавить сертификат подписи для карт. [Настроить iOS](/ru/developer/first-steps/connect-messaging-services/ios-configuration/)

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

После выполнения [предварительных требований](#prerequisites) выполните следующие действия:

<Steps>

1. **Настройте Wallet passes в Pushwoosh**

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

   [Как настроить сертификат подписи](/ru/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/)

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

   В [конструкторе карт](/ru/product/messaging-channels/apple-wallet-passes/pass-builder/) выберите стиль карты, настройте поля и брендинг, а также проверьте предварительный просмотр в реальном времени.

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

   После создания и проверки карты в [конструкторе карт](/ru/product/messaging-channels/apple-wallet-passes/pass-builder/#generate-the-pass) выберите **Сгенерировать**. Pushwoosh подготовит изображения в необходимых разрешениях и подпишет файл вашим сертификатом.

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

   Отправьте пользователям файл `.pkpass`, ссылку для установки или QR-код. См. [Поделитесь картой с пользователями через каналы Pushwoosh](#share-the-pass-with-users-via-pushwoosh-channels). Когда пользователи добавляют карту в Wallet, их устройство регистрируется для получения будущих обновлений.

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

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

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

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

   [Отправка сообщений владельцам карт Apple Wallet](/ru/product/messaging-channels/apple-wallet-passes/message-pass-holders/)

</Steps>

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

В Панели управления перейдите в **Campaigns → Wallet Passes** и откройте вкладку **Apple Wallet**. В таблице **All passes** перечислены все карты для приложения, включая их название, стиль, [User ID](/ru/product/pushwoosh-knowledge-hub/users-userids/), с которым они связаны, а также дату и время последнего обновления.

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

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

<Aside type="note" title="Обновления доставляются в виде тихих push-уведомлений">
Когда вы сохраняете изменение, Pushwoosh повторно подписывает карту и уведомляет каждое зарегистрированное устройство с помощью push-уведомления без контента. iOS самостоятельно загружает новую версию — переустановка не требуется.
</Aside> 

* **Скачать:** скачать подписанный файл `.pkpass`.
* **QR-код:** показать QR-код для установки, который пользователи могут отсканировать, чтобы добавить карту в Wallet и зарегистрировать свое устройство для обновлений. В этом окне вы также можете использовать **Копировать ссылку для установки** под QR-кодом.
* **Копировать ссылку для установки:** скопировать URL для установки, чтобы поделиться картой в ваших каналах обмена сообщениями. [Узнать больше](#share-the-pass-with-users-via-pushwoosh-channels).
* **Отправить сообщение:** открыть редактор разовых push-уведомлений для отправки сообщений владельцам карт. Когда вы открываете его из списка, он нацелен на владельца карты по [User ID](/ru/product/pushwoosh-knowledge-hub/users-userids/). См. [Отправка сообщений владельцам карт Apple Wallet](/ru/product/messaging-channels/apple-wallet-passes/message-pass-holders/), чтобы узнать обо всех способах связи с ними.
* **Удалить:** удалить карту. Копии, уже установленные на устройствах, перестанут получать обновления и станут недействительными при следующем обновлении.

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

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

* **Email:** добавьте ссылку на кнопку или текстовую ссылку в [редакторе email-сообщений](/ru/product/content/email-content/drag-and-drop-email-editor/), например, в призыв к действию «Добавить в Apple Wallet».
* **Push-уведомления:** установите ссылку в качестве [действия при открытии](/ru/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#define-what-happens-when-the-push-is-clicked) уведомления, чтобы по нажатию открывалась карта.
* **SMS:** включите ссылку в [содержимое SMS](/ru/product/messaging-channels/sms/send-sms/send-sms-via-customer-journey/#configure-sms-content).

<Aside type="note" title="Одна ссылка на одну карту">
Каждая ссылка для установки привязана к одной карте (она содержит серийный номер и токен этой карты), поэтому одна ссылка работает для одной общей карты, что удобно для общего купона или билета на мероприятие. Чтобы предоставить каждому получателю собственную карту, сгенерируйте карту для каждого пользователя с помощью [PassKit API](/ru/developer/api-reference/apple-wallet-passkit-api/) и отправьте каждому пользователю его собственную ссылку. Карты Wallet устанавливаются только на устройства Apple — iPhone и Apple Watch.
</Aside>

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

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

<LinkCard title="Apple Wallet PassKit API" href="/developer/api-reference/apple-wallet-passkit-api/" />

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

Когда пользователь добавляет вашу карту в Wallet, Pushwoosh отображает ее на вкладке **Devices and platforms** в [User Explorer](/ru/product/audience-data-and-segmentation/user-explorer/).

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

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

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

[Узнать больше](/ru/product/audience-data-and-segmentation/user-explorer/#devices-and-platforms-tab)