Links

Pixel di conversione

Traccia le conversioni su pagine di destinazione che non controlli, attribuite al click e alla variante A/B di origine.

I test A/B sui link brevi possono inviare i visitatori a una pagina di destinazione che non controlli — uno storefront, un page builder, il sito di un partner. Styrar misura il click e su quale variante è arrivato il visitatore, ma non ha modo di sapere se quel visitatore ha convertito dopo il redirect.

Il pixel di conversione chiude questo ciclo. È un piccolo script che incorpori nella pagina di destinazione, che riporta le conversioni a Styrar, correlate esattamente al click (e alla variante A/B) che ha inviato lì il visitatore.

Come funziona

Quando un link breve reindirizza un visitatore, Styrar aggiunge un token styrar_ck a uso singolo all'URL di destinazione.
Lo script del pixel su quella pagina legge il token dall'URL (o da localStorage, così sopravvive a ulteriori navigazioni sul tuo sito) e lo tiene pronto per essere inviato con qualsiasi evento.
Chiami window.styrar.track(eventName, data) — oppure aggiungi un attributo data-styrar-track — quando un visitatore fa qualcosa che vale la pena contare (si registra, completa un checkout, inizia una prova).
Styrar risolve il token riconducendolo al link originale e alla variante A/B, e la conversione appare nel pannello dell'esperimento di quel link.

Non c'è alcun account id, site id o API key da configurare. Il token stesso è l'unica cosa che lega un evento al tuo workspace, ed è limitato a un singolo click.

Configurare un pixel di conversione

1. Trova il tuo snippet di incorporamento

Apri il pannello Avanzate → Test A/B del link breve nella dashboard e avvia (o configura) un esperimento. Il pannello mostra una scheda "Traccia le conversioni sulla pagina di destinazione" con uno snippet pronto da copiare:

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. Aggiungi il tag script alla tua pagina di destinazione

Incolla il tag <script src="…/v1/pixel/styrar.js"> nella pagina su cui arrivano i visitatori dopo il redirect del link breve — nell'<head> o appena prima di </body>. Funziona su qualsiasi piattaforma (Shopify, Webflow, un sito statico, la tua app) perché il pixel e il suo endpoint di tracciamento usano una policy CORS aperta e senza cookie.

3. Contrassegna una conversione

Scegli quello che si adatta meglio alla tua pagina:

Dichiarativo, senza bisogno di JavaScript tuo:

HTML

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

Un click attiva l'evento sulla maggior parte degli elementi; su un <form> si attiva invece su submit.

Dal tuo codice, una volta che lo script è stato caricato:

HTML

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

4. Verifica che funzioni

Attiva la conversione sulla pagina di destinazione, poi apri il pannello del test A/B del link — il conteggio e il tasso di conversione della variante si aggiornano non appena l'evento arriva.

Valori di conversione personalizzati

window.styrar.track(eventName, data) accetta qualsiasi nome di evento e un oggetto data opzionale:

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>

Campo	Tipo	Comportamento
`eventName`	string	Obbligatorio. Fino a 64 caratteri — usa qualsiasi cosa si adatti al tuo funnel: `signup`, `add_to_cart`, `purchase`, ecc.
`value`	number	Salvato solo se è un `number` JS (ad esempio il ricavo dell'ordine). Qualsiasi altro tipo viene ignorato.
qualsiasi altro campo su `data`	qualsiasi valore JSON	Salvato insieme all'evento (fino a 4 KB serializzati). I payload più grandi vengono scartati, non troncati.

Non c'è uno schema da registrare in anticipo — chiama track() con qualsiasi forma sensata per la tua pagina, e viene conservata insieme all'evento.

Segnalare conversioni dal tuo server

Se la conversione avviene lato server (ad esempio un webhook dal tuo fornitore di pagamenti) invece che nel browser, leggi il parametro styrar_ck dalla richiesta originale e inviala direttamente:

RequestPOST

Content-Type: application/json

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

Response200 OK

{
  "ok": true
}

Questa è la stessa richiesta non autenticata che fa il pixel del browser. Non c'è una API key — il clickToken è limitato a un singolo uso su un singolo click e non è enumerabile, quindi funge anche da credenziale.

Riferimento 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

Body di POST /v1/pixel/track:

Campo	Obbligatorio	Descrizione
`clickToken`	Sì	Il valore `styrar_ck` dall'URL di destinazione o da `localStorage`
`eventName`	Sì	Fino a 64 caratteri
`value`	No	Numero, ad esempio il valore dell'ordine
`eventData`	No	Oggetto JSON arbitrario, fino a 4 KB serializzati
`pageUrl`	No	Fino a 2048 caratteri; lo script invia automaticamente `window.location.href`

L'endpoint risponde sempre 200 { "ok": true } — anche per un clickToken non riconosciuto o scaduto — così il pixel non mostra mai un errore su una pagina che non controlli del tutto.

Privacy e sicurezza

Il pixel invia solo il token di click, il nome/valore/dati dell'evento che gli passi e l'URL della pagina corrente. Non sono coinvolti cookie, fingerprinting o identificatori cross-site.
/v1/pixel/track ha un rate limit per IP (120 richieste/minuto) per assorbire gli abusi senza influire sul traffico normale.
clickToken è un identificatore casuale, limitato a un singolo uso — non può essere indovinato dal codice breve di un link o da qualsiasi altro valore pubblico.

Limiti

Il tracciamento delle conversioni richiede che sia configurato un test A/B sul link; la conversione viene attribuita a qualsiasi variante fosse mostrata al visitatore al momento del click.
Non c'è tracciamento automatico delle visualizzazioni di pagina — il pixel riporta solo gli eventi che attivi esplicitamente, per mantenere basso il rumore e il volume di richieste.
Non c'è ancora un endpoint di esportazione o eliminazione bulk per gli eventi di conversione; contattaci se hai bisogno della rimozione dei dati per un workspace specifico.

Correlati

Webhook — ricevi una notifica quando un test A/B viene completato tramite link.experiment.completed
Link brevi e codici QR nel centro assistenza
Tracker della pagina bio — Google Analytics, Meta, GTM e altro sulla tua pagina bio
Installare questo pixel per piattaforma: Shopify · WordPress · Wix · Framer · Lato server