Poradnik użytkownika

Twoje pierwsze kroki w aplikacji PushPushGo

Integracja strony

Podstawowa integracja

Zwróć uwagę, że w przypadku Podstawowej integracji wystarczy tylko wkleić kod integracyjny w dowolnym miejscu w kodzie Twojej strony. Powoduje to, że:

  • Twoi odbiorcy będą się zapisywać dwuetapowo. Po zaakceptowaniu formularza zapisu pojawi się drugie okno, w którym należy potwierdzić zgodę na otrzymywanie powiadomień.
  • Odbiorcy zapisywani są na dedykowanej dla każdego projektu subdomenie www.nazwa-strony-pl.pushpushgo.com
  • W powiadomieniach bedzie wyświetlała się dedykowana subdomena www.nazwa-strony-pl.pushpushgo.com

1. Żeby skorzystać z tej integracji wklej skrypt integracyjny w źródle swojej strony w dowolnym miejscu

2. Po wklejeniu skryptu w źródle strony kliknij przycisk Sprawdź integrację, aby sprawdzić czy wszystko działa poprawnie.

Poniższy zielony komunikat poinformuje Cię o poprawności integracji:

Integracja z własną domeną

W przypadku Integracji z własną domeną, podczas integracji muszą być spełnione dodatkowe warunki:

  • Twoja domena musi posiadać https
  • Skrypt integracyjny musisz umieścić w sekcji <head> w kodzie Twojej strony
  • Musisz umieścić na ścieżce root swojego serwera pobrany od nas plik: sw.js. (tak, aby był on dostępny ze strony https://twojadomena.com/sw.js)
  • W związku z powyższym nie możliwości przeprowadzenia tej integracji za pomocą Google Tag Managera

Co zyskujesz dzięki tej integracji?

  • Twoi odbiorcy zapisują się na powiadomienia jednym kliknięciem, więc Twoja baza rośnie szybciej
  • W powiadomieniach na Twojej stronie internetowej widoczna jest tylko Twoja domena

1. Aby zintegrować swoją stronę za pomocą integracji z własną domeną najpierw pobierz i rozpakuj skrypt a następnie umieść go na ścieżce root serwera.

Żeby sprawdzić poprawność jego umieszczenia:

  • Wklej w przeglądarce adres http://twojadomena/sw.js i sprawdź czy zwraca on wartość pliku czy wyświetla błąd

2. Następnie umieść kod integracyjny w sekcji <head>lub <body> w kodzie swojej strony i kliknij przycisk Sprawdź integrację, żeby sprawdzić jej poprawność

3. Zielony komunikat poinformuje Cię o prawidłowej integracji a na Twojej stronie zacznie się wyświetlać formularz zapisu na notyfikacje web push.

Ważne! W przypadku integracji z własną domeną, jeśli posiadasz już swój service worker na stronie i nie masz możliwości jego usunięcia - zaimportuj zawartość pliku sw.js do swojego pliku i koniecznie poinformuj nas o tym. 

Zmiana ścieżki service workera


Jeśli chcesz zamienić adres z sw.js na inny, np. service-worker.js, możesz po prostu wkleić nowy adres w sekcji Ścieżka service workera w zakładce Ustawienia projektu. Natomiast jeśli chcesz zmienić katalog, w którym znajduje się plik sw.js (na przykład na static/sw.js), musisz dodatkowo dodać następujący response header: "Service-Worker-Allowed": "/".

Jeżeli zamierzasz dodać service worker do innego katalogu np. static, to pola “ścieżka sw.js” oraz “sw.js scope” (w zakładce Ustawienia projektu na Twoim koncie) powinny być uzupełnione w taki sposób:
● ścieżka sw.js: /static/sw.js
● sw.js scope: /static

Przetestuj web push na swojej stronie

Testuję za darmo

Darmowa wersja zawiera wszystkie funkcjonalności systemu

Fundusze Europejskie