Aangepaste gebeurtenissen

Alles waar u een klik-handler aan kunt koppelen, kan een gebeurtenis zijn.

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

Gebeurtenissen verschijnen in het Overzicht (kaart Gebeurtenissen), in het activiteitenlog van gebeurtenissen, in funnels als stappen en in campagnerapporten wanneer ze overeenkomen met de ingeschakelde conversiedoelen (of alle aangepaste gebeurtenissen wanneer geen doelen zijn ingeschakeld). Eigenschappen worden met de gebeurtenis verzonden, maar de huidige tabel van het activiteitenlog toont ze niet.

Naamgeving

Gebruik korte, stabiele namen: signup, cta_click, newsletter_signup. Later hernoemen splitst uw geschiedenis.

Laden vóór het aanroepen

Roep track aan nadat het gegenereerde trackerscript is uitgevoerd. Er is geen ingebouwde wachtrij voor aanroepen vóór het laden. Plaats voor gewone HTML het uitgestelde script van uw applicatie na het uitgestelde Seean-script; volg voor een framework de bijbehorende installatiegids.

Koppel voor een downloadknop de handler nadat die knop bestaat:

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

Dit telt de klik, geen bewijs dat een download is voltooid. Optional chaining voorkomt een uitzondering wanneer de tracker niet beschikbaar is, maar slaat de gebeurtenis niet op en probeert die niet opnieuw. Een genegeerde bezoeker kan trackermethoden hebben die niets doen, dus de aanwezigheid van window.seean alleen bewijst niet dat er wordt verzameld.

Roep voor een formulier de tracker aan in uw bestaande pad voor een geslaagde verzending:

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

Stuur deze succesgebeurtenis niet ook vanuit de klik op de verzendknop: validatie of het verzoek kan mislukken, en beide koppelen zou geslaagde verzendingen dubbel tellen. Behoud de normale validatie en foutafhandeling van uw formulier.

Declaratieve klikken en formulieren

Voeg data-seean-event="signup" toe aan een knop of link om die gebeurtenis bij een klik te versturen, inclusief klikken op geneste elementen. Op een formulier verstuurt het attribuut bij verzending in plaats van bij klikken op de velden. Dynamische elementen werken via gedelegeerde listeners. Automatische conversievoorinstellingen slaan gemarkeerde elementen over om dubbel tellen te voorkomen; roep niet ook seean.track() aan voor dezelfde actie. Declaratieve attributen hebben geen data-conversions-opt-in nodig. Namen mogen niet leeg zijn, zijn maximaal 64 tekens en niet pageview.

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

Voeg data-seean-event-PROPERTY="value" toe aan hetzelfde gemarkeerde element om een eigenschap te versturen. Het voorbeeld hierboven verstuurt { "source": "footer" }. Attribuutwaarden blijven tekenreeksen ("2" is niet het getal 2); HTML normaliseert attribuutnamen naar kleine letters. Alleen expliciet voorafgegane attributen op dat element worden gelezen. Eigenschappen op bovenliggende of onderliggende elementen, waarden van formuliervelden en niet-gerelateerde attributen worden niet verzameld. Het wijzigen van een attribuut vóór een latere interactie gebruikt de nieuwe waarde.

De onderstaande eigenschapslimieten gelden. Een ongeldige sleutel, te veel eigenschappen of een te grote waarde zorgt ervoor dat de collector de gebeurtenis afwijst; waarden worden niet stilzwijgend afgekapt. Gebruik de JavaScript-API voor getypeerde getallen, booleans of null-waarden.

Een klik- of verzendgebeurtenis bevestigt niet dat uw server de actie heeft voltooid. Gebruik de bovenstaande methode met de succes-handler wanneer u die bevestiging nodig hebt.

Ingelogde gebruikers identificeren

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

identify(id, properties?) koppelt uw eigen gebruikers-ID (1–64 tekens uit A–Z a–z 0–9 _ . : @ -, nooit een e-mailadres) aan elk later record van de geopende pagina en registreert één identify-gebeurtenis met de optionele eigenschappen. Het heeft alleen effect voor websites die Identify users (Gebruikers identificeren) hebben ingeschakeld onder Settings → Installation; zie Personen en retentie.

Eigenschapslimieten

Gebeurtenisnamen accepteren maximaal 64 tekens. Elke gebeurtenis kan maximaal 20 eigenschappen bevatten; het geserialiseerde eigenschappenobject mag niet groter zijn dan 4.096 tekens. Eigenschapssleutels beginnen met een letter en bevatten alleen letters, cijfers of onderstrepingstekens, maximaal 64 tekens. Waarden kunnen een tekenreeks van maximaal 512 tekens, een eindig getal, een boolean of null zijn. Geneste objecten en arrays worden afgewezen.

Gebruik niet-gevoelige labels zoals een formulierlocatie of productcategorie. Stuur nooit wachtwoorden, e-mailadressen, betaalgegevens of privétokens. Eigenschappen zijn momenteel niet beschikbaar als kolommen in het activiteitenlog of als eigenschapsfilters in het dashboard; het versturen van een eigenschap maakt geen nieuw rapportbesturingselement aan.

Een gebeurtenis controleren

Voer de actie één keer uit en open het Events activity log (activiteitenlog van gebeurtenissen) van de geselecteerde website in de huidige periode. Controleer de naam, padnaam en het aantal. Aangepaste gebeurtenissen gebruiken dezelfde privacysignalen, uitsluitingen en verzamelquota als paginaweergaven; een afgewezen of genegeerd verzoek kan geen rij achterlaten. Een gebeurtenis met de naam pageview wordt als weergave geteld in plaats van als aangepaste gebeurtenis.

Als een rij ontbreekt, controleer dan of het script gereed is, de payload van het verzoek en de probleemoplossing voor installaties. track() geeft geen bevestiging terug dat de opslag is gelukt, en de tracker biedt geen permanente wachtrij voor nieuwe pogingen.

404-pagina’s

Voeg <meta name="seean:status" content="404"> toe aan uw niet-gevonden-pagina en de automatische paginaweergave draagt status: 404, zodat die onder Pages → 404s (Pagina’s → 404’s) verschijnt zonder tweede gebeurtenis.

In plaats daarvan track("pageview", { status: 404 }) aanroepen voegt een tweede paginaweergave toe. Zie 404-tracking.

Is iets onduidelijk? Neem contact op met de ondersteuning.