Izsekošanas un notikumu dokumentācija

Viss nepieciešamais, lai instalētu ClearAnalytics savā vietnē un izsekotu lapu skatījumus, pielāgotus notikumus, klikšķu mērķus un e-komercijas darījumus.

Pārskats

ClearAnalytics piedāvā divus izsekošanas skriptu variantus. Izvēlieties sev piemērotāko: minimālu skriptu pamata lapu skatījumu analītikai vai pilnībā aprīkotu skriptu pielāgotiem notikumiem, klikšķu mērķiem un e-komercijas izsekošanai.

Vieglais skripts (ca.js)

Vieglākais iespējamais izsekošanas skripts. Ideāls blogiem, mērķlapām un vietnēm, kurām nepieciešama tikai lapu skatījumu analītika.

ca.js < 1 KB

Automātiska lapu skatījumu izsekošana
Sesijas ilgums un atlēcienu rādītājs
UTM kampaņu parametru tveršana
Vienas lapas lietotņu atbalsts

Pilnais skripts (ca-events.js)

Viss, kas ir vieglajā skriptā, plus pielāgoti notikumi, klikšķu mērķu izsekošana, GA4 dataLayer pārtveršana un pilns e-komercijas atbalsts.

ca-events.js < 2 KB

Viss, kas ir vieglajā skriptā
Pielāgotu notikumu izsekošana caur window.ca()
Klikšķu mērķu izsekošana caur data-ca-goal
GA4 dataLayer integrācija
Pilna e-komercijas notikumu izsekošana

Instalēšana

Pievienojiet vienu script tagu savai vietnei. Bez npm pakotnēm, bez būvēšanas rīkiem, bez konfigurācijas failiem. Skripts ielādējas asinhroni un neietekmē lapas veiktspēju.

HTML — Vieglais skripts

Pievienojiet to <head> vai <body> beigās katrā lapā. Automātiski izseko lapu skatījumus, sesijas ilgumu un UTM parametrus.

<script defer src="https://clearanalytics.eu/js/ca.js"></script>

HTML — Pilnais skripts

Izmantojiet šo variantu, ja nepieciešami pielāgoti notikumi, klikšķu mērķi vai e-komercijas izsekošana.

<script defer src="https://clearanalytics.eu/js/ca-events.js"></script>

HTML — Pilnais skripts ar DataLayer

Pievienojiet atribūtu data-ca-datalayer, lai automātiski pārtvertu GA4 dataLayer notikumus, ieskaitot visus e-komercijas notikumus.

<script defer src="https://clearanalytics.eu/js/ca-events.js" data-ca-datalayer></script>

WordPress

Pievienojiet script tagu caur savas tēmas functions.php failu vai izmantojiet galvenes/kājenes ievietošanas spraudni.

// functions.php
add_action('wp_head', function () {
    echo '<script defer src="https://clearanalytics.eu/js/ca-events.js"></script>';
});

React / Next.js

Izmantojiet Next.js Script komponentu optimālai ielādei. Skripts darbojas ar jebkuru React ietvaru.

// app/layout.tsx  (Next.js App Router)
import Script from 'next/script';

export default function RootLayout({ children }) {
  return (
    <html>
      <head>
        <Script
          src="https://clearanalytics.eu/js/ca-events.js"
          strategy="afterInteractive"
        />
      </head>
      <body>{children}</body>
    </html>
  );
}

Vue / Nuxt

Pievienojiet skriptu caur Nuxt konfigurāciju vai tieši HTML veidnē vienkāršām Vue lietotnēm.

// nuxt.config.ts
export default defineNuxtConfig({
  app: {
    head: {
      script: [
        {
          src: 'https://clearanalytics.eu/js/ca-events.js',
          defer: true,
        },
      ],
    },
  },
});

Google Tag Manager

Skriptu var izvietot arī caur Google Tag Manager, izmantojot Custom HTML tagu.

