Як створити кампанію та видати SmartPass на платформі Sparados: покрокова інструкція
Хочете, щоб ваша картка лояльності, квиток чи посвідчення потрапляли просто в Apple Wallet і Google Wallet ваших клієнтів? На платформі Sparados це робиться у два етапи: спочатку ви створюєте кампанію, тобто шаблон паса, а потім видаєте паси конкретним людям. Ця інструкція проведе вас через увесь процес: від порожньої форми до паса в телефоні клієнта.
Головне коротко
Кампанія є шаблоном паса: дизайн, тексти, мови й поля, спільні для всіх пасів.
Без розробників: усе налаштовується в адмінпанелі, а попередній перегляд Apple Wallet і Google Wallet оновлюється миттєво.
Індивідуальні поля: дані власника, наприклад ім’я та прізвище, вводяться під час видачі паса або у файлі CSV.
Два способи видачі: поодинці (e-mail, посилання, QR-код) або масово з файлу CSV.
Без застосунку: клієнти додають пас до гаманця в телефоні одним дотиком.
Зміст:
Що таке кампанія SmartPass?
SmartPass є рішенням Sparados для створення брендованих пасів в Apple Wallet і Google Wallet: карток лояльності, квитків, ваучерів, членських карток, страхових карток і посвідчень працівників. Якщо хочете краще зрозуміти, як працюють такі паси, прочитайте наш повний посібник про цифрові паси для Wallet.
Кампанія є шаблоном: у ній ви визначаєте формат штрихкоду, мови, дизайн і поля. Кожен пас, виданий у межах кампанії, успадковує ці налаштування й відрізняється лише даними, позначеними як «заповнюється для кожного паса», наприклад ім’ям і прізвищем власника.
Що потрібно перед початком?
Доступ адміністратора до платформи Sparados.
Логотип компанії у форматі PNG або JPEG (до 10 МБ).
Іконка у форматі PNG або JPEG, обов’язкова для Apple Wallet. Вимоги Apple до пасів описано в документації Apple Wallet.
Кольори бренду у форматі HEX (наприклад, 091E2F).
Перелік полів, які мають бути на пасі, з поділом на спільні та індивідуальні.
Крок 1: як додати нову кампанію SmartPass?
Увійдіть на платформу Sparados, у бічному меню виберіть SmartPass і на вкладці Campaigns натисніть «Add campaign». Відкриється форма, а праворуч ви побачите попередній перегляд паса: перегляд Apple Wallet і Google Wallet оновлюється, щойно ви заповнюєте поля.
Основні дані
Назва кампанії (Campaign name): внутрішня позначка. Власники пасів її не бачать.
Формат штрихкоду (Barcode format): QR, PDF417, AZTEC або CODE128. Це формат за замовчуванням, а вміст коду задається для кожного паса окремо.
Шаблон листа (Email template): необов’язковий шаблон листа, яким надсилається пас. Якщо його не вибрати, буде використано стандартний.
Мови
Виберіть мови, якими можна писати тексти картки, і мову за замовчуванням. Мова за замовчуванням обов’язкова для всіх текстів і використовується, коли бракує перекладу. Між мовними версіями ви перемикаєтеся за допомогою меню над розділом текстів.
Крок 2: як налаштувати тексти й дизайн паса?
Тексти картки
Назва організації (Organization name): в Apple Wallet це назва емітента, яка з’являється в сповіщеннях, а в Google Wallet невеликий заголовок у верхній частині картки.
Заголовок картки (Card heading): лише в Google Wallet, великий заголовок під назвою. Якщо залишити поле порожнім, відображатиметься назва організації.
Кольори та зображення
Колір фону: застосовується в Apple Wallet і Google Wallet.
Колір тексту та підписів: застосовуються лише в Apple Wallet.
Логотип: PNG або JPEG до 10 МБ, масштабується до висоти 50 px.
Іконка (Apple): обов’язкова для Apple Wallet, обрізається до квадрата.
Смуга із зображенням (strip): необов’язкова, обрізається до 375 × 144 px.
Порада: на темному фоні використовуйте білий логотип, а для підписів виберіть світліший відтінок кольору бренду. Так текст на пасі добре читатиметься.
Крок 3: як додати поля на пас?
Поля містять інформацію, яка відображається на пасі. Платформа групує їх у зони, що відрізняються розташуванням і розміром тексту:
Зона | Де відображається | Приклад |
Header | Дрібний текст у правому верхньому куті, поруч із логотипом | PASS: DEMO |
Primary | Великий текст: тут розміщують дані власника | Ім’я та прізвище |
Secondary | Рядок під основними полями | Віртуальні картки: за лічені секунди |
Auxiliary | Додатковий рядок під другорядними полями | Сайт: sparados.com |
Back / details | Зворот паса (Apple) або подробиці (Google) | Дані компанії, посилання, контакти |
Спільне поле чи поле, яке заповнюється для кожного паса?
Однакове для всіх: ви задаєте текст у кампанії, і його бачать усі власники.
Заповнюється для кожного паса: кожен пас отримує власне значення за ключем (Value key). Цей самий ключ є назвою стовпця у файлі CSV під час масової видачі.
Сповіщення про зміни
Для кожного поля можна ввімкнути сповіщення власникам про зміну значення та ввести текст повідомлення. Позначка %@ замінюється новим значенням, а клієнт бачить сповіщення на екрані блокування, наприклад про новий статус чи нову дату.
Посилання на звороті паса
У зоні Back / details можна додавати посилання у форматі <a href="https://...">текст</a>, а також посилання tel: і mailto:. Це ідеальне місце для контактів, пропозицій, FAQ чи самообслуговування.
Крок 4: як зберегти кампанію?
Коли попередній перегляд вас влаштує, натисніть «Save». Кампанія з’явиться в списку зі своїм дизайном, мовами та лічильником пасів (збережені / активні). Змінити налаштування можна пізніше кнопкою «Edit» на сторінці кампанії.
Крок 5: як видати пас одній людині?
Відкрийте кампанію та натисніть «Issue pass». У вікні заповніть:
E-mail власника (Holder email): адреса людини, яка отримає пас.
Значення паса (Pass values): поля, позначені як «заповнюється для кожного паса», наприклад ім’я та прізвище.
Вміст штрихкоду й текст під кодом (необов’язково): дані, закодовані в штрихкоді. Без вмісту пас не матиме штрихкоду.
Дата завершення дії (необов’язково): залиште поле порожнім, якщо пас має діяти безстроково. Після цієї дати пас автоматично анулюється.
Надіслати пас електронною поштою: увімкніть опцію та виберіть мову листа.
Після натискання «Issue pass» ви побачите QR-коди для Apple Wallet і Google Wallet та кнопки для копіювання посилання. Пас можна надіслати електронною поштою, показати QR-код для сканування телефоном або поділитися посиланням у будь-якому каналі.
Як видати багато пасів одночасно з файлу CSV?
Для великих груп скористайтеся кнопкою «Bulk issue (CSV)» на сторінці кампанії. Кожен рядок файлу відповідає одному пасу.
Обов’язкові стовпці: userEmail і ключі полів, які заповнюються для кожного паса (наприклад, NAMESURNAME).
Необов’язкові стовпці: barcodeMessage, barcodeAltText і expiresAt (майбутня дата у форматі ISO).
Файл: кодування UTF-8, значення розділені комами, крапками з комою або табуляцією, розмір до 5 МБ.
Шаблон: завантажте його кнопкою «Download CSV template» у вікні імпорту.
Важливо: якщо хоча б один рядок містить помилку, не буде видано жодного паса. Виправте файл і завантажте його ще раз. Під час імпорту також можна ввімкнути надсилання електронною поштою.
Як клієнт додає пас до Apple Wallet або Google Wallet?
Клієнт отримує лист із кнопками для додавання паса до Google Wallet і Apple Wallet. Достатньо одного дотику, без завантаження застосунку. Після цього пас зберігається в гаманці телефона й доступний навіть офлайн.
Таку саму модель без застосунку Sparados застосовує до платіжних карток, які компанії додають у гаманці через Web Push Provisioning. Докладніше про це читайте у статті Як додати картку до Apple/Google Wallet?
Де переглянути статус виданих пасів?
На вкладці Passes модуля SmartPass відображаються видані паси: власник, статус (наприклад, Active), гаманці, у яких збережено пас, дата завершення дії, а також дати створення й оновлення. Вкладка Batches показує імпорти CSV, а лічильник у списку кампаній показує, скільки пасів збережено в гаманцях і скільки з них активні.
Скільки коштує видача пасів SmartPass?
SmartPass тарифікується за лімітом пасів, і до нього зараховуються лише надіслані паси. Створення шаблонів, оновлення пасів і push-сповіщення ліміт не витрачають. Немає ні плати за платформу, ні плати за API, а термін дії надісланих пасів ніколи не спливає. Подробиці дивіться на сторінці Ціни на SmartPass.
FAQ: кампанії та паси SmartPass
Чи потрібно клієнту завантажувати застосунок, щоб додати пас?
Ні. Ваші клієнти одним дотиком додають пас до Apple Wallet або Google Wallet, які вже є в їхньому телефоні.
Чи потрібен розробник, щоб створити кампанію?
Ні. Кампанії створюються, а паси видаються в адмінпанелі. Видачу й оновлення можна автоматизувати через API Sparados без жодних доплат.
Який формат штрихкоду вибрати?
QR, PDF417, AZTEC або CODE128: вибирайте той, який підтримують ваші сканери. Формат задається в кампанії, а вміст коду для кожного паса.
Чим відрізняється поле «однакове для всіх» від поля «заповнюється для кожного паса»?
Перше має одне значення для всієї кампанії. Друге має власне значення в кожному пасі, яке вводиться під час видачі або в стовпці файлу CSV.
Чи можна видати багато пасів одночасно?
Так, через імпорт CSV. Кожен рядок відповідає одному пасу, а обов’язкові стовпці: userEmail і ключі полів, які заповнюються для кожного паса.
Чи може пас втратити чинність?
Лише якщо ви задасте дату завершення дії. Без дати пас діє безстроково, а з датою автоматично анулюється, щойно вона настане.
Видайте свій перший SmartPass уже сьогодні
Уже клієнт Sparados? Увійдіть на платформу та створіть свою першу кампанію. Якщо ви ще не знайомі зі SmartPass, зв’яжіться з нами, і ми покажемо весь процес на прикладі вашої компанії.
