Создание пропусков в конструкторе пропусков

Конструктор пропусков Apple Wallet — это визуальный редактор в Control Panel. Вы выбираете стиль пропуска, заполняете информацию о брендинге, поля и штрих-код, просматриваете предварительный просмотр в реальном времени и генерируете подписанный файл .pkpass — без необходимости вручную писать pass.json.

Создание пропуска

В Control Panel перейдите в Кампании → Apple Wallet и нажмите Создать пропуск.

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

Настройка пропуска

С нуля: начните с пустого пропуска. Выберите стиль пропуска, а затем самостоятельно установите цвета, изображения, поля, штрих-код и другие параметры в разделах ниже.
Из шаблона: нажмите Загрузить шаблон, выберите встроенный пропуск в Выбрать шаблон (проездной билет, купон, билет на мероприятие, общий или карта магазина) и подтвердите. Форма предварительно заполнит стиль пропуска, цвета, изображения, поля пропуска, штрих-код и основную информацию. При необходимости отредактируйте любое значение или измените стиль. Pushwoosh заменяет идентификаторы команды и типа пропуска из шаблона на значения вашего приложения.

Выберите стиль пропуска

В разделе СТИЛЬ ПРОПУСКА выберите один из пяти стилей пропусков Apple Wallet. Стиль определяет макет, а также доступные области полей и изображений:

Проездной билет
Купон
Билет на мероприятие
Карта магазина
Общий

Если вы начинаете с нуля, выберите стиль, прежде чем добавлять поля и изображения. При смене стиля поля, специфичные для стиля, сбрасываются.

Добавьте название и описание пропуска

В разделе ОСНОВНАЯ ИНФОРМАЦИЯ заполните:


Название пропуска	Название пропуска и имя источника, отображаемое в уведомлениях об обновлении.
Описание	Краткое описание пропуска.
Текст логотипа	Текст, отображаемый рядом с логотипом (используется, если изображение логотипа не загружено).

Раздел основной информации с полями 'Название пропуска', 'Описание' и 'Текст логотипа'

Установите цвета и изображения

Цвета

В разделе ЦВЕТА установите:

Цвет фона: фон пропуска.
Цвет переднего плана: основной текст и иконки на пропуске.
Цвет метки: цвет меток полей (например, ОТКУДА, ВЫХОД).

Чтобы установить или изменить цвет, нажмите на его поле и выберите цвет в палитре.

Раздел 'Цвета' с полями 'Цвет фона', 'Цвет переднего плана' и 'Цвет метки'

Изображения

В разделе ИЗОБРАЖЕНИЯ загрузите Иконку и Логотип (оба обязательны). Необязательные изображения зависят от стиля пропуска.

Нажмите Выбрать файл рядом с каждым слотом для изображения. Загружайте файлы PNG или JPEG. Pushwoosh обрабатывает каждое изображение в разрешения, требуемые Apple (@1x, @2x, @3x), при генерации пропуска.

Заполните поля пропуска

В разделе ПОЛЯ ПРОПУСКА добавьте текст и значения, которые будут отображаться на пропуске. Какие группы вы увидите, зависит от стиля пропуска:

Поля заголовка (вверху пропуска): Проездной билет, Билет на мероприятие
Основные поля (основное содержимое): все стили
Второстепенные поля (вспомогательная информация): все стили
Дополнительные поля (дополнительные детали): все стили
Поля на обратной стороне (обратная сторона пропуска): все стили

Нажмите + Добавить поле в каждой нужной группе.

Для каждого поля установите:


Ключ (ID)	Уникальный идентификатор поля (генерируется автоматически).
Метка	Краткая метка на пропуске (например, `ОТКУДА`).
Значение	Значение, отображаемое на пропуске (например, `SFO`).
Сообщение об изменении	Текст в уведомлении об обновлении при изменении этого значения. Отображается только при изменении значения. Используйте `%@` для нового значения (например, `Выход изменен на %@`).

Поле пропуска с кнопкой 'Формат' и развернутыми параметрами форматирования для формата значения и выравнивания текста

На карточке поля нажмите Формат, чтобы отобразить параметры форматирования. Нажмите X, чтобы удалить поле.

Параметры форматирования

Формат значения: Текст, Дата и время или Число/валюта.
Выравнивание текста: По умолчанию (естественное), по левому краю, по центру или по правому краю.
Детекторы данных (только для полей на обратной стороне): превращают номера телефонов, ссылки, адреса и события календаря в кликабельный контент на полях обратной стороны.

Добавьте штрих-код

В разделе ШТРИХ-КОД выберите формат и введите данные для кодирования:

