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

Карты Google Wallet — это цифровые карты, такие как карты лояльности, специальные предложения, подарочные карты, билеты на мероприятия, посадочные талоны и проездные билеты, которые пользователи хранят в приложении Google Wallet.

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

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

* Создавать дизайн карт в [конструкторе карт](/ru/product/messaging-channels/google-wallet-passes/pass-builder/)
* Делиться с пользователями ссылкой для сохранения или QR-кодом
* Обновлять карты в любое время. Google синхронизирует изменения на каждом устройстве, где сохранена карта
* [Отправлять сообщения держателям карт](/ru/product/messaging-channels/google-wallet-passes/message-pass-holders/) с помощью разового push-уведомления, уведомления об обновлении карты или Customer Journey

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

* Аккаунт эмитента в [Google Pay & Wallet Console](https://pay.google.com/business/console)
* Проект Google Cloud с ключом сервисного аккаунта

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

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

<Steps>

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

   Попросите вашу команду разработчиков подключить Google Wallet к вашему приложению в Pushwoosh.

   [Как настроить Google Wallet](/ru/developer/first-steps/connect-messaging-services/android-configuration/android-google-wallet-configuration/)

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

   Откройте конструктор карт в **Кампании → Wallet Passes**, выберите тип карты, добавьте свой брендинг и поля и проверьте предварительный просмотр в реальном времени.

   [Создание дизайна карт Google Wallet в конструкторе карт](/ru/product/messaging-channels/google-wallet-passes/pass-builder/)

3. **Создайте карту**

   Когда карта будет выглядеть так, как нужно, нажмите **Generate** в [конструкторе карт](/ru/product/messaging-channels/google-wallet-passes/pass-builder/#generate-the-pass).

4. **Отправьте карту пользователям**

   Поделитесь ссылкой для сохранения или QR-кодом из раздела **All passes**. См. [Поделиться картой с пользователями через каналы Pushwoosh](#share-the-pass-with-users-via-pushwoosh-channels). Чтобы массово отправлять карты каждому пользователю, ваша команда разработчиков может использовать [Google Wallet API](/ru/developer/api-reference/google-wallet-api/).

5. **Обновите карту**

   В разделе [**All passes**](#view-and-manage-existing-passes) нажмите **Edit** на карте или обновите ее через [Google Wallet API](/ru/developer/api-reference/google-wallet-api/). Когда вы сохраните изменения, Google доставит обновление на каждое устройство, где сохранена карта. Пользователям не нужно сохранять ее снова.

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

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

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

</Steps>

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

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

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

* **Edit:** изменить значения и метки полей, цвета, URL-адреса логотипа и основного изображения, штрих-код, ссылки, местоположения и срок действия. Тип карты блокируется после создания. Когда вы сохраните изменения, каждое устройство, где сохранена карта, получит обновление.

<Aside type="note" title="Обновления карт и уведомления">
Когда вы сохраняете изменения, карта обновляется на каждом устройстве, где она сохранена. Если включена опция **Notify about changed fields** (включена по умолчанию), Google также отправляет Android-уведомление держателям.

Уведомления поддерживаются для карт **лояльности**, **билетов на мероприятия** и **авиабилетов**. Google генерирует текст уведомления автоматически на основе измененных полей. Для билетов на мероприятия и авиабилетов уведомления срабатывают только в том случае, если до времени начала остается менее 3 часов, и Google ограничивает их до 3 на карту в сутки.

Чтобы отправить собственное сообщение держателям карт, см. [Отправка сообщений держателям карт Google Wallet](/ru/product/messaging-channels/google-wallet-passes/message-pass-holders/).
</Aside>

* **Send message:** открыть редактор разовых push-уведомлений для отправки сообщений держателям карт. См. [Отправка сообщений держателям карт Google Wallet](/ru/product/messaging-channels/google-wallet-passes/message-pass-holders/), чтобы узнать обо всех способах связи с ними.
* **QR code:** показать QR-код, который кодирует ссылку для сохранения карты. Пользователи сканируют его, чтобы сохранить карту в Google Wallet и зарегистрировать свое устройство для получения обновлений.
* **Copy install link:** скопировать ссылку для сохранения карты, чтобы поделиться ею в своих каналах обмена сообщениями. [Узнать больше](#share-the-pass-with-users-via-pushwoosh-channels).
* **Invalidate:** сделать активную карту неактивной. Карта перемещается в раздел **Expired passes** пользователя в Google Wallet. Запись остается в Pushwoosh.
* **Activate:** снова сделать неактивную карту активной. Эта опция появляется в меню действий, только когда карта неактивна. Восстанавливает карту в Google Wallet.
* **Delete:** аннулировать карту в Google и удалить ее запись в Pushwoosh. Google не позволяет принудительно удалять карту, уже сохраненную на устройстве. Она становится недействительной и перемещается в **Expired passes**.


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

Ссылка **Добавить в Google Wallet** — это обычный URL-адрес (`https://pay.google.com/gp/v/save/...`). При открытии на устройстве пользователю предлагается сохранить карту в Google Wallet. Вы можете использовать эту ссылку в тех же каналах Pushwoosh, которые вы уже используете для связи со своей аудиторией:

* **Email:** добавьте ссылку на кнопку или текстовую ссылку в [редакторе email](/ru/product/content/email-content/drag-and-drop-email-editor/), например, призыв к действию «Добавить в Google 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).

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

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

<LinkCard title="Google Wallet API" href="/developer/api-reference/google-wallet-api/" />

## Просмотр держателей карт в User Explorer

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

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

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

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

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