Конструктор карт Google Wallet

Конструктор карт Google Wallet — это визуальный редактор в Панели управления. Вы выбираете тип карты, заполняете данные для брендинга, поля и штрих-код, наблюдаете за предварительным просмотром в реальном времени и создаете карту. Когда вы генерируете карту, Pushwoosh создает объект карты в Google Wallet и возвращает ссылку для сохранения «Добавить в Google Wallet».

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

Сначала требуется настройка

Конструктор доступен только после того, как для приложения настроен Google Wallet (указан Issuer ID, а сервисный аккаунт Pushwoosh приглашен в ваш аккаунт эмитента). Если он еще не настроен, сначала выполните настройку: Настройка карт Google Wallet для Android.

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

Настройка карты

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

• Из шаблона: нажмите Загрузить шаблон, выберите встроенную карту в Выберите шаблон (generic, offer, loyalty, event ticket, gift card, flight или transit). Шаблон применяется сразу после нажатия на него. Форма предварительно заполнит тип карты, поля, цвета и штрих-код и установит логотип-заглушку. Замените его своим логотипом до генерации карты, иначе заглушка попадет на карту. При необходимости отредактируйте любое значение или измените тип.

Выберите тип карты

В разделе PASS TYPE выберите один из семи типов карт Google Wallet. Тип определяет макет карты и доступные поля. Типизированные карты используют нативный макет Google. Карта типа generic имеет свободную форму. Тип нельзя изменить после создания карты.

• Generic: карта свободной формы с вашими собственными полями.
• Offer: купоны и скидки.
• Loyalty card: карты лояльности и членские карты.
• Event ticket: билеты на мероприятия.
• Gift card: подарочные и предоплаченные карты.
• Flight: посадочные талоны.
• Transit: билеты на поезд, автобус, трамвай и паром.

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

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

Тип карты	Ключевые поля
Generic	Заголовок карты*, Шапка*, Подзаголовок, до 6 полей на карте
Offer	Название*, Поставщик*, Детали, Мелкий шрифт, Канал погашения (BOTH, INSTORE, ONLINE или TEMPORARY_PRICE_REDUCTION), Имя эмитента
Loyalty	Название программы*, Имя участника, ID участника, Баланс баллов, Метка баллов, Уровень вознаграждений, Метка уровня, Имя эмитента
Event ticket	Название мероприятия*, Место проведения, Адрес, Начало, Окончание, Владелец билета, Номер билета, Тип билета, Секция, Ряд, Место, Выход
Gift card	Продавец*, Номер карты*, PIN-код, Баланс + валюта
Flight	Авиакомпания (код IATA), Номер рейса, Откуда*, Куда*, Отправление*, Имя пассажира*, Время посадки, Место, Класс, Группа посадки, Код подтверждения
Transit	Тип* (автобус / поезд / трамвай / паром / другой), Оператор* (если не задано Название эмитента), Пассажир*, Тип поездки, отрезки пути (пункт отправления*, пункт назначения*, время, платформа, вагон, место), Название эмитента

* Обязательно для Google.

Даты и время

Большинство типов карт используют формат ISO 8601 со смещением UTC (например, 2026-07-01T19:30:00+02:00). Карты типа Flight являются исключением: Google требует указывать время вылета, посадки и прибытия в местном времени аэропорта без смещения (например, 2026-09-01T06:30:00).

Персонализация контента карты

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

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

1. Рядом с поддерживаемым текстовым полем (например, Merchant, Card title или Header) нажмите {} чтобы вставить тег.
2. В поле TAG выберите тег, который нужно вставить в поле.
3. В поле ФОРМАТ выберите, как отображать значение тега: Как есть (использовать сохраненное значение), Целое число (округлить до целого числа), Цена (0.00) (показать два десятичных знака), Первая буква заглавная, Дата (5 Aug 1980), Дата и время (5 Aug 1980 14:30) или Время (14:30).
4. В поле Значение по умолчанию (если пусто) при необходимости введите текст, который будет отображаться, если у получателя нет значения для этого тега.
5. Нажмите Insert.

Pushwoosh заполняет значения тегов при создании карты и обновляет их при каждом обновлении.

Настройка внешнего вида

В разделе APPEARANCE настройте цвета, изображения, кто может сохранять карту и срок ее действия.

Цвета

Нажмите Цвет фона и выберите цвет в палитре.

Изображения

Нажмите Выбрать картинку рядом с Логотип, чтобы выбрать изображение из Медиахранилища приложения, загрузить новое или получить его из стоковых фото или с помощью AI-генерации. Можно выбрать файлы PNG и JPEG. Логотип обязателен для карт лояльности и проездных.

При необходимости нажмите Выбрать картинку рядом с Hero-изображение, чтобы добавить широкий баннер, который будет отображаться под деталями карты на ее лицевой стороне. Рекомендуемый размер — 1032×336 пикселей.