Формат штрих-кода: выберите, как выглядит штрих-код и какой тип сканера может его прочитать.
- QR-код (рекомендуется): квадратный код, который легко считывается большинством телефонов и сканеров. Лучше всего подходит для купонов, карт лояльности и большинства пропусков.
- PDF417: широкий штрих-код, состоящий из нескольких рядов линий. Часто требуется для авиационных или транзитных проездных билетов.
- Aztec: компактный квадратный код, похожий на QR. Распространен на билетах на мероприятия и в общественном транспорте.
- Code 128: классический штрих-код с вертикальными линиями. Выбирайте его, только если ваш сканер или POS-система требует 1D-штрих-код.
Сообщение штрих-кода: значение, закодированное в штрих-коде (например, номер билета или членства).
Альтернативный текст (необязательно): текст, отображаемый под штрих-кодом на пропуске.

Раздел 'ШТРИХ-КОД' с выпадающим списком формата, полем сообщения штрих-кода и необязательным полем альтернативного текста

Установите срок действия и статус

В разделе СРОК ДЕЙСТВИЯ И СТАТУС укажите, когда пропуск будет отображаться, когда истекает его срок действия и действителен ли он еще:

Актуальная дата (когда показывать пропуск): дата и время, когда пропуск может появиться на экране блокировки.
Дата истечения срока действия (когда пропуск истекает): дата и время, после которых пропуск становится неактивным в Wallet.
Пометить как недействительный (аннулировать этот пропуск): флажок для аннулирования пропуска, чтобы он больше не был действителен.

Раздел 'Срок действия и статус' с актуальной датой, датой истечения срока действия и флажком 'недействительный'

Специфичные для стиля и расширенные параметры

Тип транспорта (только для проездного билета): Самолет, Поезд, Автобус, Корабль или Общий.
Идентификатор группировки: группируйте связанные пропуски вместе в Wallet.

Актуальность в зависимости от местоположения (необязательно)

В разделе АКТУАЛЬНОСТЬ В ЗАВИСИМОСТИ ОТ МЕСТОПОЛОЖЕНИЯ пропуск появляется, когда пользователь находится рядом с добавленными вами местоположениями. Для каждого местоположения установите текст, отображаемый на экране блокировки, когда пользователь находится поблизости. Вы можете добавить до 10 местоположений.

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

Максимальное расстояние (в метрах) определяет, насколько близко должен находиться пользователь, чтобы пропуск оставался актуальным.

Раздел 'Актуальность в зависимости от местоположения' с картой, списком местоположений, текстом для экрана блокировки и полем максимального расстояния

Раздел АКТУАЛЬНОСТЬ В ЗАВИСИМОСТИ ОТ МЕСТОПОЛОЖЕНИЯ настраивает только местоположения на основе карты. Вы определяете место и максимальное расстояние в метрах. Устройство использует службы геолокации, чтобы определить, когда пользователь находится достаточно близко. Затем Wallet может показать ваш текст для экрана блокировки для этого местоположения.

PassKit также может связывать пропуск с оборудованием iBeacon в помещении. Эта опция недоступна в конструкторе пропусков. Настройте маячки в PassKit API, когда ваша команда использует передатчики маячков.

Примеры использования

Розничная торговля: карта лояльности или купон появляется, когда клиент находится рядом с вашим магазином. Текст на экране блокировки может сообщать, что он находится рядом с магазином, и напоминать ему использовать пропуск.
Мероприятия: билет на мероприятие появляется, когда пользователь находится рядом с местом проведения (стадион, театр или фестивальная площадка), чтобы он мог быстро найти пропуск на входе.
Путешествия: проездной билет становится заметным рядом с аэропортом или терминалом вылета, чтобы пассажир видел детали выхода на посадку или рейса на экране блокировки, не открывая Wallet.
Гостеприимство: купон или членский пропуск может появиться рядом с кафе или отелем, которые вы определили.

Введите User ID

Введите User ID Pushwoosh для пользователя, который получит этот пропуск. Pushwoosh выдаст пропуск этому пользователю и отобразит его в разделе ПОЛЬЗОВАТЕЛЬ на странице Все пропуски.

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

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

Чтобы проверить пропуск на соответствие спецификациям Apple без его создания, нажмите Проверить пропуск. Конструктор отметит отсутствующие обязательные изображения и другие проблемы.

Сгенерируйте пропуск

Выберите Сгенерировать. Pushwoosh проверит пропуск, обработает изображения и подпишет пакет. Генерация занимает несколько секунд, после чего пропуск появится в вашем списке пропусков.

Информацию о редактировании (включая обновление по серийному номеру), загрузке, совместном использовании и удалении пропусков после генерации см. в разделе Управление существующими пропусками.

Управление пропусками через API

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

Apple Wallet PassKit API