6.7. Passmachine integrace

Modul Passmachine umožňuje v Targitu vytvářet a spravovat digitální karty (Apple Wallet / Google Wallet) – hromadně i pro jednotlivé kontakty, karty průběžně aktualizovat a po vygenerování rozesílat odkaz ke stažení e‑mailem či push notifikací. Passmachine je náš ověřený partner pro správu digitálních karet, který je do Targita integrován pomocí API. Tato stránka popisuje logiku, nastavení a osvědčené postupy.

Jak to funguje (architektura a datové toky)

• Integrace: V modulu Passmachine zadáte přístupové údaje a Account ID. Targito volá API Passmachine a pracuje s entitami Šablona karty (template) a Karta (pass).

• Šablona karty: Definuje vzhled a sadu proměnných (např. jmeno, prijmeni, vek, barcode, thumbnail, platnost…). Seznam proměnných vždy vychází z dané šablony v Passmachine.

• Mapování dat: V akci Digitální karta přiřadíte hodnoty z Targita (pole kontaktu, funkce, výpočty) k proměnným šablony. Příklad: {{contacts.id}} → id, {{contacts_first_name}} {{contacts.last_name}} → prijmeni, funkce _CALCULATE_AGE_FUNC → vek, _FORMAT_DATE_FUNC → narozeni, atd.

• Typy akcí:

  • Create Pass – vytvoří kartu, pokud neexistuje (pro každý kontakt 1:1).

  • Edit Pass – aktualizuje existující kartu (změna polí, prodloužení platnosti, náprava chyb apod.).

• Generování vs. distribuce: Vygenerování karty přes API samo o sobě kartu neposílá kontaktu. Odeslání odkazu ke stažení provedete následnou kampaní (e‑mailová rozesílka).

• Push notifikace: Kromě e‑mailu můžete rozeslat mobilní nebo webové push s tlačítkem Stáhnout kartu (vede na individuální odkaz). Push slouží i k připomenutí instalace nebo k upozornění na aktualizaci karty.

• Logy a reporting: V modulu uvidíte seznam šablon a generovaných karet včetně stavu.

Identifikátor karty: Doporučujeme používat contacts.id jako jednoznačné id v šabloně. Zabráníte duplicitám a usnadníte pozdější Edit Pass.

Jak to nastavit / spustit (kroky)

1) Zapojení modulu Passmachine

1. Otevřete Moduly → Passmachine.

2. Vyplňte přihlašovací jméno, heslo a Account ID (dodá Passmachine).

3. Uložte výchozí nastavení a zapněte modul.

Přístup ke správě šablon a karet v Targitu je zprostředkovaný přes tento modul. Vzhled karty a dostupné proměnné vycházejí z konfigurace v Passmachine.

Open

2) Kontrola šablon a proměnných

• V Moduly → Passmachine → Šablony zkontrolujte, že máte připravenou šablonu (např. Členská karta), a poznamenejte si její Template ID.

• Detail šablony zobrazuje proměnné v šabloně, které budete mapovat v akci kampaně.

3) Hromadné vygenerování karet (jednorázově)

1. Vytvořte Hromadnou kampaň a vyberte seznam kontaktů.

2. Jako Typ akce zvolte Digitální karta a Kanál Marketing (nebo Transakční dle potřeby).

3. Uložte a přejděte k rozesílce.

4. V kroku Digitální karta zvolte web, šablonu, typ akce Create Pass a namapujte datová pole Targita na proměnné v šabloně.

5. V Kontrole kampaně ověříte rekapitulaci. Tento krok karty jen vygeneruje.

6. Doručení odkazu ke stažení: po úspěšném vytvoření spusťte následnou kampaň (e‑mail) a do šablony vložte tlačítko Stáhnout kartu a v URL použijte proměnnou {{passes_[pass_template_id].url}}.

4) Jednotlivá karta pro nový kontakt (opt‑in)

Pro odeslání karty hned po přihlášení e‑mailu využijte kampaň Nový kontakt:

1. Kampaně → Nový kontakt – zvolte Pouze potvrzení (nebo Ověření + Potvrzení dle scénáře) a web.

2. Do kroku s potvrzením přidejte dvě akce:

   • Vygenerovat nový pass (Create Pass)

   • Stažení karty (e‑mail s odkazem ke stažení / případně push)

Tím zajistíte, že nově přihlášený kontakt obratem dostane svou kartu a může ji uložit do walletu.

5) Průběžné aktualizace karet (automatizace)

1. Vytvořte Automatizovanou kampaň.

