OneTrace.pro Справка

Карты Wallet

Карта лояльности в Apple Wallet и Google Wallet всегда лежит в телефоне покупателя: на ней баланс баллов, уровень, действующий промокод и штрихкод для кассы. OneTrace.pro обновляет карту сам — после заказа, начисления или выдачи промокода покупатель видит новые значения, а Apple Wallet показывает уведомление. Карта — ещё и канал сообщений: короткое сообщение приходит уведомлением и остаётся на обороте карты.

Карты Wallet доступны с тарифа «Рост» (тарифы). Раздел находится в меню Коммуникации → Карты Wallet. Статистику и оформление видят «Менеджер», «Наблюдатель» и выше, менять оформление могут роли с правом управлять интеграциями — «Администратор» и «Владелец».

Подключение

Карты выпускает ваш магазин — от своего имени и своими ключами Apple и Google. Подключите одну или обе платформы:

  1. Откройте Интеграции и нажмите Добавить интеграцию → Карты Wallet (интеграции).
  2. Для Apple Wallet:
    • в Apple Developer откройте Certificates, Identifiers & Profiles → Identifiers и зарегистрируйте Pass Type ID, например pass.com.example.loyalty;
    • создайте для него сертификат Pass Type ID Certificate, установите его на Mac и экспортируйте из «Связки ключей» вместе с закрытым ключом в файл .p12;
    • вставьте в поле Сертификат Pass Type ID содержимое .p12 в base64 или сертификат и ключ в PEM, а в поле Пароль ключа — пароль экспорта. Промежуточный сертификат Apple WWDR OneTrace.pro добавит сам.
  3. Для Google Wallet:
    • в Google Pay & Wallet Console создайте эмитента и скопируйте Issuer ID;
    • в Google Cloud включите Google Wallet API, создайте сервисный аккаунт и JSON-ключ к нему;
    • добавьте email сервисного аккаунта в Google Pay & Wallet Console как пользователя эмитента;
    • вставьте Issuer ID и JSON-ключ в интеграцию.
  4. Нажмите Сохранить и Проверить: для Apple проверка покажет Pass Type ID, команду и срок сертификата, для Google — что класс карты создан.

Пока Google не одобрил вашего эмитента для публикации, карту Google могут сохранить только тестовые пользователи, добавленные в консоли. Сертификат Apple выдаётся на год: перед окончанием срока выпустите новый и замените его в интеграции, иначе карты перестанут обновляться.

Оформление карты

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

Поле Что задаёт
Название на карте Магазин, который выпускает карту. Если пусто — название интеграции
Фон, текст, подписи Цвета карты. Google Wallet использует только цвет фона, цвет текста подбирает сам
Логотип Apple: слева вверху вместо названия. Загрузите от 480×150 пикселей
Полоса Apple: широкая картинка под логотипом, за баллами; Google: шапка карты. Около 1125×369 пикселей
Значок Квадрат от 660×660 пикселей: значок уведомлений Apple и логотип программы в Google Wallet
Штрихкод QR-код, Code 128, PDF417 или Aztec — какой читает сканер на кассе. В штрихкоде — номер карты
Свои поля До 4 полей: подпись на карте и трейт профиля, например «Город» — city. Если у профиля трейта нет, поля нет и на его карте

Изображения выбираются из медиатеки — для этого нужен доступ к шаблонам сообщений. Изображение, которое использует карта, из медиатеки удалить нельзя. Справа — Предпросмотр с образцом данных; переключатель показывает, как карта выглядит в Apple Wallet и в Google Wallet. Предпросмотр примерный: точный вид зависит от телефона.

Нажмите Сохранить. Карты, которые покупатели уже установили, обновятся в течение нескольких минут.

Оформление карты с предпросмотром Apple Wallet

Предпросмотр карты в Google Wallet

Что на карте

  • Баллы и уровень — из счёта покупателя в программе лояльности.
  • Имя — из трейтов first_name и last_name.
  • Промокод — последний персональный промокод, выданный покупателю и ещё не использованный.
  • Номер карты и штрихкод. Если у профиля уже есть номер карты лояльности (идентификатор loyalty_card, например из офлайн-чеков), на карте Wallet — он же, иначе OneTrace.pro выпускает новый 13-значный номер.
  • Свои поля из оформления и последнее сообщение — на обороте карты.

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

Карту выпускает персональная ссылка — страница на домене вашего бренда с кнопками Добавить в Apple Wallet и Добавить в Google Wallet. Первой показывается кнопка платформы, с которой открыта страница. Ссылка действует 90 дней, страница — на языке профиля.

  • В письмах и других сообщениях — переменная {{ wallet_url }} (шаблоны), например в приветственной цепочке программы лояльности.
  • В центре подписок — ссылка Карта лояльности в Wallet.
  • В личном кабинете магазина — запрос GET /api/v1/profiles/{type}/{value}/wallet с секретным ключом и правом «Чтение профилей» (ключи API): ссылка, её срок, платформы и карты профиля.

Ссылка появляется, когда в проекте есть включённая интеграция «Карты Wallet» с сертификатом Apple или ключом Google.

Сообщения на карту

Канал Карты Wallet работает в шаблонах, цепочках и рассылках, как другие каналы, — с A/B-вариантами и статусами доставки. В шаблоне — Заголовок (подпись поля на обороте), Текст и необязательная Ссылка; в них работают переменные.

  • Apple Wallet показывает текст уведомлением и оставляет его на обороте карты до следующего сообщения. Сообщение доставлено, когда телефон забрал обновлённую карту.
  • Google Wallet добавляет сообщение к карте с уведомлением. Google показывает не больше 3 уведомлений в сутки на одну карту.

Сообщение получают только покупатели с установленной картой этой интеграции. Если карты нет, отправка завершается ошибкой «У профиля нет установленной карты Wallet» — используйте условие или сегмент, чтобы писать в Wallet только тем, у кого карта есть.

Статистика

Блок Статистика карт показывает по каждой платформе:

  • Выпущено — сколько карт создано по ссылкам;
  • Установлено — сколько карт сейчас лежит в Wallet покупателей;
  • Удалено — сколько покупателей убрали карту.

График ниже — установки и удаления по дням за 30 дней в часовом поясе проекта.

Статистика карт Wallet

В карточке профиля блок Карты Wallet показывает карты покупателя: платформу, номер карты и дату — когда карта установлена, удалена или выпущена, но не установлена.