Если в Медиахранилище приложения есть кроп, уже подогнанный по размеру для данного размещения, выберите этот кроп.

Удаление изображения в Медиахранилище

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

Кто может сохранить карту

В поле Кто может сохранить карту выберите, кто может добавлять карту в Google Wallet. Эту настройку нельзя изменить после создания карты.

• Один пользователь, все его устройства (по умолчанию): карта привязывается к одному аккаунту Google и синхронизируется на всех устройствах этого аккаунта.
• Один пользователь, одно устройство: карта сохраняется только на одном устройстве.
• Любой, у кого есть ссылка: каждый аккаунт Google, открывший ссылку для сохранения, получает один и тот же общий объект карты. Когда вы обновляете карту, Google автоматически доставляет изменения всем владельцам.

Любой, у кого есть ссылка

Используйте этот вариант для карт, где все владельцы видят одинаковый контент, например, предложение для всего магазина или билет на публичное мероприятие без назначенного места. Избегайте его для карт лояльности, подарочных карт или любых карт, где контент должен быть персонализирован для каждого пользователя. Pushwoosh отслеживает только одно устройство для общего объекта, поэтому отдельные владельцы не видны и не могут быть таргетированы отдельно.

Срок действия

Установите Expiration date, когда Google должен аннулировать карту, или оставьте поле пустым, чтобы карта была бессрочной.

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

В разделе BARCODE выберите формат и введите значение для кодирования:

1. Format: выберите, как выглядит штрих-код и какой тип сканера может его прочитать.
   • QR_CODE: квадратный код, который легко считывается большинством телефонов и сканеров. Лучше всего подходит для большинства карт.
   • PDF_417: широкий штрих-код, состоящий из нескольких рядов линий. Часто требуется для посадочных талонов.
   • AZTEC: компактный квадратный код, похожий на QR. Распространен на билетах на мероприятия и проездных.
   • CODE_128 / EAN_13: одномерные штрих-коды. Выбирайте их, только если это требуется вашим сканером или POS-системой.
2. Value: данные, закодированные в штрих-коде (например, номер билета или членский номер). Чтобы использовать уникальное значение для каждого пользователя, нажмите {} рядом с полем и вставьте плейсхолдер тега.
3. Alt Text: текст, отображаемый под штрих-кодом на карте.

Добавьте поля с деталями и ссылки

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

• Поля в деталях: дополнительный текст на обратной стороне карты. Нажмите + Добавить поле и укажите Подпись и Значение. Используйте их для условий, инструкций или другой информации, которая не помещается на лицевой стороне.
• Ссылки: кликабельные ссылки на обратной стороне карты. Нажмите + Добавить ссылку, затем укажите URL и короткую Подпись ссылки (например, «Поиск магазинов» или «Условия и положения»).

Добавьте ссылку на приложение (необязательно)

В разделе APP LINK добавьте на лицевую сторону карты кнопку, которая при нажатии открывает веб-страницу или ваше Android-приложение. Вы можете указать URL, имя пакета Android или и то, и другое.

Если вы укажете только URL, кнопка будет открывать этот веб-адрес на любом устройстве. Если вы укажете только имя пакета, кнопка будет работать на устройствах Android, на которых установлено приложение, без возможности перехода на веб-страницу. URL должен начинаться с https://.

После создания карты ссылку на приложение можно изменить, но нельзя удалить.

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

В разделе Location-based relevance добавьте точки интереса. Google показывает уведомление с геозоной, когда пользователь находится рядом с добавленным вами местоположением. Например, покажите карту лояльности рядом с вашим магазином, билет на мероприятие рядом с местом его проведения или посадочный талон рядом с аэропортом.

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

Местоположения в Google Wallet

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

Введите User ID

Введите User ID Pushwoosh для человека, который получит эту карту.

Pushwoosh выпускает карту для этого пользователя и отображает ее в разделе USER на странице All passes.

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

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

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

Предварительный просмотр является приблизительным. Типизированные карты используют нативный макет Google, поэтому на реальном устройстве карта может выглядеть иначе. QR-код в предварительном просмотре кодирует реальное значение, а другие форматы штрих-кодов отображаются в виде плейсхолдеров.

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

Сгенерируйте карту

Нажмите Generate. Pushwoosh проверяет карту и создает ее в Google Wallet. Вы получаете ссылку для сохранения Add to Google Wallet, которой можно поделиться с пользователями. В течение нескольких секунд карта появится в разделе All passes.

Информацию о редактировании, получении ссылки для сохранения, аннулировании и удалении карт после их создания см. в разделе Управление существующими картами. О том, как отправить карту пользователям, см. Распространение карт Wallet.

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

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

Все, что делает конструктор карт, также доступно через Google Wallet API: создание, обновление, получение списка, получение ссылки для сохранения, установка состояния и удаление карт.

Google Wallet API