Конструктор пропусков Apple Wallet

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

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

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

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

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

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

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

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

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

Выберите стиль, прежде чем добавлять поля и изображения, потому что при смене стиля все поля пропуска очищаются.

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

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

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

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

Цвета

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

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

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

Примечание

Цвета хранятся в формате rgb(r, g, b).

Изображения

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

Изображение	Размер	Доступно для
Иконка	29×29	Все стили (обязательно)
Логотип	160×50	Все стили (обязательно)
Полоса	375×144	Купон, Билет на мероприятие, Карта магазина
Фон	180×220	Билет на мероприятие
Миниатюра	90×90	Билет на мероприятие, Общий
Нижняя полоса	286×15	Проездной билет

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

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

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

• Поля заголовка (вверху карты): до 3
• Основные поля (главный контент): 1. В проездном билете группа называется Основные поля (откуда/куда) и содержит 2 поля
• Дополнительные поля (вспомогательная информация): до 4
• Вспомогательные поля (доп. детали): до 4, в проездном билете — до 5
• Поля оборота (обратная сторона карты)

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

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

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

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

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

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

Персонализируйте контент пропуска

Чтобы показать данные, уникальные для получателя, например имя или баланс баллов, вставьте в текстовое поле плейсхолдер тега. Кнопка { } доступна для:

• Название карты, Описание и Текст логотипа
• Подпись, Значение и сообщения об изменении поля
• Данные штрихкода, Альт. текст и Идентификатор группировки

Чтобы вставить плейсхолдер:

1. Нажмите { } рядом с текстовым полем.
2. Выберите тег.
3. Выберите Формат. Описание вариантов см. в разделе Персонализация контента карты конструктора Google Wallet, который использует то же диалоговое окно.
4. При необходимости введите значение в поле Значение по умолчанию (если пусто).

Предварительный просмотр в реальном времени показывает значения тегов пользователя, которого вы указали в поле User ID. Без User ID в нем отображаются плейсхолдеры.

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

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

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

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

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

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

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

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

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

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

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

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

Местоположения и маячки

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

Чтобы связать пропуск с оборудованием iBeacon в помещении, используйте раздел АКТУАЛЬНОСТЬ ПО IBEACON ниже.

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

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

Актуальность по iBeacon (необязательно)

В разделе АКТУАЛЬНОСТЬ ПО IBEACON пропуск появляется, когда устройство находится рядом с физическим передатчиком iBeacon, который транслирует подходящий сигнал. Это работает в помещениях, где службы геолокации на основе карты ненадежны.

Чтобы добавить маячок, нажмите Добавить маячок (всего до 10). Чтобы удалить маячок, нажмите × на его карточке.

Для каждого маячка укажите:

• Proximity UUID: идентификатор маячка (например, B9407F30-F5F8-466E-AFF9-25556B57FE6D).
• Major и Minor (необязательно): сужают совпадение до площадки и отдельного маячка. Каждое значение — число от 0 до 65535, значение 0 равносильно пустому. Оставьте оба поля пустыми или укажите в обоих 0, чтобы совпадал любой маячок, транслирующий этот UUID.
• Релевантный текст: текст, отображаемый на экране блокировки, когда пропуск становится актуальным.

Введите User ID

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

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

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

Предварительный просмотр может отличаться на устройстве

Предварительный просмотр является приблизительным. На реальном устройстве пропуск может выглядеть иначе. Отображаемый штрих-код является заполнителем. Настоящий штрих-код генерируется в окончательном файле .pkpass.

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

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

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

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

Чтобы выдать один дизайн многим пользователям и обновлять общие поля сразу на всех выданных пропусках, создайте кампанию Wallet Pass. Кампания использует те же разделы дизайна, что и этот конструктор.

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

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

Apple Wallet PassKit API