Jeden skript na každej stránke

1. 1V appke vytvor projekt pre svoj web. Dostane ID projektu v tvare conseto_tvojweb_abc123_def4.
2. 2Otvor Nastavenia, potom Inštalácia. Skript tam už má tvoje ID a tlačidlo na skopírovanie.
3. 3Vlož ho raz do každej stránky, tesne pred </head>.

Toto je celá inštalácia. ID nahraď svojím.

<script src="https://www.conseto.io/dist/conseto.min.js"></script>
<script>
  Conseto.init({ clientId: 'conseto_xxx_xxx' });
</script>

Čisté HTML alebo vlastná šablóna

Vlož skript pred koncovú značku head v šablóne, ktorú používa každá stránka.

WordPress

Stiahni si náš plugin v appke (Nastavenia, Inštalácia), nahraj ho v časti Pluginy, Pridať nový, Nahrať plugin, aktivuj ho a v jeho nastaveniach vlož ID projektu. Ak chceš posielať nákupy a vrátenia z WooCommerce zo servera, vlož tam aj API kľúč. Bez pluginu vlož skript do súboru header.php svojej témy. Plugin nie je na wordpress.org.

Shopify

Aplikácia v Shopify App Store zatiaľ nie je. V administrácii Shopify otvor Online obchod, Témy, Upraviť kód, otvor súbor theme.liquid a vlož skript pred koncovú značku head.

Next.js

Skript načítaj cez next/script a funkciu init zavolaj v onLoad. Takto ho načíta conseto.io.

Jednostránkové appky

Vlož značku skriptu do hlavnej HTML šablóny appky a init zavolaj raz. Skript sleduje zmeny stránky cez históriu prehliadača aj tlačidlo späť, takže započíta každú stránku, ktorú návštevník uvidí. Otestovali sme Next.js (tento web); pri iných frameworkoch je to ten istý skript a nič viac.

Google Tag Manager

Conseto vie načítať tvoj kontajner GTM za teba: pridaj jeho ID do funkcie init a kód kontajnera už nevkladaj druhýkrát. Vloženie skriptu Conseto do GTM ako vlastnej HTML značky sme netestovali, preto ho neodporúčame.

Google Analytics 4

ID merania zadaj v nastaveniach projektu v appke alebo ho pošli do funkcie init ako v ukážke. Skript načíta GA4 a Google Consent Mode ho drží potichu, kým sa návštevník nerozhodne.

"use client";

import Script from "next/script";

declare global {
  interface Window {
    Conseto: { init: (config: { clientId: string }) => Promise<unknown> };
  }
}

// Next.js inlines NEXT_PUBLIC_* at BUILD time: set it in the hosting project
// before the build, or every visitor gets undefined.
const CLIENT_ID = process.env.NEXT_PUBLIC_CONSETO_CLIENT_ID;

export function ConsetoInit() {
  if (!CLIENT_ID) return null;

  return (
    <Script
      src="https://www.conseto.io/dist/conseto.min.js"
      strategy="afterInteractive"
      onLoad={() => {
        void window.Conseto.init({ clientId: CLIENT_ID });
      }}
    />
  );
}

<script src="https://www.conseto.io/dist/conseto.min.js"></script>
<script>
  Conseto.init({
    clientId: 'conseto_xxx_xxx',
    gtm: 'GTM-XXXXXXX'
  });
</script>

<script src="https://www.conseto.io/dist/conseto.min.js"></script>
<script>
  Conseto.init({
    clientId: 'conseto_xxx_xxx',
    ga4: 'G-XXXXXXXXXX'
  });
</script>

1. 1Otvor svoj web v bežnom okne prehliadača. Pri prvej návšteve sa ukáže cookie banner, ak si neotvoril odkaz s vlastnými návštevami alebo ak krajina návštevníka banner nevyžaduje (pozri stránku o cookie banneri).
2. 2V appke Nastavenia, Inštalácia každých 5 sekúnd kontroluje, či prichádzajú udalosti, a prvú návštevu ukáže do minúty.
3. 3Použi kontrolu webu na tej istej stránke: appka otvorí tvoju adresu ako bežný návštevník a povie, čo chýba (stránka sa načítala, je na nej skript, spustil sa, posiela dáta, dáta patria tomuto projektu, banner sa ukázal). Samotná kontrola sa do tvojich čísel nezapočíta.