Links

Konverzijski piksel

Pratite konverzije na odredišnim stranicama koje ne kontrolirate, pripisane izvornom kliku i A/B varijanti.

A/B testovi kratkih poveznica mogu slati posjetitelje na odredišnu stranicu koju ne kontrolirate - prodavaonicu, landing stranicu izrađenu drugim alatom, stranicu partnera. Styrar mjeri klik i koju je varijantu posjetitelj vidio, ali nema način da zna je li taj posjetitelj konvertirao nakon preusmjeravanja.

Konverzijski piksel zatvara tu rupu. To je mala skripta koju ugrađujete na odredišnu stranicu koja prijavljuje konverzije natrag Styraru, povezane s točnim klikom (i A/B varijantom) koja je posjetitelja onamo poslala.

Kako funkcionira

Kada kratka poveznica preusmjeri posjetitelja, Styrar dodaje jednokratni token styrar_ck na odredišni URL.
Skripta piksela na toj stranici čita token iz URL-a (ili localStorage, tako da preživi dodatnu navigaciju na vašoj stranici) i drži ga spremnim za slanje s bilo kojim događajem.
Pozivate window.styrar.track(eventName, data) - ili dodajete atribut data-styrar-track - kada posjetitelj učini nešto vrijedno bilježenja (registrira se, plaća, započinje probu).
Styrar razrješava token natrag na izvornu poveznicu i A/B varijantu, i konverzija se prikazuje u panelu eksperimenta te poveznice.

Nema id-a računa, id-a stranice, ni API ključa za konfiguriranje. Sam token je jedina stvar koja povezuje događaj natrag s vašim radnim prostorom, i ograničen je na jedan klik.

Postavljanje konverzijskog piksela

1. Pronađite svoj ugradni isječak

Otvorite panel Napredno → A/B test kratke poveznice u nadzornoj ploči i pokrenite (ili konfigurirajte) eksperiment. Panel prikazuje karticu "Pratite konverzije na odredišnoj stranici" sa isječkom spremnim za kopiranje:

HTML

<script src="https://api.styrar.com/v1/pixel/styrar.js" async></script>
<!-- mark a conversion -->
<button data-styrar-track="signup">Sign up</button>
<!-- or call it from your own code -->
<script>window.styrar && window.styrar.track('signup', { value: 19.99 })</script>

2. Dodajte tag skripte na svoju odredišnu stranicu

Zalijepite tag <script src="…/v1/pixel/styrar.js"> na stranicu na koju posjetitelji slijeću nakon preusmjeravanja kratke poveznice - u <head> ili tik prije </body>. Ovo radi na bilo kojoj platformi (Shopify, Webflow, statična stranica, vaša vlastita aplikacija) jer piksel i njegov endpoint za praćenje koriste otvorenu, bez kolačića CORS politiku.

3. Označite konverziju

Odaberite što odgovara vašoj stranici:

Deklarativno, bez vlastitog JavaScripta:

HTML

<button data-styrar-track="signup">Sign up</button>
<form data-styrar-track="checkout_complete">…</form>

click okida događaj na većini elemenata; na <form> okida se na submit umjesto toga.

Iz vašeg vlastitog koda, nakon što se skripta učita:

HTML

<script>
  window.styrar && window.styrar.track('purchase', { value: 49.99 })
</script>

4. Potvrdite da radi

Pokrenite konverziju na odredišnoj stranici, zatim otvorite panel A/B testa poveznice - broj konverzija i stopa varijante ažuriraju se kad događaj stigne.

Prilagođene vrijednosti konverzije

window.styrar.track(eventName, data) prima bilo koji naziv događaja i opcijski objekt data:

HTML

<script>
  window.styrar.track('purchase', {
    value: 49.99,          // numeric — stored as the event's value
    plan: 'pro_annual',    // any other field is stored alongside the event
    currency: 'USD',
  })
</script>

Polje	Tip	Ponašanje
`eventName`	string	Obavezno. Do 64 znaka - koristite što god odgovara vašem funnelu: `signup`, `add_to_cart`, `purchase`, itd.
`value`	number	Pohranjuje se samo ako je JS `number` (npr. prihod narudžbe). Sve ostalo se zanemaruje.
bilo koje drugo polje na `data`	bilo koja JSON vrijednost	Pohranjuje se uz događaj (do 4 KB serijalizirano). Veći tereti se odbacuju, ne skraćuju.

Nema sheme za registriranje unaprijed - pozovite track() s bilo kojim oblikom koji ima smisla za vašu stranicu, i čuva se uz događaj.

Prijavljivanje konverzija s vašeg poslužitelja

Ako se konverzija dogodi na poslužiteljskoj strani (webhook od vašeg pružatelja plaćanja, na primjer) umjesto u pregledniku, pročitajte parametar styrar_ck s izvornog zahtjeva i pošaljite ga direktno:

RequestPOST

Content-Type: application/json

{
  "clickToken": "the styrar_ck value",
  "eventName": "purchase",
  "value": 49.99
}

Response200 OK

{
  "ok": true
}

Ovo je isti neautenticirani zahtjev koji piksel u pregledniku radi. Nema API ključa - clickToken je ograničen na jednokratnu upotrebu jednog klika i nije nabrojiv, tako da služi i kao vjerodajnica.

API referenca

Plain text

GET  /v1/pixel/styrar.js   # the embeddable script, no auth required
POST /v1/pixel/track        # records a conversion event, no auth required

Tijelo POST /v1/pixel/track:

Polje	Obavezno	Opis
`clickToken`	Da	Vrijednost `styrar_ck` s odredišnog URL-a ili `localStorage`
`eventName`	Da	Do 64 znaka
`value`	Ne	Broj, npr. vrijednost narudžbe
`eventData`	Ne	Arbitraran JSON objekt, do 4 KB serijalizirano
`pageUrl`	Ne	Do 2048 znakova; skripta automatski šalje `window.location.href`

Endpoint uvijek odgovara 200 { "ok": true } - uključujući za neprepoznat ili istekao clickToken - tako da piksel nikada ne pokazuje pogrešku na stranici koju ne kontrolirate potpuno.

Privatnost i sigurnost

Piksel šalje samo token klika, naziv/vrijednost/podatke događaja koje mu proslijedite, i trenutni URL stranice. Nema kolačića, otisaka prsta, ili identifikatora preko stranica.
/v1/pixel/track je ograničen po brzini po IP-u (120 zahtjeva/minuta) za apsorbiranje zlouporabe bez utjecaja na normalan promet.
clickToken je nasumičan identifikator ograničen na jednokratnu upotrebu - ne može se pogoditi iz kratkog koda poveznice ili bilo koje druge javne vrijednosti.

Ograničenja

Praćenje konverzija zahtijeva da je A/B test konfiguriran na poveznici; konverzija se pripisuje varijanti koja je posjetitelju prikazana u trenutku klika.
Nema automatskog praćenja pregleda stranice - piksel prijavljuje samo događaje koje eksplicitno pokrenete, da bi se smanjio šum i volumen zahtjeva.
Još nema endpointa za masovni izvoz ili brisanje konverzijskih događaja; javite nam se ako trebate uklanjanje podataka za određeni radni prostor.

Povezano

Webhookovi - primite obavijest kada se A/B test dovrši putem link.experiment.completed
Kratke poveznice i QR kodovi u centru za pomoć
Pratitelji bio stranice - Google Analytics, Meta, GTM, i više na vašoj bio stranici
Instaliranje ovog piksela po platformi: Shopify · WordPress · Wix · Framer · Poslužiteljska strana