Anpassade händelser

Allt du kan koppla en klickhanterare till kan vara en händelse.

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

Händelser visas i Översikt (kortet Händelser), i aktivitetsloggen för händelser, i trattar som steg och i kampanjrapporter när de matchar de aktiverade konverteringsmålen (eller alla anpassade händelser när inga mål är aktiverade). Egenskaper skickas med händelsen, men den aktuella aktivitetsloggtabellen visar dem inte.

Namngivning

Använd korta, stabila namn: signup, cta_click, newsletter_signup. Att byta namn senare delar upp din historik.

Läs in före anrop

Anropa track efter att det genererade spårarskriptet har körts. Det finns ingen inbyggd kö för anrop som görs före inläsningen. För vanlig HTML placerar du din applikations uppskjutna skript efter det uppskjutna Seean-skriptet; för ett ramverk följer du dess installationsguide.

För en nedladdningsknapp kopplar du hanteraren efter att knappen finns:

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

Det räknar klicket, inte ett bevis på att en nedladdning slutfördes. Valfri kedjning (optional chaining) förhindrar ett undantag när spåraren inte är tillgänglig, men sparar inte händelsen och försöker inte igen. En ignorerad besökare kan ha spårarmetoder som inte gör något, så att window.seean finns är i sig inte ett bevis på insamling.

För ett formulär anropar du spåraren i din befintliga väg för lyckad sändning:

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

Skicka inte också den här lyckade händelsen från klicket på skickaknappen: valideringen eller begäran kan misslyckas, och att koppla båda skulle räkna lyckade sändningar dubbelt. Behåll formulärets vanliga validering och felhantering.

Deklarativa klick och formulär

Lägg till data-seean-event="signup" på en knapp eller länk för att skicka den händelsen vid klick, inklusive klick på dess inbäddade element. På ett formulär skickar attributet vid sändning i stället för vid klick på dess fält. Dynamiska element fungerar genom delegerade lyssnare. Automatiska konverteringsförinställningar hoppar över markerade element för att undvika dubbelräkning; anropa inte också seean.track() för samma åtgärd. Deklarativa attribut behöver ingen data-conversions-aktivering. Namn måste vara icke-tomma, högst 64 tecken och inte pageview.

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

Lägg till data-seean-event-PROPERTY="value" på samma markerade element för att skicka en egenskap. Exemplet ovan skickar { "source": "footer" }. Attributvärden förblir strängar ("2" är inte talet 2); HTML normaliserar attributnamn till gemener. Bara uttryckligen prefixade attribut på det elementet läses. Egenskaper på föräldrar eller barn, formulärfältsvärden och orelaterade attribut samlas inte in. Att ändra ett attribut före en senare interaktion använder dess nya värde.

De befintliga egenskapsgränserna nedan gäller. En ogiltig nyckel, för många egenskaper eller ett för stort värde gör att insamlaren avvisar händelsen; värden kortas inte i tysthet. Använd JavaScript-API:et för typade tal, booleska värden eller null.

En klick- eller sändningshändelse bekräftar inte att din server slutförde åtgärden. Använd metoden med en hanterare för lyckat resultat ovan när du behöver den bekräftelsen.

Identifiera inloggade användare

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

identify(id, properties?) kopplar ditt eget användar-ID (1–64 tecken ur A–Z a–z 0–9 _ . : @ -, aldrig en e-postadress) till varje senare post från den öppna sidan och registrerar en identify-händelse med de valfria egenskaperna. Det har effekt bara för webbplatser som slagit på Identify users (Identifiera användare) under Settings → Installation; se Personer och retention.

Egenskapsgränser

Händelsenamn får vara upp till 64 tecken. Varje händelse kan innehålla upp till 20 egenskaper; det serialiserade egenskapsobjektet får inte överstiga 4 096 tecken. Egenskapsnycklar börjar med en bokstav och innehåller bara bokstäver, siffror eller understreck, upp till 64 tecken. Värden kan vara en sträng på upp till 512 tecken, ett ändligt tal, ett booleskt värde eller null. Kapslade objekt och arrayer avvisas.

Använd icke-känsliga etiketter som en formulärplats eller produktkategori. Skicka aldrig lösenord, e-postadresser, betalningsuppgifter eller privata token. Egenskaper är för närvarande inte tillgängliga som kolumner i aktivitetsloggen eller egenskapsfilter i instrumentpanelen; att skicka en egenskap skapar ingen ny rapportkontroll.

Verifiera en händelse

Utför åtgärden en gång och öppna den valda webbplatsens Events activity log (aktivitetslogg för händelser) i den aktuella perioden. Kontrollera dess namn, sökväg och antal. Anpassade händelser använder samma integritetssignaler, undantag och insamlingskvot som sidvisningar; en avvisad eller ignorerad begäran kan lämna ingen rad. En händelse med namnet pageview räknas som en sidvisning i stället för en anpassad händelse.

Om en rad saknas, kontrollera att skriptet är redo, begärans nyttolast och installationsfelsökningen. track() returnerar ingen bekräftelse på att lagringen lyckades, och spåraren har ingen beständig kö för omförsök.

404-sidor

Lägg till <meta name="seean:status" content="404"> på din sida för saknade sidor, så bär dess automatiska sidvisning status: 404 och visas under Pages → 404s (Sidor → 404) utan en andra händelse.

Att i stället anropa track("pageview", { status: 404 }) lägger till en andra sidvisning. Se 404-spårning.

Är något oklart? Kontakta supporten.