// Integracje / Framer

Visitant we Framerze

Framer ma osobne miejsce na skrypty, które działają na każdej podstronie. Wklejasz tam jedną linijkę, publikujesz i strona jest policzona - bez cookies i bez banera zgód.

Czego potrzebujesz

• Strona we Framerze na płatnym planie. Strony pomocy Framera, które sprawdziliśmy, nie wymieniają własnego kodu w tabeli planów, ale z naszego doświadczenia własny kod dla całej strony publikuje się tylko na płatnym planie (Basic albo Pro); plan Free nie pozwala też podpiąć własnej domeny.
• Dostęp edytora do projektu.
• Darmowe konto Visitant z dodaną domeną, np. twojastrona.pl.

Instalacja w 5 krokach

1. 01 Otwórz ustawienia strony

   W edytorze Framera kliknij ikonę ustawień (koło zębate) na górze płótna, żeby otworzyć ustawienia projektu. Pomoc Framera nazywa je Project Settings; starsze wersje i wiele poradników mówi Site Settings. Dokładne nazwy mogą się różnić w Twojej wersji.

2. 02 Przejdź do Custom Code

   Wybierz zakładkę Custom Code w lewym pasku. Jeśli nigdy nie dodawałeś kodu, kliknij Add Script; w przeciwnym razie ikonę +. Nadaj skryptowi nazwę, którą później rozpoznasz, np. Visitant.

   Framer daje cztery pozycje: początek lub koniec <head>, początek lub koniec <body>. Wybierz End of <head> tag.

3. 03 Wklej linijkę Visitant

   Wklej poniższą linijkę w pole skryptu i zamień twojastrona.pl na swoją domenę. Sam Framer radzi, żeby skrypty dla całej strony miały defer - linijka już go ma.

   <script defer data-domain="twojastrona.pl" src="https://annuora.com/v.js"></script>Kopiuj

4. 04 Opublikuj

   Kliknij Publish w prawym górnym rogu. Framer nie uruchamia własnego kodu na płótnie ani w podglądzie edytora - działa on tylko na opublikowanej stronie, więc przed publikacją nie ma czego oglądać.

   Publikujesz też pod adresem framer.app, nie tylko na swojej domenie? Wizyty z obu trafiają do domeny wpisanej w tagu. Jeśli chcesz je rozdzielić, dodaj adres Framera jako drugą stronę w Visitant (plan Free obejmuje 2 strony).

5. 05 Otwórz żywą stronę i poklikaj

   Otwórz opublikowaną domenę w zwykłej karcie przeglądarki i przejdź między kilkoma podstronami. Strony Framera nawigują jak aplikacja SPA: strona się nie przeładowuje, adres zmienia się przez history.pushState. Tracker Visitant opakowuje pushState i nasłuchuje popstate, więc każde przejście wewnątrz strony zapisuje jako odsłonę bez dodatkowego kodu.

Czy działa? Sprawdź w 60 sekund

Trzymaj panel Visitant w drugiej karcie. Wszystko poniżej powinno się wydarzyć w ciągu minuty od publikacji.

• Licznik osób teraz na górze panelu pokazuje 1, gdy jesteś na stronie.
• Przejdź na drugą podstronę wewnątrz strony (bez przeładowania): obie ścieżki pojawiają się w tabeli Strony, co potwierdza, że nawigacja SPA jest liczona.
• Naciśnij Wstecz w przeglądarce: poprzednia ścieżka dostaje jeszcze jedną odsłonę.
• Wejdź na stronę z linku w czacie albo w poście społecznościowym: tabela Źródła pokaże to źródło zamiast Direct.
• Kliknij żywą stronę prawym przyciskiem, Wyświetl źródło strony, wyszukaj v.js: linijka jest w <head>, raz.

Częste problemy

Po publikacji w panelu nic nie ma	Porównaj domenę w tagu z domeną strony w Visitant - muszą być identyczne, bez www. Potem otwórz żywą stronę w oknie prywatnym, żeby wykluczyć kopię z cache.
Licznik rośnie na pierwszej stronie, ale nie przy klikaniu dalej	Przeładuj stronę raz na twardo: tracker musi się załadować, zanim opakuje pushState. Jeśli problem zostaje, sprawdź, czy inny skrypt na stronie nie podmienia history.pushState po załadowaniu naszego.
Kod działa pod adresem framer.app, ale nie na mojej domenie	Domena publikuje się osobno. Kliknij Publish i upewnij się, że w oknie publikacji jest zaznaczona Twoja własna domena.
Widzę tylko własne wizyty	Wyklucz siebie: na swojej stronie otwórz konsolę przeglądarki i wykonaj raz localStorage.setItem("visitant_ignore","1"). Nic więcej się nie zmienia.

Pytania