Consentl we Framer

Dodaj Consentl za pomocą własnego kodu Framer w miejscu „Start of <head> tag”, które uruchamia go przed skryptami Framer, i zastąp komponent Cookie Banner Framer.

Skrypt ładujący jako pierwszy w <head>: Zależy od metody

Czy skrypt ładujący może być pierwszy w <head>? Prawie. Framer ma umiejscowienie „Start of <head> tag”, które umieszcza skrypt ładujący przed skryptami Framer; przed nim znajdują się tylko tagi meta i charset Framer. Środowisko uruchomieniowe Framer to <script type="module" async> w body. Nie jest odroczone, ale i tak uruchamia się po synchronicznym skrypcie ładującym na początku <head>, ponieważ skrypt ładujący jest pierwszy w kolejności dokumentu. Dzięki temu Framer jest kreatorem no-code najbliższym zalecanej konfiguracji.

Wymagania

Płatny plan witryny z własną domeną. Własny kod działa tylko na opublikowanej witrynie.
Klucz witryny Consentl, dostępny na stronie Konfiguracja witryny w panelu. Nazwę hosta witryny 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.

Instalacja

W projekcie Framer należy otworzyć Project Settings → Custom Code i dodać fragment kodu.
Należy wkleić:
```
<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.
Placement: Start of <head> tag.
Pages: wszystkie strony.
Run: Once. Framer nawiguje po stronie klienta, a nawigacja po stronie klienta nie powoduje utraty banera. „Run on every page visit” wstrzykiwałoby skrypt ładujący ponownie przy każdej nawigacji. Adres URL skryptu ładującego powinien być identyczny na każdej stronie.
Jeżeli używali Państwo komponentu Cookie Banner Framer, należy usunąć go ze stron. Aktywny powinien być tylko jeden baner.
- Komponent Cookie Banner wysyłał również wywołania default i update Google Consent Mode. Jeżeli tagi GTM lub Google z nich korzystały, w planie Pro i wyższych zastępuje je Consent Mode Consentl.
- W planie Free po usunięciu komponentu nie ma wywołań Consent Mode. Fragment kodu GTM lub tagu Google należy oznaczyć ręcznie (<script type="text/plain" data-consentl="analytics">…</script>, z kategorią odpowiadającą temu, co ładuje), aby uruchamiał się dopiero po wyrażeniu zgody.
Publish.
Opcjonalnie: do komponentu stopki należy dodać link z adresem URL #consentl („Ustawienia plików cookie”). Linki, których adres URL kończy się na #consentl lub #consentl-preferences, oraz każdy element z atrybutem data-consentl-open otwierają preferencje.

Sprawdzenie działania

Należy przetestować opublikowaną witrynę w oknie prywatnym. Własny kod nie działa na kanwie ani w podglądzie.

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).

Języki

Wersje językowe (locales) Framer współdzielą własny kod całej witryny. Można pominąć &l=…, aby używać domyślnego języka z panelu, albo dodać fragment kodu dla każdej strony lub wersji językowej w Page settings → Custom Code, zachowując identyczny adres URL na każdej stronie danej wersji językowej.

Na stronie polityki plików cookie należy użyć komponentu Embed (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.
Framer renderuje komponent Embed jako osadzony kod HTML. Należy sprawdzić na opublikowanej witrynie, czy tabela się pojawia.
Jeżeli nie, należy zamiast tego podlinkować hostowaną deklarację plików cookie: https://api.consentl.com/p/SITE_KEY/cookies (publiczna strona, zawsze zsynchronizowana z panelem; dla innego języka należy dodać ?l=de).

Ograniczenia

Własne tagi meta i charset Framer nadal znajdują się przed fragmentem kodu. Są nieszkodliwe.
Framer Analytics nie używa plików cookie i jest ładowane przez Framer; Consentl go nie kontroluje.
Integracje śledzące w Project Settings (Integrations), takie jak Google Analytics, są wstrzykiwane przez Framer i mogą nie być blokowane przez Consentl. Lepiej dodawać tagi Google przez GTM lub jako własny kod umieszczony po fragmencie kodu Consentl. Consentl wstrzymuje rozpoznane narzędzia śledzące ładowane po nim (plan Business i wyższe); w planach Free i Pro wstrzymywane są tylko tagi oznaczone ręcznie.
Tagi zapisane na stałe. <script src>, piksel <img> lub <iframe> zapisane we własnym kodzie lub w komponencie Embed 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.

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