Чтобы обновить Wallet-карту, её редактируют в инструменте для карт или через API. Дальше платформа сама перерисовывает карту на каждом устройстве, где она сохранена, переустанавливать ничего не нужно. В Apple Wallet клиент увидит уведомление на экране блокировки только для полей с сообщением об изменении. В Google Wallet собственное уведомление Google приходит только для карт лояльности, билетов на мероприятия и посадочных талонов.
Это практическая сторона обновлений. Как они устроены внутри, читайте в статье как работают обновления wallet-карт. Примеры сделаны в Pushwoosh Wallet passes: каждая карта привязана к User ID, а обновить её можно из конструктора, из кампании или через API. Если ваша аудитория живёт в нескольких странах и пользуется и iPhone, и Android, это 1 процесс обновления для обеих платформ и всех рынков.
Что можно изменить
Почти всё. В картах Apple Wallet в Pushwoosh можно править название и описание карты, значения и подписи полей, сообщения об изменении, цвета, текст штрихкода, срок действия и статус, локации и маячки. Изображения менять нельзя. В картах Google можно вдобавок заменить логотип и главное изображение, штрихкод, ссылки и ссылку на приложение.
Неизменным остаётся 1: стиль или тип карты. Карта магазина не станет купоном, а карта лояльности Google не станет предложением. Если нужен другой формат, выпустите новую карту.
| Что меняется | Пример | Что видит клиент |
|---|---|---|
| Значение поля | Баллы со 120 до 180 | Карта перерисовывается, плюс уведомление, если задано сообщение об изменении |
| Дата или время | Мероприятие перенесли на 20:00 | Карта перерисовывается, плюс уведомление, если задано сообщение об изменении |
| Выход, место, платформа | Выход B12 сменился на B20 | Карта перерисовывается, плюс уведомление, если задано сообщение об изменении |
| Цвета (на Google ещё и изображения) | Сезонный дизайн | Карта перерисовывается, без уведомления |
| Локации | Открылся новый магазин | Меняется релевантность на экране блокировки, без уведомления |
| Срок действия или аннулирование | Членство закончилось | Карта становится серой или уходит в истёкшие |
Если клиенты живут в разных часовых поясах, при переносе мероприятия проверьте, что новое время на карте указано так, как его поймёт гость на месте.
1 карта или все карты сразу
Каждая карта в Pushwoosh принадлежит 1 User ID. Отсюда 2 способа обновления.
По 1 карте — это повседневный случай: покупка меняет баланс 1 клиента, значит, меняется его карта. Почти всегда это автоматизируют через API или синхронизацию тегов, а не делают вручную.
Массовый случай — вся программа: новые условия или сезонный дизайн для всех владельцев карт, например к Black Friday в e-commerce. В Pushwoosh это делается через Wallet Pass Campaign (кампанию Wallet-карт). Поля, отмеченные как общие (shared), обновляются на всех картах кампании, персональные поля сохраняют значения каждого клиента, а кампания до сохранения показывает, сколько карт затронет правка.
В картах Google Wallet поля могут содержать пользовательские теги. Pushwoosh подставляет значения тегов при создании карты и обновляет их при каждом обновлении, поэтому карта показывает то, что сейчас записано в профиле. В кампании синхронизация тегов делает это на обеих платформах без правки: когда тег за полем меняется, карта получает новое значение при следующей проверке, по умолчанию раз в 60 минут.
Сообщения об изменении: кого стоит отвлекать
Не каждое обновление должно отвлекать клиента. Какие отвлекают, решаете вы.
В Apple Wallet вы добавляете к полю сообщение об изменении (change message), например «Ваш выход теперь %@». Когда поле меняется, iOS показывает это сообщение на экране блокировки. Поля без такого сообщения обновляются молча.
В Google Wallet от типа карты зависит, пришлёт ли Google собственное уведомление об изменённых полях: оно бывает только у карт лояльности, билетов на мероприятия и посадочных талонов, а текст пишет Google. Для билетов и рейсов оно срабатывает, только когда до начала остаётся меньше 3 часов. Для любого типа вместо этого можно приложить к обновлению своё уведомление через API или кампанию. Google разрешает не больше 3 уведомлений на карту за 24 часа, сверх этого карта обновляется молча.
Наше правило: уведомляйте об изменениях, на которые клиент должен отреагировать, — новый выход, перенесённое время, баллы, которые скоро сгорят. В FinTech-приложении это может быть, например, смена статуса карты. Редизайн или новая локация магазина в уведомлении не нуждаются.
Сообщения об изменении — не маркетинговый канал
Соблазнительно протолкнуть распродажу через изменение поля. Не делайте этого. Apple и Google разрешают только уведомления, связанные с картой, — о балансе, статусе или расписании, и нарушение этого правила быстрее всего приводит к тому, что карту удаляют.
Для промо связывайтесь с теми же клиентами через push в приложении, email или SMS: каждая карта привязана к User ID, так что её владелец уже есть в вашей аудитории. Когда владельцам нужно узнать о самой карте, например о готовой награде, варианты описаны в документации о сообщениях владельцам карт.
Обновление через API
Когда изменение приходит из ваших систем — кассы (POS), системы бронирования или учёта баллов, — используйте API вместо конструктора. Схема одинакова на обеих платформах: найдите карту, отправьте новые значения, дайте платформе синхронизировать их.
Методы и параметры описаны в справочниках Apple Wallet PassKit API и Google Wallet API.
Срок действия, аннулирование и восстановление
У карты есть жизненный цикл, и аккуратно завершить его так же важно, как начать. Устаревшая карта в Wallet клиента хуже, чем никакой.
В Apple Wallet задайте дату истечения, и после неё карта станет серой. Можно также пометить карту как аннулированную (voided), например после того, как купон использован. В Google Wallet аннулирование переносит карту в раздел истёкших карт клиента, а позже её можно снова активировать. Удаление карты Google аннулирует её в Google и удаляет её запись в Pushwoosh.
Когда обновление не доходит
Большинство случаев сводится к 4 причинам.
Истёк сертификат Apple. Карты Apple подписываются вашим сертификатом Pass Type ID, и после его истечения карты нельзя ни подписать, ни обновить. Запишите дату продления в календарь в тот же день, когда загружаете сертификат.
Клиент удалил карту. Обновления доходят только до устройств, где она ещё сохранена.
Обновление пришло, но без уведомления. В Apple Wallet проверьте, есть ли у поля сообщение об изменении. В Google Wallet проверьте тип карты, чекбокс Notify about changed fields и дневной лимит.
Клиент так и не добавил карту. Выпущенная, но не сохранённая карта обновлений не получает. Отправьте ссылку на установку ещё раз.
Проверяйте обновления на iPhone и на Android: у Apple и Google разные правила уведомлений, а у международной аудитории обе платформы обычно представлены почти поровну.
Поддерживайте каждую карту актуальной с Pushwoosh
Pushwoosh обновляет нативные карты Apple Wallet и Google Wallet из конструктора, кампании или через API, а каждая карта привязана к тому же User ID, что и ваши push, email и SMS. Меняйте 1 баланс или всю программу и выбирайте, какие изменения заслуживают уведомления. Платформа сертифицирована по SOC 2 Type 2 и ISO 27001:2022, соответствует GDPR, а дата-центры расположены в ЕС и США.
Держать клиентов в курсе — не значит отправлять больше. Это значит, что карта в их Wallet всегда показывает правду.
