Создание кампаний с Wallet-картами

Кампания с Wallet-картами позволяет создать единый шаблон карты Apple Wallet или Google Wallet, выпустить его для нескольких пользователей и централизованно управлять обновлениями.

Вы выбираете, какие поля являются общими (изменения синхронизируются на всех устройствах пользователей одновременно), а какие — персональными (сохраняются уникальные значения, такие как имена, штрихкоды или балансы для каждого пользователя).

Примечание

Кампания с Wallet-картами не связана с кампаниями Customer Journey или push-уведомлениями. Это инструмент для управления шаблонами карт, их выпуском и обновлениями в реальном времени.

Что можно делать с помощью кампаний с Wallet-картами

• Создавать одну карту в рамках кампании вместо того, чтобы настраивать каждую карту вручную в конструкторе карт Apple Wallet или Google Wallet.
• Выбирать, какие поля обновляются везде (общие), а какие остаются уникальными для каждой карты (персональные).
• Видеть, на скольких выпущенных картах отразится изменение поля, прежде чем сохранить его.
• Переопределять общее поле на одной карте, а затем возвращать управление кампании.
• Прикреплять карты, выпущенные вне кампании, чтобы они начали получать обновления общих полей.
• Отслеживать ревизии кампании и статус доставки каждого обновления.

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

Для кампании требуется та же одноразовая настройка, что и для отдельной карты:

Apple Wallet:

• Активное членство в Apple Developer Program
• Платформа iOS подключена к приложению
• Сертификат для подписи карт загружен в Pushwoosh

Google Wallet:

• Активный аккаунт эмитента в Google Pay & Wallet Console
• Google Wallet настроен для приложения (ID эмитента и ключ сервисного аккаунта Google Cloud)

Создание кампании

Чтобы начать создание кампании, перейдите в Кампании → Wallet-карты → Кампании и нажмите Создать кампанию.

Укажите детали кампании и платформу

• Платформа: выберите Apple Wallet или Google Wallet в верхней части страницы. Этот выбор является окончательным для кампании.
• Кампания: введите Название и необязательное Описание для внутреннего использования. Ни то, ни другое не отображается на карте.
• Формат карты: в разделе Стиль карты (Apple) или Тип карты (Google) выберите макет для вашей карты:
  • Apple Wallet: Посадочный талон, Купон, Билет на мероприятие, Карта магазина, Общая. См. Выберите стиль карты.
  • Google Wallet: Общая, Предложение, Карта лояльности, Билет на мероприятие, Подарочная карта, Авиабилет, Проездной. Этот параметр нельзя изменить после создания. См. Выберите тип карты.

Настройте дизайн и брендинг карты

Настройте стандартные разделы карты:

• Основная информация, Цвета и Штрихкод: установите заголовок карты, цвета фона и текста, а также тип штрихкода. Подробные инструкции по каждому разделу см. в статьях Создание карт в конструкторе Apple Wallet или Создание карт Google Wallet в конструкторе.
• Поля карты: добавьте поля, которые должны отображаться на карте (см. Поля карт Apple Wallet или Поля и детали Google Wallet).
• Срок действия: установите релевантные даты и правила истечения срока действия (см. Срок действия Apple Wallet или Срок действия Google Wallet).
• Местоположения: установите релевантность на основе местоположения (см. Местоположения Apple Wallet или Местоположения Google Wallet).

Совет

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

Установите общие и персональные поля

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

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

Тип поля	Поведение	Примеры
Общее	Управляется кампанией. Обновление этого поля синхронизирует новое значение на всех картах на устройствах пользователей.	Дата мероприятия, Номер выхода на посадку, Адрес магазина, Процент скидки
Персональное	Уникально для каждого пользователя. Кампания не перезаписывает эти значения при обновлении.	Имя пользователя, Номер места, ID участника, Баланс баллов

Значение персонального поля может включать плейсхолдер тега, {tag} или {tag|format|fallback} (например, {Seat}). Pushwoosh заполняет его из тега получателя при выдаче карты. Если у получателя нет значения для этого тега, Pushwoosh использует резервное значение из плейсхолдера или оставляет поле пустым, если в плейсхолдере его нет.

• Только тег, без дополнительного текста, например {Seat}: поле не отображается в диалоговом окне Выпустить карту.
• Тег в сочетании с другим текстом, например Место {Seat}, или без тега: поле отображается как редактируемое поле ввода в диалоговом окне Выпустить карту, предварительно заполненное этим значением. Любой тег внутри него все равно будет разрешаться для каждого получателя, когда Pushwoosh выдает карту.

Совет

Штрихкод карты настраивается и персонализируется в разделе Штрихкод. Подробности см. в статьях Штрихкод Apple Wallet или Штрихкод Google Wallet.

Загрузите изображения для кампании

1. В разделе Изображения кампании нажмите Выбрать изображение рядом со слотом для изображения.
2. Выберите существующее изображение из вашего Медиахранилища или перетащите новый файл для загрузки.
3. Повторите для каждого доступного слота для изображения:
   • Apple Wallet: Иконка, Логотип, Фон, Нижний колонтитул, Полоса и Миниатюра (см. Изображения Apple Wallet).
   • Google Wallet: Логотип и Основное изображение.

Примечание

• Изображения должны быть меньше 10 МБ и 25 мегапикселей.
• Apple Wallet: в отличие от отдельной карты, где изображения блокируются после создания, обновление изображения в кампании доставляется на каждую выпущенную карту.
• Google Wallet: отдельная карта уже позволяет изменять логотип и основное изображение в любое время через Редактировать. Изображение в кампании работает так же, за исключением того, что одно редактирование доставляется на все выпущенные карты сразу, а не только на одну.

