Jak utworzyć kampanię i wydać SmartPass w panelu Sparados? Poradnik krok po kroku
Zaktualizowano: 7 godzin temu
Chcesz, żeby karta lojalnościowa, bilet albo identyfikator Twojej firmy trafiły prosto do Apple Wallet i Google Wallet klientów? W panelu Sparados zrobisz to w dwóch etapach: najpierw tworzysz kampanię, czyli szablon passa, a potem wydajesz passy konkretnym osobom. Ten poradnik prowadzi przez cały proces – od pustego formularza do passa w telefonie klienta.
Najważniejsze informacje
Kampania to szablon passa: wygląd, teksty, języki i pola wspólne dla wszystkich passów.
Bez programistów: wszystko ustawisz w panelu admina, a podgląd Apple Wallet i Google Wallet zmienia się na bieżąco.
Pola wypełniane per pass: dane posiadacza, np. imię i nazwisko, podajesz przy wydaniu passa lub w pliku CSV.
Dwa sposoby wydawania: pojedynczo (e-mail, link, kod QR) albo masowo z pliku CSV.
Bez aplikacji: klient dodaje pass do portfela w telefonie jednym dotknięciem.
Spis treści:
Czym jest kampania SmartPass?
SmartPass to platforma Sparados do tworzenia firmowych passów do Apple Wallet i Google Wallet: kart lojalnościowych, biletów, voucherów, kart członkowskich, kart polis czy identyfikatorów pracowniczych. Przykłady z branży ubezpieczeniowej opisujemy w artykule o portfelach cyfrowych w ubezpieczeniach.
Kampania to szablon: ustawiasz w niej format kodu, języki, wygląd i pola. Każdy pass wydany w ramach kampanii dziedziczy te ustawienia, a różni się tylko danymi, które oznaczysz jako wypełniane per pass – np. imieniem i nazwiskiem posiadacza.
Czego potrzebujesz przed rozpoczęciem?
Dostęp administratora do panelu Sparados.
Logo firmy w formacie PNG lub JPEG (do 10 MB).
Ikonę w formacie PNG lub JPEG – jest wymagana przez Apple Wallet. Wymagania Apple dotyczące passów opisuje dokumentacja Apple Wallet.
Kolory marki w formacie HEX (np. #091E2F).
Listę pól, które mają się znaleźć na passie, z podziałem na wspólne i indywidualne.
Krok 1: Jak dodać nową kampanię SmartPass?
Zaloguj się do panelu Sparados, w menu bocznym wybierz SmartPass i na zakładce Kampanie kliknij „Dodaj kampanię”. Otworzy się formularz z podglądem passa po prawej stronie – podgląd Apple Wallet i Google Wallet aktualizuje się w trakcie wypełniania pól.
Podstawowe dane
Nazwa kampanii – nazwa wewnętrzna, niewidoczna dla posiadaczy passów.
Format kodu kreskowego – QR, PDF417, AZTEC lub CODE128. To format domyślny, a treść kodu podajesz osobno dla każdego passa.
Szablon e-mail – opcjonalny szablon wiadomości z passem. Puste pole oznacza szablon domyślny.
Języki
Domyślnie w polu „Obsługiwane języki” jest angielski. Dodaj języki, w których chcesz pisać teksty karty – dla polskiej karty wpisz „Pol” i wybierz „Polski” – a potem ustaw język domyślny. Wybierz „Polski” w polu „Język domyślny”: jest wymagany we wszystkich tekstach i używany, gdy brakuje tłumaczenia. Angielski możesz usunąć krzyżykiem przy jego nazwie. Pasek „Edytujesz teksty w języku” nad sekcją tekstów pokazuje, w którym języku piszesz, i pozwala przełączać wersje językowe.
Krok 2: Jak ustawić teksty i wygląd passa?
Teksty karty
Nazwa organizacji – w Apple Wallet to nazwa wystawcy widoczna w powiadomieniach, w Google Wallet mały tytuł nad kartą.
Nagłówek karty – tylko w Google Wallet: duży nagłówek pod tytułem. Jeśli go nie podasz, wyświetli się nazwa organizacji.
Kolory i obrazy
Kolor tła – dotyczy Apple Wallet i Google Wallet.
Kolor tekstu i kolor etykiet – dotyczą tylko Apple Wallet.
Logo – PNG lub JPEG do 10 MB, skalowane do 50 px wysokości.
Ikona (Apple) – wymagana przez Apple Wallet. PNG lub JPEG do 10 MB, przycinana do kwadratu (29 px).
Obraz paska – opcjonalny, przycinany do 375×144 px.
Wskazówka: przy ciemnym tle użyj białego logo, a dla etykiet wybierz jaśniejszy odcień koloru marki. Tekst na passie pozostanie czytelny.
Krok 3: Jak dodać pola do passa?
Pola to informacje wyświetlane na passie. Panel dzieli je na strefy, które różnią się położeniem i wielkością tekstu:
Strefa | Gdzie się wyświetla | Przykład |
Nagłówek | Mały tekst w prawym górnym rogu, przy logo | Poziom: Gold |
Główne | Duży tekst – tu umieść imię i nazwisko posiadacza | Imię i nazwisko |
Dodatkowe | Wiersz pod polami głównymi | Ważna do: 31.12.2026 |
Pomocnicze | Dodatkowy wiersz pod polami dodatkowymi | Strona: sparados.com |
Tył / szczegóły | Tył passa (Apple) lub widok szczegółów (Google) | Opis firmy, linki, kontakt |
Pole wspólne czy wypełniane per pass?
Takie samo dla wszystkich – tekst ustawiasz w kampanii i widzą go wszyscy posiadacze passów.
Wypełniane per pass – każdy pass dostaje własną wartość zapisaną pod „Kluczem wartości”. Panel podpowiada klucz na podstawie etykiety, a Ty możesz go zmienić, np. na imie_nazwisko. Ten sam klucz jest nazwą kolumny w pliku CSV przy wydawaniu z pliku.
Powiadomienia o zmianach
Przy każdym polu możesz włączyć przełącznik „Powiadom posiadaczy o zmianie” i wpisać „Treść powiadomienia”. Znacznik %@ zostanie zastąpiony nową wartością pola, a klient zobaczy powiadomienie na ekranie blokady – np. o zmianie statusu albo terminu.
Linki na odwrocie passa
W strefie Tył / szczegóły możesz dodawać linki w formacie <a href="https://...">tekst</a> oraz linki tel: i mailto:. To dobre miejsce na kontakt, ofertę, FAQ czy samoobsługę klienta.
Krok 4: Jak zapisać kampanię?
Gdy podgląd wygląda tak, jak chcesz, kliknij „Zapisz”. Pojawi się komunikat „Kampania została zapisana.”, a panel od razu otworzy stronę kampanii z jej ustawieniami i przyciskami „Wydaj pass”, „Wydaj z pliku CSV”, „Edytuj” i „Usuń”. Kampania jest też widoczna na liście kampanii z układem, językami i licznikiem passów (zapisane / aktywne). Ustawienia zmienisz później przyciskiem „Edytuj” na stronie kampanii.
Krok 5: Jak wydać pass jednej osobie?
Otwórz kampanię i kliknij „Wydaj pass”. W oknie uzupełnij:
E-mail posiadacza – adres osoby, która otrzyma pass.
Wartości passa – pola oznaczone jako wypełniane per pass, np. Posiadacz (imię i nazwisko). Pod każdym polem widać jego klucz wartości.
Treść kodu kreskowego i tekst pod kodem kreskowym (opcjonalnie) – dane zakodowane w kodzie kreskowym. Bez treści kodu pass nie będzie miał kodu.
Wygasa (opcjonalnie) – zostaw puste, jeśli pass ma nie wygasać. Po tej dacie pass zostanie automatycznie unieważniony.
Wyślij pass e-mailem – przełącznik jest domyślnie włączony. Wybierz język e-maila albo wyłącz wysyłkę, jeśli przekażesz pass w inny sposób.
Po kliknięciu „Wydaj pass” zobaczysz okno „Pass wydany” z kodami QR do Apple Wallet i Google Wallet oraz przyciskami „Kopiuj link”. Pass możesz więc wysłać e-mailem, pokazać jako kod QR do zeskanowania telefonem albo przekazać link w dowolnym kanale. Okno zamkniesz przyciskiem „Gotowe”.
Jak wydać wiele passów naraz z pliku CSV?
Przy większej liczbie odbiorców użyj przycisku „Wydaj z pliku CSV” na stronie kampanii. Otworzy się okno „Wydaj passy z pliku CSV”, w którym panel podaje wymagane kolumny dla tej kampanii. Każdy wiersz pliku to jeden pass.
Wymagane kolumny: userEmail oraz klucze pól wypełnianych per pass (np. imie_nazwisko).
Kolumny opcjonalne: barcodeMessage, barcodeAltText i expiresAt (data w formacie ISO, w przyszłości).
Plik: kodowanie UTF-8, separator – przecinek, średnik lub tabulator, rozmiar do 5 MB.
Szablon: pobierzesz go przyciskiem „Pobierz szablon CSV” w oknie importu.
Ważne: jeśli którykolwiek wiersz jest błędny, nie zostanie wydany żaden pass. Popraw plik i wgraj go ponownie. W tym samym oknie możesz włączyć wysyłkę passów e-mailem i wybrać język e-maila, a import uruchamiasz przyciskiem „Rozpocznij wydawanie”.
Jak klient dodaje pass do Apple Wallet lub Google Wallet?
Klient otrzymuje e-mail z przyciskami dodania passa do Google Wallet i Apple Wallet. Wystarczy jedno dotknięcie – bez pobierania aplikacji. Pass jest potem dostępny w portfelu w telefonie, także offline. O tym, jak działa dodawanie do portfela prosto ze strony lub wiadomości, przeczytasz w artykule Web-to-Wallet: praktyczne przykłady zastosowań.
Ten sam model – bez aplikacji – Sparados stosuje przy kartach płatniczych, które firmy dodają do portfeli przez Web Push Provisioning.
Gdzie sprawdzić status wydanych passów?
Na zakładce Passy w module SmartPass widzisz listę wydanych passów: posiadacza, status (np. Aktywny), portfele, w których zapisano pass, datę wygaśnięcia oraz daty utworzenia i aktualizacji. Zakładka Wsady pokazuje importy z plików CSV, a licznik na liście kampanii – ile passów zapisano w portfelach i ile jest aktywnych. W menu akcji przy każdym passie możesz go edytować albo unieważnić.
Ile kosztuje wydawanie passów SmartPass?
SmartPass rozlicza się według limitu passów i do limitu liczą się tylko wysłane passy. Tworzenie szablonów, aktualizacje passów i powiadomienia push go nie zużywają. Nie ma opłaty za platformę ani za API, a wysłane passy nie wygasają. Szczegóły znajdziesz w cenniku SmartPass.
Najczęściej zadawane pytania o SmartPass
Czy klient musi pobrać aplikację, żeby dodać pass?
Nie. Klient dodaje pass jednym dotknięciem do Apple Wallet lub Google Wallet, które ma już w telefonie.
Czy potrzebuję programisty, żeby utworzyć kampanię?
Nie. Kampanię tworzysz i wydajesz passy w panelu admina. Wydawanie i aktualizacje możesz zautomatyzować przez API Sparados, dostępne bez dodatkowej opłaty.
Jaki format kodu wybrać?
QR, PDF417, AZTEC lub CODE128 – wybierz format, który obsługują Twoje skanery. Format ustawiasz w kampanii, a treść kodu osobno dla każdego passa.
Czym różni się pole „takie samo dla wszystkich” od pola „wypełnianego per pass”?
Pierwsze ma jedną wartość w całej kampanii. Drugie ma własną wartość dla każdego passa, podawaną przy wydaniu lub w kolumnie pliku CSV.
Czy mogę wydać wiele passów naraz?
Tak, przez import CSV. Jeden wiersz to jeden pass, a wymagane kolumny to userEmail i klucze pól wypełnianych per pass.
Czy pass może wygasnąć?
Tylko jeśli ustawisz datę wygaśnięcia. Bez daty pass nie wygasa, a z datą zostaje automatycznie unieważniony po jej upływie.
Wydaj pierwszy SmartPass jeszcze dziś
Jesteś klientem Sparados? Zaloguj się do panelu i utwórz pierwszą kampanię. Jeśli dopiero poznajesz SmartPass, porozmawiaj z nami – pokażemy cały proces na przykładzie Twojej firmy.
