Создание кампаний Wallet Pass

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

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

Примечание

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

Что можно делать с кампаниями Wallet Pass

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

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

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

Apple Wallet:

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

Google Wallet:

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

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

Чтобы начать создание кампании, перейдите в Campaigns → Wallet Passes → Campaigns и нажмите Create campaign.

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

• Platform: выберите Apple Wallet или Google Wallet в верхней части страницы. Этот выбор является окончательным для кампании.
• Campaign: введите Name и, при желании, Description для внутреннего использования. Ни то, ни другое не отображается на карте.
• Pass format: в разделе Pass Style (Apple) или Pass Type (Google) выберите макет для вашей карты:
  • Apple Wallet: Boarding Pass, Coupon, Event Ticket, Store Card, Generic. См. Выберите стиль карты.
  • Google Wallet: Generic, Offer, Loyalty card, Event ticket, Gift card, Flight, Transit. Этот параметр нельзя изменить после создания. См. Выберите тип карты.

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

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

• Basic Information, Colors, and Barcode: установите заголовок карты, цвета фона и текста, а также тип штрихкода. Подробные инструкции по каждому разделу см. в Дизайн карт в конструкторе Apple Wallet или Дизайн карт Google Wallet в конструкторе.
• Pass fields: добавьте поля, которые должны отображаться на карте (см. Поля карт Apple Wallet или Поля и детали Google Wallet).
• Expiration: установите соответствующие даты и правила истечения срока действия (см. Срок действия Apple Wallet или Срок действия Google Wallet).
• Locations: установите релевантность на основе местоположения (см. Местоположения Apple Wallet или Местоположения Google Wallet).

Совет

Для Google Wallet используйте Who can save the pass, чтобы контролировать, привязана ли карта к одному аккаунту Google, одному устройству или доступна любому, у кого есть ссылка.

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

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

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

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

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

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

Совет

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

Включите синхронизацию тегов

В разделе Tag sync включите Update pass fields from tags, чтобы Pushwoosh периодически перепроверял плейсхолдеры тегов, используемые в полях кампании, и отправлял свежее значение на любую карту, чей тег изменился.

• Interval (minutes): как часто Pushwoosh перечитывает теги. По умолчанию 60, минимальное значение — 5. Карта обновляется не чаще одного раза за интервал, независимо от того, сколько раз за это время изменился ее тег.
• Notification (только для Google Wallet): выберите, как владелец карты узнает об обновлении: Silently (без уведомления), Own message (заполните Message text, отправляется вместе с обновлением) или Google field notification (собственное оповещение Google об обновлении поля). Google ограничивает их до 3 на карту в сутки. После этого новые значения все равно будут доставлены на карту, но уже без уведомления.

Примечание

В Apple Wallet нет уведомлений на уровне кампании, поэтому этот селектор не отображается для кампаний Apple. Текст уведомления находится в самом поле. Заполните Change message для каждого поля в конструкторе карт Apple Wallet.

Осторожно

Синхронизация тегов работает только пока статус кампании Active. Установите его в Draft или Archived, чтобы приостановить плановые проверки, не выключая переключатель.

Включение синхронизации тегов для кампании, у которой уже есть выпущенные карты, не ожидает окончания первого интервала. Следующая плановая проверка рассматривает кампанию, которая никогда не синхронизировалась, как подлежащую немедленной синхронизации, и в режиме Own message или Google field notification это может уведомить всех владельцев карт одновременно и израсходовать лимит в 3 уведомления в сутки за один раз.

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

1. В разделе Campaign images нажмите Choose an image рядом со слотом для изображения.
2. Выберите существующее изображение из вашего Медиахранилища или перетащите новый файл для загрузки.
3. Повторите для каждого доступного слота для изображений:
   • Apple Wallet: Icon, Logo, Background, Footer, Strip и Thumbnail (см. Изображения Apple Wallet).
   • Google Wallet: Logo и Hero image.

Примечание

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

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

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

Совет

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

2. Нажмите Create campaign внизу страницы.

Pushwoosh создает кампанию в статусе Draft и открывает ее рабочее пространство с вкладками Design, Passes и History.

Примечание

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

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

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

1. На вкладке Passes нажмите Issue pass.
2. Введите User ID получателя в Pushwoosh.

3. Нажмите Issue pass для подтверждения.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

При открытии созданной кампании из Campaigns → Wallet Passes → Campaigns отображается ее статус, счетчик ревизий, предпросмотр карты в реальном времени и три основные вкладки: Design, Passes и History.

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

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

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

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

Вкладка Design

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

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

1. На вкладке Design отредактируйте основную информацию, цвета, тип штрихкода, срок действия, местоположения, общее поле или изображение кампании.
2. Нажмите Save changes.
3. В диалоговом окне Apply the campaign edit подтвердите обновление:
   • Ни одна карта не переопределяет измененное поле: нажмите Update N, keep hand edits, чтобы отправить изменение на все N карт.
   • Некоторые карты переопределяют измененное поле: в диалоговом окне будет указано имя поля и количество карт, которые его переопределяют. Нажмите Update N, keep hand edits, чтобы отправить изменение на все карты, кроме этих, или Overwrite all N, чтобы отправить его на все N карт, включая переопределенные. Перезапись удаляет переопределение.

Какую бы кнопку вы ни нажали, обновление сохраняется как новая ревизия (например, Revision 2), так что вы можете проверить, что и когда изменилось, на вкладке History.

Примечание

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

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

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

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

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

Вкладка Passes

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

Если включена синхронизация тегов, на вкладке также отображается строка Tags synced над таблицей с датой и временем последнего планового запуска, или not yet до первого запуска.

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

• With pinned fields: показывает карты, у которых есть хотя бы одно поле, отредактированное вручную.
• Behind the revision: показывает карты, которые еще не получили последнее обновление кампании.

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

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

• Edit: открыть карту на странице редактирования ее платформы, чтобы изменить персональные поля или переопределить общее.
• Download: в кампаниях Apple Wallet позволяет скачать подписанный файл .pkpass. В кампаниях Google Wallet эта опция не отображается, так как у Google Wallet нет эквивалента загружаемого файла.
• Send message: открыть одноразовый редактор push-уведомлений, чтобы отправить сообщение получателю карты по User ID. Все способы связи с ними см. в Сообщения владельцам карт Wallet.
• QR code: показать QR-код для установки, который пользователи могут отсканировать, чтобы добавить карту и зарегистрировать свое устройство для получения обновлений.
• Copy install link: скопировать URL для установки, чтобы поделиться картой в ваших каналах обмена сообщениями.
• Delete: удалить карту. Это действие нельзя отменить. В Apple Wallet уже установленные копии перестают получать обновления и становятся недействительными при следующем обновлении. В Google Wallet Google не позволяет принудительно удалять карту, уже сохраненную на устройстве, поэтому она становится недействительной и перемещается в Expired passes пользователя, в то время как Pushwoosh удаляет ее запись. Удаление карты здесь не удаляет кампанию или любую другую выпущенную карту.

Вкладка History

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

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

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

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

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

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

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