Zdarzenia niestandardowe

Wszystko, do czego możesz podłączyć obsługę kliknięcia, może być zdarzeniem.

window.seean.track("signup");
window.seean.track("download", { file: "pricing.pdf" });

Zdarzenia pojawiają się w Przeglądzie (karta Zdarzenia), w dzienniku aktywności Events, w ścieżkach konwersji jako kroki oraz w raportach kampanii, gdy pasują do włączonych celów konwersji (lub wszystkie zdarzenia niestandardowe, gdy żaden cel nie jest włączony). Właściwości są wysyłane ze zdarzeniem, ale obecna tabela dziennika aktywności ich nie wyświetla.

Nazewnictwo

Używaj krótkich, stabilnych nazw: signup, cta_click, newsletter_signup. Późniejsza zmiana nazwy dzieli historię.

Wczytaj przed wywołaniem

Wywołuj track po wykonaniu wygenerowanego skryptu śledzącego. Nie ma wbudowanej kolejki dla wywołań wykonanych przed wczytaniem. W zwykłym HTML umieść odroczony skrypt aplikacji po odroczonym skrypcie Seean; w przypadku frameworka postępuj zgodnie z jego przewodnikiem instalacji.

Dla przycisku pobierania podłącz obsługę po tym, jak przycisk istnieje:

document.querySelector("#download-pricing")?.addEventListener("click", () => {
  window.seean?.track("download", { file: "pricing.pdf" });
});

To liczy kliknięcie, a nie dowód zakończenia pobierania. Opcjonalne łączenie zapobiega wyjątkowi, gdy skrypt śledzący jest niedostępny, ale nie zapisuje ani nie ponawia zdarzenia. Ignorowany odwiedzający może mieć puste metody skryptu śledzącego, więc sama obecność window.seean nie jest dowodem zbierania.

Dla formularza wywołaj skrypt śledzący w istniejącej ścieżce udanego wysłania:

// After your server has confirmed the newsletter signup succeeded:
window.seean?.track("newsletter_signup", { form: "footer" });

Nie wysyłaj tego zdarzenia sukcesu również z kliknięcia przycisku wysyłania: walidacja lub żądanie mogą się nie powieść, a podłączenie obu liczyłoby udane wysłania podwójnie. Zachowaj normalną walidację i obsługę błędów formularza.

Deklaratywne kliknięcia i formularze

Dodaj data-seean-event="signup" do przycisku lub linku, aby wysyłać to zdarzenie po kliknięciu, łącznie z kliknięciami w jego zagnieżdżone elementy. Na formularzu atrybut wysyła przy wysłaniu zamiast kliknięć w jego pola. Elementy dynamiczne działają dzięki delegowanym nasłuchiwaczom. Automatyczne szablony konwersji pomijają oznaczone elementy, aby uniknąć podwójnego liczenia; nie wywołuj też seean.track() dla tej samej akcji. Atrybuty deklaratywne nie wymagają opcji data-conversions. Nazwy muszą być niepuste, mieć najwyżej 64 znaki i nie być pageview.

<button data-seean-event="download" data-seean-event-source="footer">Download</button>
<form data-seean-event="contact_submit">…</form>

Dodaj data-seean-event-PROPERTY="value" do tego samego oznaczonego elementu, aby wysłać właściwość. Powyższy przykład wysyła { "source": "footer" }. Wartości atrybutów pozostają ciągami ("2" nie jest liczbą 2); HTML normalizuje nazwy atrybutów do małych liter. Odczytywane są tylko jawnie poprzedzone prefiksem atrybuty tego elementu. Właściwości przodków lub potomków, wartości pól formularza i niepowiązane atrybuty nie są zbierane. Zmiana atrybutu przed późniejszą interakcją używa jego nowej wartości.

Obowiązują poniższe limity właściwości. Nieprawidłowy klucz, zbyt wiele właściwości lub zbyt duża wartość powodują odrzucenie zdarzenia przez moduł zbierający; wartości nie są po cichu skracane. Użyj API JavaScript dla typowanych wartości liczbowych, logicznych lub null.

Zdarzenie kliknięcia lub wysłania nie potwierdza, że serwer wykonał akcję. Użyj powyższej metody z obsługą sukcesu, gdy potrzebujesz tego potwierdzenia.

Identyfikacja zalogowanych użytkowników

window.seean?.identify("user_42", { plan: "pro" });

identify(id, properties?) dołącza Twój własny identyfikator użytkownika (1–64 znaki z A–Z a–z 0–9 _ . : @ -, nigdy adres e-mail) do każdego późniejszego rekordu z otwartej strony i rejestruje jedno zdarzenie identify z opcjonalnymi właściwościami. Działa tylko dla witryn, które włączyły Identify users (Identyfikuj użytkowników) w Settings → Installation; zobacz Osoby i retencja.

Limity właściwości

Nazwy zdarzeń przyjmują do 64 znaków. Każde zdarzenie może zawierać do 20 właściwości; zserializowany obiekt właściwości nie może przekraczać 4 096 znaków. Klucze właściwości zaczynają się literą i zawierają tylko litery, cyfry lub podkreślenia, do 64 znaków. Wartości mogą być ciągiem do 512 znaków, skończoną liczbą, wartością logiczną lub null. Zagnieżdżone obiekty i tablice są odrzucane.

Używaj niewrażliwych etykiet, takich jak położenie formularza lub kategoria produktu. Nigdy nie wysyłaj haseł, adresów e-mail, danych płatniczych ani prywatnych tokenów. Właściwości nie są obecnie dostępne jako kolumny dziennika aktywności ani filtry właściwości w panelu; wysłanie właściwości nie tworzy nowej kontrolki raportu.

Weryfikacja zdarzenia

Wykonaj akcję raz i otwórz dziennik aktywności Events wybranej witryny w bieżącym okresie. Sprawdź jego nazwę, ścieżkę i liczbę. Zdarzenia niestandardowe używają tych samych sygnałów prywatności, wykluczeń i limitu zbierania co odsłony; odrzucone lub zignorowane żądanie może nie pozostawić wiersza. Zdarzenie o nazwie pageview jest liczone jako odsłona, a nie zdarzenie niestandardowe.

Jeśli brakuje wiersza, sprawdź gotowość skryptu, ładunek żądania i rozwiązywanie problemów z instalacją. track() nie zwraca potwierdzenia, że zapis się powiódł, a skrypt śledzący nie udostępnia trwałej kolejki ponownych prób.

Strony 404

Dodaj <meta name="seean:status" content="404"> do strony „nie znaleziono”, a jej automatyczna odsłona będzie nosić status: 404, więc pojawi się w sekcji Pages → 404s bez drugiego zdarzenia.

Wywołanie track("pageview", { status: 404 }) zamiast tego dodaje drugą odsłonę. Zobacz śledzenie 404.

Coś jest niejasne? Skontaktuj się z pomocą.