SDK na prelanderze

Zazwyczaj odwiedzający trafia na prelander, a stamtąd przechodzi do karty sklepu PWA, gdzie znajduje się przycisk instalacji. Jednak instalację i subskrypcję push można uruchomić bezpośrednio na własnym prelanderze: wystarczy podłączyć Browser SDK i wywołać jego metody z własnych przycisków. Wówczas odwiedzający instaluje aplikację i zapisuje się do push, nie opuszczając prelandera.

Odwiedzający nie musi instalować aplikacji: subskrypcja push działa bez niej.

Co jest potrzebne wcześniej

• Prelander przesłany do Qubix. To Pańska/Pani strona w sekcji Witryny — proszę ją przesłać tak samo jak zwykłą witrynę (zob. Przesyłanie witryny).
• Skonfigurowana i aktywna domena. Prelander musi być serwowany na domenie skonfigurowanej w Qubix i aktywnej (zob. Domeny). Jest to wymagane: instalacja i push działają tylko wtedy, gdy strona i adresy serwisowe SDK są na tej samej domenie.
• Utworzone PWA — potrzebny będzie jego identyfikator (pwaId) z karty w sekcji Aplikacje PWA.

Jak podłączyć

1. W kodzie prelandera proszę ustawić konfigurację i załadować skrypt SDK. Konfiguracja musi być przed skryptem:

   index.htmlHTML

   <script>
     window.pwaConfig = {
       pwaId: 'YOUR-PWA-ID',
       domain: 'your-domain.com',
     }
   </script>
   <script src="https://your-domain.com/sdk.js" defer></script>

   Klucz push jest wstawiany do /sdk.js automatycznie — nie trzeba go dodawać ręcznie. Szczegółowy opis pól znajduje się w dokumentacji Browser SDK.

2. Proszę przygotować SDK do instalacji — jednorazowo, przy ładowaniu strony. To wywołanie rejestruje część serwisową i dołącza manifest aplikacji:

   JavaScript

   sdk.pwa.init()

3. Proszę powiązać instalację z własnym przyciskiem:

   HTML

   <button id="install">Zainstaluj aplikację</button>
   <script>
     document.getElementById('install').addEventListener('click', () => {
       sdk.pwa.install()
     })
   </script>

4. Proszę powiązać subskrypcję push z własnym przyciskiem (lub wywołać ją w odpowiednim momencie):

   JavaScript

   await sdk.subscribePush()

Gotowe — instalacja i subskrypcja odbywają się na Pańskiej/Pani stronie. Odwiedzający nie jest przekierowywany do karty sklepu.

Wskazówka

Jeśli jakiś scenariusz wymaga jednak karty sklepu, sdk.showStore() ją otwiera. Jeśli tej metody nie wywołasz — odwiedzający pozostaje na Twoim prelanderze.

Instalację wyświetla przeglądarka

Proszę pokazywać przycisk instalacji tylko wtedy, gdy instalacja jest rzeczywiście dostępna — należy sprawdzić sdk.pwa.canInstall(). Przeglądarki nie zawsze zezwalają na monit instalacji: wymagane jest bezpieczne połączenie (HTTPS) oraz zazwyczaj akcja odwiedzającego na stronie. Dlatego zarówno instalacja, jak i subskrypcja są zwykle powiązane z jawnym dotknięciem, a nie uruchamiane przy załadowaniu strony.

Weryfikacja

Proszę otworzyć prelander na telefonie i dotknąć swoich przycisków — przeglądarka wyświetli monit instalacji oraz monit powiadomień. Wynik jest widoczny w raportach: zdarzenia install_accepted, push_allow i inne trafiają do strumienia zdarzeń.

Co dalej

Dokumentacja Browser SDK

Wszystkie metody i zdarzenia Browser SDK.

Przesyłanie witryny

Jak przesłać prelander do Qubix.

Kampanie push

Wysyłanie powiadomień do zapisanych.