6.3. Firebase integrace

Modul Firebase umožňuje odesílat mobilní i webové push notifikace přes Firebase Cloud Messaging (FCM) přímo z Targita. Targito se stará o tvorbu obsahu zprávy, výběr publika a odeslání k poskytovateli; samotné doručení a zobrazení v zařízení zajišťuje Firebase/FCM.

Jak to funguje

• Datový tok:
  Targito vytvoří notifikaci, vysegmentuje adresáty a předá požadavek na odeslání do FCM. Poskytovatel následně doručí zprávu do cílových zařízení (mobilní aplikace nebo webový prohlížeč).

• Identifikace zařízení:
  Pro doručení je potřeba externí ID zařízení (FCM registration token) uložené u kontaktu v databázi. V modulu Push notifikace se proto volí sloupec s externím ID uživatele pro mobilní a webové push.

• Mobilní vs. webové push:

  • Mobilní push se zobrazují pouze ve vaší mobilní aplikaci s integrovaným FCM SDK.

  • Webové push se zobrazují v prohlížeči návštěvníka (vyžadují JavaScriptovou integraci a souhlas).

Jak to nastavit / spustit

1) Konfigurace „Firebase Push Notifications“ (FCM)

Otevřete Moduly → Firebase Push Notifications a vyplňte:

• Firebase Project ID – ID projektu z Firebase konzole.

• Firebase API Key – Web API key projektu (pro webové push).

• Firebase Sender ID – Sender ID z nastavení FCM.

• Server Authentication

  • Service Account JSON (Recommended) – JSON obsahu servisního účtu s oprávněním pro FCM v1 API (doporučeno).

  • Server Key (Legacy) – pouze pokud využíváte legacy FCM endpoint.

• Web Push Configuration (volitelné, pro webové push)

  • VAPID Public Key a VAPID Private Key – VAPID pár pro prohlížečové notifikace.

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

2) Zapnutí poskytovatele „Firebase“ v modulu Push notifikace

1. V Targitu otevřete Moduly → Push notifikace.

2. V částech Poskytovatel Mobilních push notifikací a/nebo Poskytovatel Webových push notifikací zvolte Firebase.

3. V poli Sloupec s externím ID uživatele vyberte sloupec s FCM registration tokenem (typicky contact_devices.device_id).

4. Uložte a modul zapněte

3) Implementace na straně aplikace / webu

• Mobilní aplikace: Integrujte Firebase/FCM SDK do iOS/Android aplikace a odesílejte FCM registration tokeny do vašeho backendu a následně do Targita (do zvoleného sloupce pro externí ID).

• Web: Aktivujte FCM pro web push (včetně service workeru). Při získání souhlasu ukládejte token do stejného sloupce v Targitu.

4) Odeslání první notifikace

1. Vytvořte novou push kampaň v Targitu.

2. Vyberte publikum (seznam kontaktů) a připravte obsah.

3. Odešlete nejprve na vlastní testovací seznam a poté ostré rozeslání.

Open