Tag Type:   Custom HTML
Trigger:    All Pages

<script defer src="https://clearanalytics.eu/js/ca-events.js" data-ca-datalayer></script>

Izmantojot GTM ar atribūtu data-ca-datalayer, ClearAnalytics automātiski tvers visus dataLayer notikumus, ko nosūta jūsu esošie GTM tagi.

Pielāgoti notikumi

Izsekojiet jebkuru lietotāja mijiedarbību, nosūtot pielāgotus notikumus ar izvēles metadatiem. Pielāgoti notikumi parādās jūsu vadības panelī un var tikt izmantoti kā mērķu aktivizētāji.

Nepieciešams pilnais skripts (ca-events.js).

API paraksts

window.ca(eventName, properties?);

Parametrs	Tips	Apraksts
`eventName`	string	Aprakstošs notikuma nosaukums (piem., 'signup', 'file_download').
`properties`	object	Izvēles objekts ar papildu metadatiem. Serializēts kā JSON.

Piemēri

// Reģistrācijas izsekošana ar plāna informāciju

window.ca('signup', { plan: 'pro' });

// Failu lejupielādes izsekošana

window.ca('file_download', {
  file_name: 'whitepaper.pdf',
  file_type: 'pdf',
});

// Video atskaņošanas izsekošana

window.ca('video_play', {
  video_title: 'Product Demo',
  duration: 120,
});

// Iekšējās meklēšanas izsekošana

window.ca('search', { query: 'privacy analytics' });

Klikšķu mērķu izsekošana

Izsekojiet pogu un saišu klikšķus bez JavaScript rakstīšanas. Pievienojiet atribūtu data-ca-goal jebkuram HTML elementam, un klikšķis tiks automātiski reģistrēts.

Nepieciešams pilnais skripts (ca-events.js).

Lietošana

Pievienojiet data-ca-goal="goal-name" jebkuram noklikšķināmam elementam. Atribūta vērtība kļūst par mērķa identifikatoru jūsu vadības panelī.

<button data-ca-goal="cta-signup">Sign Up</button>

<a href="/pricing" data-ca-goal="pricing-click">View Pricing</a>

<form data-ca-goal="contact-form-submit">
  <!-- The goal fires when any element inside is clicked -->
  <button type="submit">Send</button>
</form>

Kā tas darbojas

Skripts izmanto notikumu delegēšanu uz dokumentu efektīvai klikšķu noteikšanai:

Klikšķa notikums aktivizējas jebkurā lapas vietā.
Skripts virzās augšup pa DOM koku no noklikšķinātā elementa, meklējot atribūtu data-ca-goal.
Ja atrasts, tiek nosūtīts klikšķa notikums ar mērķa nosaukumu kā selektoru.

Klikšķu mērķu skatīšana

Klikšķu mērķu notikumi parādās jūsu vadības paneļa Mērķu lapā. Izveidojiet mērķi ar tipu "Click" un sasaistiet to ar data-ca-goal vērtību, ko izmantojāt savā HTML.

GA4 DataLayer integrācija

Ja jūsu vietne jau nosūta notikumus uz Google Analytics dataLayer, ClearAnalytics var automātiski pārtvert šos notikumus. Tas ir vienkāršākais migrācijas ceļš no GA4.

Nepieciešams pilnais skripts (ca-events.js).

DataLayer pārtveršanas iespējošana

Pievienojiet atribūtu data-ca-datalayer script tagam. Šī opt-in pieeja nodrošina, ka funkcija aktivizējas tikai tad, kad jūs to tieši iespējojat.

<script defer src="https://clearanalytics.eu/js/ca-events.js" data-ca-datalayer></script>

Kā tas darbojas

Kad iespējots, skripts pārtver visus dataLayer.push() izsaukumus:

