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

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

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

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

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

В Панели управления перейдите в Campaigns → Wallet Passes, откройте вкладку Google Wallet и нажмите Create pass.

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

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

• Из шаблона: нажмите Load template, выберите встроенную карту в Select Template (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	Заголовок карты*, Шапка*, Подзаголовок, поля карты
Offer	Название*, Поставщик*, Детали, Мелкий шрифт, Канал погашения (в магазине / онлайн / оба), Имя эмитента
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. В поле FORMAT выберите, как отображать значение тега: As is (использовать сохраненное значение), Integer (округлить до целого числа), Price (0.00) (показать два десятичных знака) или Capitalize first letter (сделать первую букву заглавной).
4. В поле FALLBACK при необходимости введите текст, который будет отображаться, если у получателя нет значения для этого тега.
5. Нажмите Insert.

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

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

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

Цвета

Введите шестнадцатеричный код в поле Background color, например, #FFFFFF для белого цвета. Укажите начальный символ # и шесть символов.

Изображения

Нажмите Choose an image рядом с Logo, чтобы выбрать или загрузить файл из Media store приложения. Обязательно для карт лояльности и проездных.

Нажмите Choose an image рядом с Hero image (optional), чтобы добавить широкий баннер, который будет отображаться под деталями карты на ее лицевой стороне. Рекомендуемый размер — 1032×336 пикселей.

Варианты в Media store

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

Удаление изображения в Media store

Если вы удалите изображение в Media store, оно перестанет загружаться на карте. Нажмите Remove рядом со слотом, чтобы отменить выбор.

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

В поле Who can save the 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: текст, отображаемый под штрих-кодом на карте.

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

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

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

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

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

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

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

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

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

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

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

Введите User ID

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

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

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

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

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

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

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

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

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

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

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

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

Google Wallet API