Consentl w Ghost

Dodaj Consentl do Ghost przez wstrzykiwanie kodu lub w motywie, aby skrypt był pierwszy w <head>, i sprawdź, których funkcji Ghost Consentl nie wstrzymuje.

Skrypt ładujący jako pierwszy w <head>

Zależy od metody

Dlaczego metoda A zwykle wystarcza. Ghost renderuje wstrzykiwany kod nagłówka witryny na końcu {{ghost_head}}. Prawie każdy skrypt, który Ghost wstawia przed nim, jest odroczony (Portal, wyszukiwarka, pasek ogłoszeń, zasoby kart, liczniki komentarzy, atrybucja członków, analityka internetowa Ghost), więc synchroniczny skrypt ładujący Consentl i tak uruchamia się przed nimi. Uruchomienie jako pierwszy nie oznacza, że Consentl je wstrzymuje: są to własne skrypty Ghost, a Consentl ich nie blokuje (zob. Ograniczenia). Wyjątkami są Stripe.js (tylko przy włączonych płatnych członkostwach) i każdy <script>, który motyw umieszcza powyżej {{ghost_head}}.

Klucz witryny Consentl znajduje się na stronie Konfiguracja witryny w panelu. Nazwę hosta publikacji należy dodać w polu Domeny; www. i domena bez www liczą się jako ta sama witryna, więc nie trzeba osobno dodawać www..

Co obejmuje Państwa plan Consentl

• Free: baner, rejestr zgód i tylko ręczne blokowanie.
• Pro: dodaje Google Consent Mode v2.
• Business: dodaje automatyczne blokowanie znanych narzędzi śledzących i reguły blokowania dodane w panelu.

W planach Free i Pro wstrzymywane są tylko tagi oznaczone ręcznie.

A. Wstrzykiwanie kodu

1. Ghost Admin → Settings → Code injection (w Ghost 5 i 6 w sekcji Advanced; należy kliknąć Open).

2. W polu Site header należy wkleić skrypt ładujący jako pierwszy wiersz:

   <script src="https://api.consentl.com/v1/loader.js?k=SITE_KEY&l=en"></script>

   Jeżeli witryna korzysta również z szablonu Consentl GTM, należy dodać &gcm=ext do adresu URL, aby polecenia Consent Mode wysyłał tylko szablon.

3. Save.

4. Należy sprawdzić, czy motyw ma tagi <script> powyżej {{ghost_head}} w default.hbs. Jeżeli ładują one narzędzia śledzące, należy użyć metody B.

B. Motyw (naprawdę pierwszy)

1. Należy pobrać motyw: Settings → Site → Theme → Change theme → Installed, a następnie pobrać aktywny motyw z jego menu.

2. W default.hbs należy wkleić skrypt ładujący zaraz po <meta charset="utf-8">:

   <head>
       <meta charset="utf-8">
       <script src="https://api.consentl.com/v1/loader.js?k=SITE_KEY&l={{@site.locale}}"></script>

3. Należy spakować motyw do pliku zip i go przesłać. Jeżeli dodano wersję przez wstrzykiwanie kodu, należy ją usunąć.

Dodatki

• Link do ustawień plików cookie: należy dodać element nawigacji (Settings → Site → Navigation, nawigacja dodatkowa) z adresem URL #consentl. Linki, których adres URL kończy się na #consentl lub #consentl-preferences, oraz każdy element z atrybutem data-consentl-open otwierają preferencje.

• Deklaracja plików cookie: na stronie polityki plików cookie należy dodać kartę HTML:

  <div data-consentl-declaration data-api="https://api.consentl.com" data-key="SITE_KEY" data-locale="en"></div>
  <script src="https://api.consentl.com/v1/blocks.js" defer></script>

  Dla formularza wniosku dotyczącego danych osobowych lub unijnego formularza odstąpienia od umowy należy zamiast tego użyć data-consentl-request lub data-consentl-withdrawal. Formularz odstąpienia od umowy wymaga planu Pro lub wyższego i musi zostać włączony w panelu; w przeciwnym razie pozostaje pusty.