Atpazītie e-komercijas notikumi (purchase, add_to_cart utt.) tiek pārsūtīti kā e-komercijas notikumi.
Visi pārējie pielāgotie notikumi tiek pārsūtīti kā vispārīgi pielāgoti notikumi.
GTM iekšējie notikumi (gtm.js, gtm.dom, gtm.load utt.) tiek automātiski izfiltrēti.
Esošie dataLayer ieraksti tiek apstrādāti lapas ielādes laikā; nākotnes ieraksti tiek pārtvērti reāllaikā.

Piemērs

// These dataLayer pushes are automatically captured
dataLayer.push({
  event: 'form_submit',
  form_id: 'contact',
  form_name: 'Contact Form',
});

dataLayer.push({
  event: 'video_start',
  video_title: 'Product Demo',
  video_duration: 120,
});

Ignorētie notikumi

Šie GTM iekšējie notikumi tiek automātiski ignorēti un neparādīsies jūsu vadības panelī:

// These GTM internal events are automatically filtered out:
gtm.js, gtm.dom, gtm.load, gtm.click, gtm.linkClick, gtm.scrollDepth

E-komercijas izsekošana

Izsekojiet pilnu klienta ceļu no produktu pārlūkošanas līdz pirkumam un atmaksai. ClearAnalytics atbalsta visus 14 standarta e-komercijas notikumus, izmantojot to pašu dataLayer formātu kā GA4.

Nepieciešams pilnais skripts (ca-events.js) ar atribūtu data-ca-datalayer.

Visi e-komercijas notikumi izmanto ar GA4 saderīgu dataLayer.push() formātu. Ja jums jau ir ieviesta GA4 e-komercijas izsekošana, ClearAnalytics automātiski tvers šos notikumus bez koda izmaiņām.

Notikums	Apraksts
`view_item_list`	Lietotājs skata produktu sarakstu vai meklēšanas rezultātus.
`select_item`	Lietotājs noklikšķina uz produkta sarakstā.
`view_item`	Lietotājs skata produkta detaļu lapu.
`add_to_cart`	Lietotājs pievieno produktu iepirkumu grozam.
`remove_from_cart`	Lietotājs noņem produktu no groza.
`view_cart`	Lietotājs skata iepirkumu grozu.
`add_to_wishlist`	Lietotājs pievieno produktu vēlmju sarakstam.
`begin_checkout`	Lietotājs sāk norēķinu procesu.
`add_shipping_info`	Lietotājs iesniedz piegādes informāciju.
`add_payment_info`	Lietotājs iesniedz maksājuma informāciju.
`purchase`	Lietotājs pabeidz pirkumu.
`refund`	Tiek apstrādāta pilna vai daļēja atmaksa.
`view_promotion`	Lietotājs redz reklāmas baneri vai piedāvājumu.
`select_promotion`	Lietotājs noklikšķina uz akcijas.

view_item_list

Aktivizējiet šo notikumu, kad lietotāji redz produktu sarakstu, piemēram, kategorijas lapu vai meklēšanas rezultātus.

dataLayer.push({ ecommerce: null }); // Clear previous data
dataLayer.push({
  event: 'view_item_list',
  ecommerce: {
    item_list_id: 'category_results',
    item_list_name: 'Category Results',
    items: [
      {
        item_id: 'SKU-001',
        item_name: 'Running Shoes',
        item_brand: 'SportCo',
        item_category: 'Footwear',
        price: 89.99,
        index: 0,
      },
      {
        item_id: 'SKU-002',
        item_name: 'Trail Shoes',
        item_brand: 'SportCo',
        item_category: 'Footwear',
        price: 119.99,
        index: 1,
      },
    ],
  },
});

select_item

Aktivizējiet šo notikumu, kad lietotājs noklikšķina uz konkrēta produkta sarakstā, lai to apskatītu.

dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'select_item',
  ecommerce: {
    item_list_id: 'category_results',
    item_list_name: 'Category Results',
    items: [{
      item_id: 'SKU-001',
      item_name: 'Running Shoes',
      item_brand: 'SportCo',
      price: 89.99,
      index: 0,
    }],
  },
});

