Links

Pixel de conversie

Urmărește conversiile pe pagini de destinație pe care nu le controlezi, atribuite click-ului și variantei A/B de origine.

Testele A/B pentru linkuri scurte pot trimite vizitatorii către o pagină de destinație pe care nu o controlezi — un magazin online, un landing page builder, site-ul unui partener. Styrar măsoară click-ul și varianta pe care a aterizat vizitatorul, dar nu are nicio modalitate de a afla dacă acel vizitator a convertit după redirecționare.

Pixelul de conversie închide acea bucla. Este un script mic pe care îl inserezi pe pagina de destinație, care raportează conversiile înapoi către Styrar, corelate cu exact click-ul (și varianta A/B) care a trimis vizitatorul acolo.

Cum funcționează

Când un link scurt redirecționează un vizitator, Styrar adaugă un token de unică folosință styrar_ck la URL-ul de destinație.
Scriptul pixel de pe acea pagină citește token-ul din URL (sau din localStorage, astfel încât să supraviețuiască navigării ulterioare pe site-ul tău) și îl ține pregătit pentru a-l trimite cu orice eveniment.
Apelezi window.styrar.track(eventName, data) — sau adaugi un atribut data-styrar-track — când un vizitator face ceva ce merită contorizat (se înregistrează, finalizează o comandă, începe un trial).
Styrar rezolvă token-ul înapoi la link-ul original și varianta A/B, iar conversia apare în panoul de experiment al acelui link.

Nu există niciun ID de cont, ID de site sau cheie API de configurat. Token-ul însuși este singurul lucru care legă un eveniment de spațiul tău de lucru, și este limitat la un singur click.

Configurarea unui pixel de conversie

1. Găsește fragmentul de cod de inserare

Deschide panoul Avansat → Test A/B al link-ului scurt din dashboard și pornește (sau configurează) un experiment. Panoul arată un card „Urmărește conversiile pe pagina de destinație" cu un fragment de cod pregătit pentru copiere:

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. Adaugă tag-ul de script pe pagina ta de destinație

Inserează tag-ul <script src="…/v1/pixel/styrar.js"> pe pagina pe care aterizează vizitatorii după redirecționarea link-ului scurt — în <head> sau imediat înainte de </body>. Funcționează pe orice platformă (Shopify, Webflow, un site static, propria ta aplicație) pentru că pixelul și endpoint-ul său de urmărire folosesc o politică CORS deschisă, fără cookie-uri.

3. Marchează o conversie

Alege ce se potrivește paginii tale:

Declarativ, fără a fi nevoie de cod JavaScript propriu:

HTML

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

Un click declanșează evenimentul pe majoritatea elementelor; pe un <form> se declanșează la submit.

Din propriul tău cod, după ce scriptul s-a încărcat:

HTML

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

4. Confirmă că funcționează

Declanșează conversia pe pagina de destinație, apoi deschide panoul testului A/B al link-ului — numărul de conversii și rata variantei se actualizează imediat ce evenimentul ajunge.

Valori de conversie personalizate

window.styrar.track(eventName, data) primește orice nume de eveniment și un obiect data opțional:

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>

Câmp	Tip	Comportament
`eventName`	string	Obligatoriu. Până la 64 de caractere — folosește orice se potrivește funnel-ului tău: `signup`, `add_to_cart`, `purchase`, etc.
`value`	number	Stocat doar dacă este un `number` JS (de exemplu venitul comenzii). Orice altceva este ignorat.
orice alt câmp din `data`	orice valoare JSON	Stocat alături de eveniment (până la 4 KB serializat). Payload-urile mai mari sunt eliminate, nu trunchiate.

Nu există nicio schemă de înregistrat în avans — apelează track() cu orice formă se potrivește paginii tale, și este păstrată odată cu evenimentul.

Raportarea conversiilor de pe serverul tău

Dacă conversia se produce pe server (de exemplu un webhook de la furnizorul tău de plăți) și nu în browser, citește parametrul styrar_ck din cererea originală și trimite-l direct:

RequestPOST

Content-Type: application/json

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

Response200 OK

{
  "ok": true
}

Este aceeași cerere neautentificată pe care o face pixelul din browser. Nu există cheie API — clickToken este limitat la o singură utilizare per click și nu este enumerabil, astfel încât funcționează și ca credențial.

Referință API

Plain text

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

Corpul cererii POST /v1/pixel/track:

Câmp	Obligatoriu	Descriere
`clickToken`	Da	Valoarea `styrar_ck` din URL-ul de destinație sau din `localStorage`
`eventName`	Da	Până la 64 de caractere
`value`	Nu	Număr, de exemplu valoarea comenzii
`eventData`	Nu	Obiect JSON arbitrar, până la 4 KB serializat
`pageUrl`	Nu	Până la 2048 de caractere; scriptul trimite automat `window.location.href`

Endpoint-ul răspunde mereu cu 200 { "ok": true } — inclusiv pentru un clickToken necunoscut sau expirat — astfel încât pixelul nu afișează niciodată o eroare pe o pagină pe care nu o controlezi complet.

Confidențialitate și securitate

Pixelul trimite doar token-ul de click, numele evenimentului/valoarea/datele pe care le transmiți și URL-ul curent al paginii. Nu sunt implicate cookie-uri, fingerprinting sau identificatori cross-site.
/v1/pixel/track are o limită de rată per IP (120 de cereri/minut) pentru a absorbi abuzurile fără a afecta traficul normal.
clickToken este un identificator aleatoriu, limitat la o singură utilizare per click — nu poate fi ghicit din codul scurt al unui link sau din altă valoare publică.

Limite

Urmărirea conversiilor necesită ca un test A/B să fie configurat pe link; conversia se atribuie variantei pe care a văzut-o vizitatorul la momentul click-ului.
Nu există urmărire automată a vizualizărilor de pagină — pixelul raportează doar evenimentele pe care le declanșezi explicit, pentru a reduce zgomotul și volumul de cereri.
Nu există încă un endpoint de export sau ștergere în masă pentru evenimentele de conversie; contactează-ne dacă ai nevoie de eliminarea datelor pentru un spațiu de lucru specific.

Conexe

Webhook-uri — fii notificat când se finalizează un test A/B prin link.experiment.completed
Linkuri scurte și coduri QR în centrul de ajutor
Trackere pe pagina bio — Google Analytics, Meta, GTM și altele pe pagina ta bio
Instalarea acestui pixel pe fiecare platformă: Shopify · WordPress · Wix · Framer · Server-side