2. Vyberte seznam kontaktů, který definuje vstupní podmínky (např. všichni členové se zaplaceným členstvím).

3. V Akcích zvolte Digitální karta → Edit Pass a namapujte jen proměnné, které chcete aktualizovat (např. platnost, klub, notifikace).

4. Nastavte plán (např. denně v 07:00, pracovní dny).

Doporučení: Při změně důležité hodnoty (např. prodloužení platnosti) pošlete navazující push notifikaci – stručné sdělení + tlačítko Zobrazit/Obnovit kartu.

6) Seznam vygenerovaných karet a kontrola

• V Moduly → Passmachine → Digitální karty uvidíte přehled všech karet (filtr podle šablony, ID kontaktu apod.).

Přehled slouží k rychlému ověření, že se karty vytvářejí/aktualizují podle očekávání.

Reálné ukázky (anonymizované scénáře)

• Členská karta sportovní organizace: Po přijetí platby se spustí automat Edit Pass, který vyplní/aktualizuje pole platnost.

• Karta návštěvníka akce: Jednorázová hromadná kampaň Create Pass pro držitele vstupenek + web push v den konání s odkazem Otevřít kartu.

Poznámky k mapování a funkcím

• id (povinné): unikátní identifikátor karty. Doporučeno {{contacts.id}}.

• barcode: zdroj pro čárový kód/QR (často stejné jako id).

• thumbnail: URL obrázku v profilu kontaktu (např. fotografie) – volitelné.

• Věkový výpočet: _CALCULATE_AGE_FUNC nad datem narození.

• Formátování data: _FORMAT_DATE_FUNC použijte pro převod do formátu očekávaného v šabloně (např. dd.mm.yyyy).

• notifikace: text, který se může zobrazit na zadní straně karty (dle designu šablony v Passmachine).

Kompletní seznam polí se řídí šablonou v Passmachine. Pokud pole v Targitu nenamapujete, zůstane prázdné či výchozí dle šablony.

Odeslání odkazu ke stažení karty (distribuce)

Po úspěšném Create Pass je potřeba kontaktu zaslat odkaz ke stažení:

• E‑mail: v šabloně vložte proměnnou {{passes_[pass_template_id].url}} do tlačítka Stáhnout kartu.

• Opakované zaslání: Vytvořte segment „nemají nainstalovanou kartu“ (dle dostupných signálů nebo chování) a jednou týdně rozesílejte připomínku.

Tip: U nových kontaktů kombinujte Create Pass a e‑mail v jedné cestě (viz kapitola Jednotlivá karta pro nový kontakt).

Segmentace kontaktů podle dat o digitálních kartách

Pomocí dat, která Passmachine vrací k jednotlivým kartám, lze v Targitu přesně cílit připomínky a follow‑up kampaně.

Kde: v segmentaci zvolte skupinu Digitální karty (Passmachine) → Vytvořená digitální karta a vyberte příslušnou šablonu karty (např. Karta - Věrnostní program). Poté můžete filtrovat podle dostupných atributů:

• is_downloaded (boolean) – zda byla karta stažena/instalována do walletu alespoň jednou.

• downloaded_date (datetime) – kdy došlo ke stažení karty.

• created_date (datetime) – kdy byla karta poprvé vytvořena (Create Pass).

• updated_date (datetime) – kdy byla karta naposledy aktualizována (Edit Pass).

• microsite_url (text) – unikátní URL ke stažení karty; vhodné do personalizace, případně pro ověření, že je link k dispozici.

Ukázky nastavení:

• Připomínka instalace: Vytvořená digitální karta = [Šablona] AND is_downloaded = FALSE → pošlete e‑mail s tlačítkem Stáhnout kartu.

• První instalace v období: downloaded_date v intervalu [od–do] → vyhodnocení adopce nebo poděkování po instalaci.

• Karta aktualizována nedávno: updated_date v posledních 7 dnech → informujte uživatele pomocí push Vaše karta byla aktualizována.

• Dlouho bez instalace: created_date ≤ dnes − 3 dny AND (is_downloaded = FALSE) → připomínka s návodem jak kartu uložit.

Testování a uvedení do provozu (shrnutí)

• Šablona a proměnné odpovídají reálnému designu v Passmachine.

• Akce Digitální karta má správně zvolené Create / Edit a namapovaná povinná pole (zejm. id).

• Ověřte na vzorku kontaktů.

• Po uložení kampaně ji v seznamu Spusťte. U automatizací sledujte první průběh.