• Wstrzykiwanie kodu dla poszczególnych wpisów lub tagów działa po nagłówku witryny; nic nie trzeba tam dodawać.

Sprawdzenie działania

Należy otworzyć publikację w oknie prywatnym: pojawia się baner. W źródle strony widać, gdzie znajduje się skrypt ładujący.

Region odwiedzającego jest ustalany na podstawie jego adresu IP: Consentl ustala kraj w pamięci przy każdym wyświetleniu strony (nic nie jest zapisywane) i stosuje do niego Państwa regułę z panelu. Stany USA nie są rozróżniane: odwiedzający z USA otrzymują Państwa regułę dla całych USA lub, jeżeli jej nie ma, pierwszą regułę dla stanu USA. Nieznany kraj otrzymuje regułę dla nieznanych regionów (domyślnie opt-in).

Ograniczenia

• Atrybucja członków zapisuje historię przeglądania przed wyrażeniem zgody. Gdy w Ghost włączone jest śledzenie źródeł członków, member-attribution.min.js przechowuje strony wyświetlone przez odwiedzającego w sessionStorage (ghost-history) od pierwszego wyświetlenia strony, aby można było przypisać późniejszą rejestrację. Consentl tego nie wstrzymuje. Należy albo wyłączyć śledzenie źródeł członków (w ustawieniach analityki Ghost Admin; ustawienie nosi nazwę w rodzaju „Member sources” / „track member sources”, aktualną nazwę należy sprawdzić w swojej wersji Ghost), albo potraktować to jako własną decyzję prawną i opisać to w polityce plików cookie.

• Analityka internetowa Ghost (Tinybird, ghost-stats) nie używa plików cookie i jest ładowana przez sam Ghost; automatyczne blokowanie Consentl jej nie obejmuje. Jeżeli Państwa ocena prawna wymaga zgody, należy ją wyłączyć w Settings → Analytics.

• Stripe.js jest potrzebny do płatnych członkostw i jest ściśle niezbędny do płatności; nie jest blokowany.

• Portal (rejestracja i logowanie członków) nie jest blokowany. Na podstawie dokumentacji Ghost nie mogliśmy potwierdzić, z jakich plików cookie lub pamięci przeglądarki korzysta. Należy sprawdzić to w DevTools → Application (Cookies, Local Storage, Session Storage) przy pierwszej wizycie i po zalogowaniu, a znalezione elementy wymienić w deklaracji plików cookie.

• Tagi zapisane na stałe. <script src>, piksel <img> lub <iframe> zapisane we wstrzykiwanym kodzie, w motywie lub w karcie HTML są pobierane przez przeglądarkę, zanim jakikolwiek skrypt może je zatrzymać, nawet jeżeli Consentl uniemożliwia ich uruchomienie. Takie tagi należy oznaczyć ręcznie, a piksele <noscript> usunąć:

  <script type="text/plain" data-consentl="marketing" src="https://ads.example.com/tag.js"></script>
  <iframe data-consentl="marketing" data-src="https://www.youtube-nocookie.com/embed/ID" title="Video"></iframe>
  <img data-consentl="marketing" data-src="https://tracker.example.com/pixel.gif" alt="" width="1" height="1">

  Tagi ładowane przez kod (GTM, skrypt ładujący JavaScript piksela) są wstrzymywane bez żądania, gdy włączone jest automatyczne blokowanie (plan Business i wyższe).

• Ghost(Pro) Starter nie pozwala przesyłać własnych motywów, więc dostępna jest tylko metoda A.

Powiązane poradniki

• Każda strona internetowa (fragment kodu)
• Google Tag Manager
• Framer

Potrzebują Państwo pomocy? Prosimy pisać na adres support@consentl.com — odpowiadamy po angielsku w dni robocze.