Zdarzenia

Ekran Zdarzenia pokazuje zdarzenia, które Twoja witryna wysyła celowo: czy każde z nich jest nadal wywoływane, jak często, przez ilu użytkowników i z których stron.

Wyślij zdarzenie

Gdy fragment kodu Analytics Silktide znajduje się na stronie, wywołaj silktide z nazwą wszędzie tam, gdzie następuje interesujące Cię działanie: wysłanie formularza, odtworzenie filmu lub rejestracja.

document.querySelector("#newsletter-form").addEventListener("submit", () => {
  silktide("newsletter_signup");
});

Fragment kodu definiuje silktide przed załadowaniem skryptu Analytics, dlatego zdarzenie wysłane wcześniej zostaje umieszczone w kolejce i zarejestrowane, gdy skrypt będzie gotowy.

Wybierz nazwę, która pozostanie taka sama tak długo, jak śledzisz zdarzenie, na przykład newsletter_signup lub video_played. Nazwa jest używana przez filtry, eksporty, cele i API. Nie umieszczaj w niej danych osobowych: nigdy nie wpisuj w nazwie zdarzenia adresu e-mail, imienia i nazwiska ani numeru konta.

Skrypt Analytics już sam rejestruje niektóre zdarzenia pod poniższymi nazwami, dlatego nadaj swoim inną nazwę: page_load, page_update, page_return, click, download, frustration i field.

Wyślij szczegóły ze zdarzeniem

Przekaż obiekt jako drugi argument, aby podać więcej informacji o tym, co się stało: który akordeon został otwarty, który formularz wysłano, który film odtworzono. Każdy klucz w nim to właściwość zdarzenia.

document.querySelectorAll("details").forEach((accordion) => {
  accordion.addEventListener("toggle", () => {
    if (accordion.open) {
      silktide("open_accordion", {
        summary: accordion.querySelector("summary")?.textContent.trim() ?? "",
      });
    }
  });
});

Każda wartość jest rejestrowana jako tekst. Wysyłaj tekst, liczby albo wartości prawda i fałsz; obiekt ani lista we właściwości nie zostaną zarejestrowane w użytecznej formie.
Nie musisz wysyłać adresu strony. Każde zdarzenie rejestruje już stronę, z której zostało wysłane.
Zachowaj tę samą nazwę właściwości tak długo, jak ją śledzisz, i nie umieszczaj danych osobowych w wartościach, tak jak nie umieszczał(a)byś ich w nazwie zdarzenia.
event, time i pageUrl są używane przez sam skrypt, więc nie są rejestrowane jako właściwości.

Co pokazuje ekran

Twoje zdarzenia to cztery najczęstsze zdarzenia z wybranego okresu, przedstawione jako karty. Każda pokazuje, jak często zdarzenie zostało wysłane, ilu użytkowników je wysłało, ile razy na użytkownika, jego przebieg w okresie oraz kiedy było ostatnio widziane. Przy włączonym porównywaniu liczba pokazuje zmianę względem poprzedniego okresu.
Kropka obok Ostatnio widziane zmienia kolor na bursztynowy, gdy zdarzenie nie zostało wysłane od ponad trzech dni. Zdarzenie, które przestało się pojawiać, mogło zostać przypadkowo usunięte z witryny.
Wygląda na test oznacza zdarzenie wysłane trzy razy lub mniej przez jednego użytkownika, co zwykle oznacza, że ktoś je testuje.
Gdzie jest wywoływane zawiera strony, z których wysłano zdarzenie, zaczynając od najczęstszych. Wybierz inne zdarzenie, aby zobaczyć jego strony, otwórz ścieżki, które je obejmują, lub wybierz Zobacz każdą stronę, aby wyświetlić pełną listę stron zdarzenia.
Rejestrowane automatycznie zawiera zdarzenia rejestrowane przez sam skrypt. Każde z nich prowadzi do ekranu, który je opisuje: ładowania stron do Stron, kliknięcia do Kliknięć, frustracja do Frustracji, a pobrania do Pobrań.
Tabela zawiera wszystkie zdarzenia wysyłane przez Twoją witrynę, wraz z informacją o tym, kiedy każde z nich było widziane po raz pierwszy i ostatni. Otwórz wiersz, aby zobaczyć szczegóły zdarzenia, lub użyj jego menu, aby zobaczyć ścieżki albo przefiltrować wszystkie ekrany według tego zdarzenia.

Osoby, które mogą administrować Analytics, mogą nadać zdarzeniu czytelną nazwę w tabeli. Nazwa obowiązuje na całym koncie; filtry i eksporty nadal używają nazwy wysyłanej przez witrynę.

Szczegóły zdarzenia

Otwórz zdarzenie z tabeli, aby zobaczyć je osobno: jak często było wysyłane w danym okresie, skąd pochodzili jego użytkownicy oraz Ścieżki przez to zdarzenie, które pokazują stronę, na której użytkownicy byli, gdy zdarzenie zostało wysłane, oraz dokąd przeszli później. Działa to tak samo jak Ścieżki przez tę stronę.

Strony, z których zostało wysłane zawierają wszystkie strony, z których wysłano zdarzenie, zaczynając od najczęstszych. Wyszukaj stronę lub otwórz szczegóły strony albo sprawdź ją w menu wiersza.

W przypadku zdarzenia wysłanego z właściwościami szczegóły pokazują również:

Z czym zostało wysłane klasyfikuje wartości jednej właściwości, zaczynając od najczęściej wysyłanych, wraz z liczbą wysłania każdej z nich. Wybierz inną właściwość z menu nad listą. Wybierz wartość, aby wyświetlić tylko przypadki wysłania zdarzenia z tą wartością, a następnie wybierz ją ponownie, aby wyświetlić wszystkie przypadki.
Każde wysłanie zawiera każdy przypadek wysłania zdarzenia, zaczynając od najnowszych: kiedy, z której strony oraz każdą właściwość w osobnej kolumnie. Wyszukaj stronę lub wartość albo otwórz wiersz, aby zobaczyć wizytę, której częścią było zdarzenie.

Pobierz szczegóły zdarzenia przez API

Interfejs REST API Silktide udostępnia te same szczegóły, dzięki czemu możesz raportować je we własnych narzędziach. Każdy punkt końcowy przyjmuje nazwę zdarzenia jako event, a także zakres dat i filtry obsługiwane przez każdy punkt końcowy Analytics:

analytics/event-properties zawiera właściwości, z którymi wysłano zdarzenie.
analytics/event-property-values klasyfikuje wartości jednej właściwości. Podaj nazwę właściwości jako property.
analytics/event-occurrences zawiera każdy przypadek wysłania zdarzenia, zaczynając od najnowszych. Każdy wiersz zawiera time (znacznik czasu Unix w sekundach), stronę jako url, wizytę, której był częścią, jako sessionId oraz jej properties. Dodaj property i value, aby wyświetlić tylko przypadki wysłania zdarzenia z tą wartością.

Utwórz klucz na ekranie API; pełne struktury żądań oraz informacje o tym, jak wysyłać zdarzenia z witryny, znajdziesz w dokumentacji dla deweloperów.

Używaj zdarzeń w celach

Cel może zostać osiągnięty, gdy użytkownik wywoła zdarzenie. Zobacz Lejki i cele.

Jeśli zdarzenie się nie pojawia

Sprawdź, czy fragment kodu Analytics znajduje się na stronie wysyłającej zdarzenie, czy kod wywołujący silktide jest uruchamiany oraz czy wybrany zakres dat obejmuje dzisiejszy dzień.