view_item

Aktivizējiet šo notikumu, kad lietotājs nonāk produkta detaļu lapā.

dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'view_item',
  ecommerce: {
    currency: 'EUR',
    value: 89.99,
    items: [{
      item_id: 'SKU-001',
      item_name: 'Running Shoes',
      item_brand: 'SportCo',
      item_category: 'Footwear',
      item_variant: 'Blue / Size 42',
      price: 89.99,
      quantity: 1,
    }],
  },
});

add_to_cart

Aktivizējiet šo notikumu, kad lietotājs pievieno vienu vai vairākus produktus iepirkumu grozam.

dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'add_to_cart',
  ecommerce: {
    currency: 'EUR',
    value: 89.99,
    items: [{
      item_id: 'SKU-001',
      item_name: 'Running Shoes',
      item_brand: 'SportCo',
      price: 89.99,
      quantity: 1,
    }],
  },
});

remove_from_cart

Aktivizējiet šo notikumu, kad lietotājs noņem produktu no groza.

dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'remove_from_cart',
  ecommerce: {
    currency: 'EUR',
    value: 89.99,
    items: [{
      item_id: 'SKU-001',
      item_name: 'Running Shoes',
      price: 89.99,
      quantity: 1,
    }],
  },
});

view_cart

Aktivizējiet šo notikumu, kad lietotājs skata iepirkumu groza lapu.

dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'view_cart',
  ecommerce: {
    currency: 'EUR',
    value: 209.98,
    items: [
      { item_id: 'SKU-001', item_name: 'Running Shoes', price: 89.99, quantity: 1 },
      { item_id: 'SKU-003', item_name: 'Sports Watch', price: 119.99, quantity: 1 },
    ],
  },
});

add_to_wishlist

Aktivizējiet šo notikumu, kad lietotājs saglabā produktu vēlmju sarakstā vēlākam.

dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'add_to_wishlist',
  ecommerce: {
    currency: 'EUR',
    value: 89.99,
    items: [{
      item_id: 'SKU-001',
      item_name: 'Running Shoes',
      price: 89.99,
    }],
  },
});

begin_checkout

Aktivizējiet šo notikumu, kad lietotājs sāk norēķinu plūsmu.

dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'begin_checkout',
  ecommerce: {
    currency: 'EUR',
    value: 209.98,
    coupon: 'SUMMER20',
    items: [
      { item_id: 'SKU-001', item_name: 'Running Shoes', price: 89.99, quantity: 1 },
      { item_id: 'SKU-003', item_name: 'Sports Watch', price: 119.99, quantity: 1 },
    ],
  },
});

add_shipping_info

Aktivizējiet šo notikumu, kad lietotājs izvēlas vai iesniedz piegādes datus norēķinu laikā.

dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'add_shipping_info',
  ecommerce: {
    currency: 'EUR',
    value: 209.98,
    shipping_tier: 'Express',
    items: [
      { item_id: 'SKU-001', item_name: 'Running Shoes', price: 89.99, quantity: 1 },
      { item_id: 'SKU-003', item_name: 'Sports Watch', price: 119.99, quantity: 1 },
    ],
  },
});

add_payment_info

Aktivizējiet šo notikumu, kad lietotājs izvēlas vai iesniedz maksājuma veidu norēķinu laikā.

dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'add_payment_info',
  ecommerce: {
    currency: 'EUR',
    value: 209.98,
    payment_type: 'Credit Card',
    items: [
      { item_id: 'SKU-001', item_name: 'Running Shoes', price: 89.99, quantity: 1 },
      { item_id: 'SKU-003', item_name: 'Sports Watch', price: 119.99, quantity: 1 },
    ],
  },
});

purchase

Aktivizējiet šo notikumu, kad pirkums ir apstiprināts. Iekļaujiet transaction_id, value, currency, tax, shipping un pilnu items masīvu.

dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'purchase',
  ecommerce: {
    transaction_id: 'TXN-20260219-001',
    affiliation: 'Online Store',
    value: 209.98,
    tax: 36.49,
    shipping: 5.99,
    currency: 'EUR',
    coupon: 'SUMMER20',
    items: [
      {
        item_id: 'SKU-001',
        item_name: 'Running Shoes',
        item_brand: 'SportCo',
        item_category: 'Footwear',
        item_variant: 'Blue / Size 42',
        price: 89.99,
        quantity: 1,
        coupon: '',
      },
      {
        item_id: 'SKU-003',
        item_name: 'Sports Watch',
        item_brand: 'FitTech',
        item_category: 'Electronics',
        item_variant: 'Black',
        price: 119.99,
        quantity: 1,
        coupon: '',
      },
    ],
  },
});

refund

Aktivizējiet šo notikumu, kad tiek apstrādāta atmaksa. Pilnai atmaksai nepieciešams tikai transaction_id. Daļējām atmaksām iekļaujiet konkrētus produktus.

// Full refund
dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'refund',
  ecommerce: {
    transaction_id: 'TXN-20260219-001',
  },
});

// Partial refund (specific items)
dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'refund',
  ecommerce: {
    transaction_id: 'TXN-20260219-001',
    items: [{
      item_id: 'SKU-001',
      quantity: 1,
    }],
  },
});

view_promotion

Aktivizējiet šo notikumu, kad reklāmas baneris, karuselis vai piedāvājums kļūst redzams lietotājam.

dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'view_promotion',
  ecommerce: {
    creative_name: 'Spring Banner',
    creative_slot: 'homepage_hero',
    promotion_id: 'PROMO-SPRING-2026',
    promotion_name: 'Spring Sale 2026',
    items: [{
      item_id: 'SKU-001',
      item_name: 'Running Shoes',
      price: 89.99,
      discount: 15.00,
    }],
  },
});

select_promotion

Aktivizējiet šo notikumu, kad lietotājs noklikšķina uz akcijas, lai uzzinātu vairāk vai izmantotu piedāvājumu.

dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'select_promotion',
  ecommerce: {
    creative_name: 'Spring Banner',
    creative_slot: 'homepage_hero',
    promotion_id: 'PROMO-SPRING-2026',
    promotion_name: 'Spring Sale 2026',
    items: [{
      item_id: 'SKU-001',
      item_name: 'Running Shoes',
      price: 89.99,
    }],
  },
});

Migrācija no Google Analytics

ClearAnalytics ir izstrādāts, lai darbotos līdzās Google Analytics vai kā tā aizstājējs. Migrācijas laikā abus rīkus var darbināt paralēli bez konfliktiem.

Abu skriptu paralēla darbināšana

Pievienojiet ClearAnalytics skriptu līdzās esošajam Google Analytics tagam. Abi skripti izsekos neatkarīgi, netraucējot viens otru.

<!-- Google Analytics (existing) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXX"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', 'G-XXXXXXX');
</script>

<!-- ClearAnalytics (add this line) -->
<script defer src="https://clearanalytics.eu/js/ca-events.js" data-ca-datalayer></script>

Funkciju saderība

Kā ClearAnalytics funkcijas atbilst Google Analytics ekvivalentiem:

Funkcija	Google Analytics	ClearAnalytics
Lapu skatījumi	`gtag('event', 'page_view')`	Automātiski
Pielāgoti notikumi	`gtag('event', ...)`	`window.ca('event')`
E-komercija	`dataLayer.push()`	Saderīgs ar dataLayer
UTM kampaņas	Automātiski	Automātiski
Sesijas	Balstīts uz sīkdatnēm	Bez sīkdatnēm

Migrācijas soļi

