Web push – konfiguracja

Tutaj znajdziesz instrukcje jak skonfigurować kanał web push dla swojej strony.

Wymagania#

Zanim skonfigurujesz kanał web push:

• W ustawieniach dodaj stronę internetową, z której chcesz wysyłać powiadomienia web push.
• Skonfiguruj kanał Web Tracking, czyli śledzenie ruchu na Twojej stronie.

Konfiguracja kanału web push

Kanał web push możesz skonfigurować i uruchomić dla każdej strony, którą dodajesz do platformy.

1. Przejdź do Ustawienia > Web push > Web push.
2. Znajdź stronę, dla której chcesz skonfigurować i uruchomić kanał web push.
3. Kliknij ikonę Konfiguruj </>.

Kolejne kroki konfiguracji będą się różnić, w zależności od tego, czy masz na serwerze umieszczony plik service worker, czy nie.

Service worker to plik w języku JavaScript, który odpowiada za dostarczanie powiadomień web push użytkownikom Twojej strony, nawet gdy jej nie przeglądają.

Wybierz odpowiedni scenariusz konfiguracji:

Mam plik service worker na serwerze

1. W oknie Skonfiguruj web push rozwiń zakładkę Mam plik service worker na serwerze.
2. Skopiuj kod widoczny w oknie
3. Zaloguj się do serwera, na którym jest umieszczona Twoja strona.
4. Znajdź plik service worker na swoim serwerze, np. za pomocą narzędzia do zarządzania plikami. Plik service worker zazwyczaj nazywa się service-worker.js, sw.js lub podobnie. Najczęściej znajdziesz go:
   • W katalogu głównym serwera (root directory), np. [/service-worker.js]
   • W katalogu [public], np. [/public/service-worker.js]
5. Otwórz plik service worker w trybie do edycji. Możesz użyć do tego edytora dostępnego na serwerze lub pobrać plik na swój komputer, a następnie otworzyć go w edytorze tekstu, np. w Notatniku.
6. Wklej skopiowany kod na początku lub na końcu pliku. Zwróć uwagę, aby nie wkleić go pomiędzy inne funkcje. W przeciwnym razie plik nie będzie działał poprawnie.
7. Zapisz plik.
8. Jeśli plik był edytowany lokalnie, prześlij go z powrotem na serwer do odpowiedniego katalogu, podmieniając stary plik.
9. Skopiuj lokalizację pliku service worker. Powinna mieć formę ścieżki URL, np:
   • https://www.TwojaStrona.com/service-worker.js – jeśli plik znajduje się w katalogu głównym.
   • https://www.TwojaStrona.com/public/service-worker.js – jeśli plik znajduje się w katalogu [public].
10. Wróć do okna Skonfiguruj web push w platformie, dostępnego w Ustawienia > Web push > Web push > Konfiguruj </>.
11. W oknie Sprawdź status pliku service worker wklej skopiowaną ścieżkę URL.
12. Kliknij Weryfikuj status pliku. W ten sposób sprawdzimy, czy plik jest dostępny, a wklejony kod działa prawidłowo.
13. Po pomyślnej weryfikacji kliknij Zapisz.
14. Status kanału dla tej strony zmieni się na Aktywny. Znajdziesz go w tabeli dostępnej w Ustawienia > Web push.

Nie mam pliku service worker na serwerze

1. W oknie Skonfiguruj web push rozwiń zakładkę Nie mam pliku service worker na serwerze.
2. Kliknij Pobierz plik service worker. W pliku znajduje się już nasz kod, dzięki któremu przeglądarka będzie mogła wyświetlać powiadomienia wszystkim odbiorcom.
3. Zaloguj się do serwera, na którym jest umieszczona Twoja strona.
4. Za pomocą narzędzia do zarządzania plikami umieść pobrany plik service worker na swoim serwerze. Najczęściej wybierane lokalizacje dla tego pliku to:
   • Katalog główny serwera (root directory).
   • Katalog [public].
5. Skopiuj lokalizację pliku. Powinna mieć formę ścieżki URL, np:
   • https://www.TwojaStrona.com/service-worker.js – jeśli plik znajduje się w katalogu głównym
   • https://www.TwojaStrona.com/public/service-worker.js – jeśli plik znajduje się w katalogu [public]
6. Wróć do okna Skonfiguruj web push w platformie, dostępnego w Ustawienia > Web push > Web push > Konfiguruj </>.
7. W oknie Sprawdź status pliku service worker wklej skopiowaną ścieżkę URL.
8. Kliknij Weryfikuj status pliku. W ten sposób sprawdzimy, czy plik jest dostępny, a wklejony kod działa prawidłowo.
9. Po pomyślnej weryfikacji kliknij Zapisz.
10. Status kanału dla tej strony zmieni się na Aktywny. Znajdziesz go w tabeli dostępnej w Ustawienia > Web push.

Kanał web push jest gotowy do działania.

Co zrobić, gdy konfiguracja web push nie udała się?

Najczęstsze przyczyny problemów z konfiguracją web push i jak je rozwiązać znajdziesz poniżej:

Następne kroki

• Stwórz prośbę o zgodę na wysyłanie powiadomień web push
• Stwórz powiadomienie web push