Предпросмотр и создание кампании

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

Совет

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

2. Нажмите Создать кампанию внизу страницы.

Pushwoosh создает кампанию в статусе Черновик и открывает ее рабочее пространство с вкладками Дизайн, Карты и История.

Примечание

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

Выпуск карт для пользователей

Выпуск карты из кампании

1. На вкладке Карты нажмите Выпустить карту.
2. Введите User ID получателя в Pushwoosh.

3. Нажмите Выпустить карту для подтверждения.

В зависимости от того, как вы настроили Персональные поля, модальное окно обрабатывает их следующим образом:

• Редактируемые поля: отображаются со значениями по умолчанию, которые вы можете изменить для этого пользователя.
• Плейсхолдеры тегов (например, {Seat}): не отображаются в диалоговом окне. Pushwoosh автоматически заполняет их из тегов пользователя.

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

Pushwoosh генерирует карту на основе текущего дизайна кампании и отображает ее на вкладке Карты и в таблице Все карты приложения (Apple Wallet или Google Wallet).

Доставка карты получателю

При выпуске карты создается запись о карте в Pushwoosh. Чтобы доставить ее на устройство пользователя, поделитесь ссылкой для установки:

1. Откройте меню действий карты на вкладке Карты или в разделе Все карты.
2. Выберите Копировать ссылку для установки или QR-код. Для карт Apple Wallet также доступна опция Скачать для подписанного файла .pkpass.
3. Отправьте ссылку или файл получателю через push, email, SMS или Customer Journey. Чтобы выпустить карту и автоматически доставить ссылку на нее по мере продвижения путешественников по Journey, используйте элемент Выпустить Wallet-карту вместо того, чтобы выпускать ее здесь.

Дополнительные способы распространения карт см. в статьях Поделиться картами Apple Wallet или Поделиться картами Google Wallet.

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

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

1. На вкладке Карты нажмите Прикрепить карты.
2. Найдите карты по User ID, серийному номеру или штрихкоду.
3. Выберите карты и подтвердите.

После прикрепления:

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

Прикрепление карт через API

Вы также можете прикреплять карты программно с помощью метода API AttachPasses (до 500 серийных номеров за запрос).

Если карту невозможно прикрепить, API вернет конкретную причину для этого серийного номера:

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

Управление существующей кампанией

При открытии созданной кампании из Кампании → Wallet-карты → Кампании отображается ее статус, счетчик ревизий, предпросмотр карты в реальном времени и три основные вкладки: Дизайн, Карты и История.

Изменение статуса кампании

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

Чтобы изменить статус, выберите опцию из выпадающего списка Статус в заголовке кампании. Изменение сохраняется немедленно без отдельного шага подтверждения:

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

Вкладка «Дизайн»

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

Обновление дизайна и отправка изменений на карты

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

• Основная информация, цвета или тип штрихкода
• Срок действия или местоположения
• Общее поле
• Изображение кампании

Подтвердите обновление:

• Если у карт нет переопределений: нажмите Обновить, чтобы отправить изменения на все выпущенные карты.
• Если у некоторых карт есть переопределения: выберите, обновлять ли только стандартные карты (сохраняя переопределения пользователей) или перезаписать все карты.

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

Примечание

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

Переопределение общего поля на отдельной карте

Если вам нужно настроить общее поле для конкретного пользователя, отредактируйте это поле непосредственно на его индивидуальной карте (с вкладки Карты или Все карты):

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

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

Вкладка «Карты»

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

Используйте фильтры таблицы для поиска конкретных карт:

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

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

Откройте меню действий строки (⋮), чтобы управлять этой картой:

• Редактировать: открыть карту на странице редактирования ее платформы, чтобы изменить персональные поля или переопределить общее.
• Скачать: в кампаниях Apple Wallet скачать подписанный файл .pkpass. В кампаниях Google Wallet эта опция не отображается, так как у Google Wallet нет эквивалента скачиваемого файла.
• Отправить сообщение: открыть редактор одноразового push-уведомления, чтобы отправить сообщение получателю карты по User ID. См. Сообщения для владельцев Wallet-карт для всех способов связи с ними.
• QR-код: показать QR-код для установки, который пользователи могут отсканировать, чтобы добавить карту и зарегистрировать свое устройство для получения обновлений.
• Копировать ссылку для установки: скопировать URL для установки, чтобы поделиться картой в ваших каналах обмена сообщениями.
• Удалить: удалить карту. Это действие нельзя отменить. В Apple Wallet уже установленные копии перестают получать обновления и становятся недействительными при следующем обновлении. В Google Wallet Google не позволяет принудительно удалять карту, уже сохраненную на устройстве, поэтому она становится недействительной и перемещается в раздел Просроченные карты пользователя, в то время как Pushwoosh удаляет ее запись. Удаление карты здесь не удаляет кампанию или любую другую выпущенную карту.

Вкладка «История»

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

Статус доставки последнего обновления отображается под вкладками:

• Отменить: останавливает отправку обновления на карты, до которых оно еще не дошло. Эти карты остаются на предыдущей ревизии.
• Повторить неудачные: повторная попытка доставки для карт, которые не удалось обновить (помечаются как неудачные после 5 попыток).

После сохранения новой ревизии старые обновления больше нельзя повторить или отменить.

Удаление кампании

Откройте кампанию и нажмите Удалить кампанию в правом верхнем углу страницы.

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