Pievienojiet ClearAnalytics skriptu savai vietnei līdzās Google Analytics.
Iespējojiet dataLayer pārtveršanu ar data-ca-datalayer, lai tvertu esošos e-komercijas notikumus.
Salīdziniet datus abos vadības paneļos 2-4 nedēļas, lai pārbaudītu precizitāti.
Kad esat apmierināts, noņemiet Google Analytics skriptu un baudiet ātrāku, privātumam draudzīgu iestatījumu.

SPA atbalsts

ClearAnalytics automātiski nosaka klienta puses navigāciju vienas lapas lietotnēs. Nav nepieciešama papildu konfigurācija vai maršrutētāja integrācija.

Kā tas darbojas

Skripts pārtver pārlūka History API izsaukumus lapas navigācijas noteikšanai:

history.pushState() izsaukumi tiek pārtvērti un aktivizē jaunu lapu skatījumu.
history.replaceState() izsaukumi tiek pārtvērti un aktivizē jaunu lapu skatījumu.
popstate notikumi (pārlūka atpakaļ/uz priekšu) aktivizē jaunu lapu skatījumu.

Saderīgi ietvari

Darbojas uzreiz ar jebkuru ietvaru, kas izmanto History API maršrutēšanai:

React Next.js Vue.js Nuxt Svelte SvelteKit Angular Remix Astro Inertia.js

Nav nepieciešami maršrutētāja spraudņi, dzīves cikla āķi vai manuāli izsekošanas izsaukumi. Vienkārši pievienojiet script tagu vienu reizi, un katra lapas navigācija tiek izsekota automātiski.

Privātums un atbilstība

ClearAnalytics ir veidots ar privātumu centrā. Izsekošanas skripts vāc tikai anonīmus, apkopotus datus. Personiskā informācija nekad netiek glabāta vai pārsūtīta.

Bez sīkdatnēm

Skripts neuzstāda, nelasa un nav atkarīgs no pārlūka sīkdatnēm. Nav nepieciešams sīkdatņu piekrišanas baneris.

Bez pirkstu nospiedumiem

Mēs nekad neveidojam pārlūka pirkstu nospiedumus. Netiek izmantotas canvas, WebGL, fontu vai audio pirkstu nospiedumu tehnikas.

Bez IP glabāšanas

Apmeklētāju IP adreses tiek izmantotas tikai anonimizētai jaukšanai pieprasījuma laikā. Tās nekad netiek glabātas datubāzē.

Atbilst GDPR

Tā kā personas dati netiek vākti, ClearAnalytics neietilpst GDPR piekrišanas prasībās. Visi dati paliek ES.

Kā mēs anonimizējam apmeklētājus

Lai skaitītu unikālos apmeklētājus, neglabājot personas datus, mēs izmantojam ikdienas rotējošu anonīmu jaucējkodu:

Apmeklētāja IP adrese un User-Agent tiek apvienots ar ikdienas rotējošu sāli.
Šī kombinācija tiek jaukta ar vienvirziena SHA-256 algoritmu.
Sāls rotē ik pēc 24 stundām, padarot neiespējamu apmeklētāju izsekošanu starp dienām.
Sākotnējā IP adrese nekad netiek glabāta vai reģistrēta.

Skripta vāktie dati

Ar katru lapu skatījuma notikumu tiek nosūtīti šādi nepersoniski datu lauki:

Lauks	Mērķis
`pathname`	Apmeklētās lapas URL ceļš.
`referrer`	Novirzītāja lapas URL, ja ir.
`language`	Pārlūka valodas iestatījums.
`screen_width / screen_height`	Ekrāna izmēri ierīces tipa klasifikācijai.
`utm_*`	Kampaņu izsekošanas parametri no URL.
`duration`	Lapā pavadītais laiks sekundēs.

Tā kā ClearAnalytics nekad nevāc personas datus, jums nav nepieciešams sīkdatņu piekrišanas baneris, privātuma uznirstošais logs vai opt-in mehānisms, lai izmantotu mūsu izsekošanas skriptu. Tas ir uzreiz atbilstošs GDPR, ePrivacy, PECR un CCPA.