Monitoraggio delle conversioni

Elido monitora due aspetti di un link breve: il clic (quando qualcuno segue il link) e la conversione (quando quella stessa persona compie un'azione di valore sul tuo sito successivamente). Il monitoraggio delle conversioni collega i due eventi, permettendoti di vedere non solo quali link generano traffico, ma quali generano risultati.

Cosa conta come conversione#

Una conversione è qualsiasi evento da te definito: un acquisto, una registrazione, l'invio di un modulo, l'inizio di una prova. Elido non impone una definizione specifica. Invia un evento di conversione quando l'azione avviene; noi lo attribuiremo al clic che ha portato l'utente.

La dashboard delle conversioni in Analytics → Conversions mostra:

• Conversioni totali e ricavi totali attribuiti.
• Conversioni suddivise per link, campagna, giorno e piattaforma.
• Una tabella dei singoli eventi di conversione recenti con l'email del cliente e il ricavo.

Configurare un evento di conversione#

Opzione 1: chiamata API lato server#

Il metodo più affidabile. Quando un utente completa un'azione sul tuo backend, invia una POST all'endpoint delle conversioni:

curl -X POST https://api.elido.app/v1/conversions \
  -H "Authorization: Bearer $ELIDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": 42,
    "platform": "stripe",
    "customer_email": "[email protected]",
    "revenue_cents": 4900,
    "currency": "EUR",
    "converted_at": "2026-05-12T14:30:00Z"
  }'

Includi customer_email o click_id per l'attribuzione. Se passi un click_id (restituito negli header della risposta di reindirizzamento come X-Elido-Click-ID), l'attribuzione è esatta. Se passi solo customer_email, lo confronteremo con l'ultimo clic da quell'indirizzo entro la finestra di attribuzione.

Opzione 2: pixel lato client#

Aggiungi il pixel di Elido alla tua pagina di conferma (conferma d'ordine, successo della registrazione, ecc.):

<script>
  window.elidoConvert = window.elidoConvert || function(opts) {
    fetch('https://api.elido.app/v1/conversions/pixel', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        workspace_id: opts.workspaceId,
        platform: opts.platform || 'web',
        revenue_cents: opts.revenueCents || 0,
        currency: opts.currency || 'EUR',
      }),
      credentials: 'include',
    });
  };
</script>

Quindi richiamalo nella pagina di conferma:

<script>
  elidoConvert({
    workspaceId: 42,
    platform: 'web',
    revenueCents: 4900,
    currency: 'EUR',
  });
</script>

Il pixel utilizza un cookie del browser impostato durante il reindirizzamento per identificare il clic che ha preceduto la conversione. Funziona per percorsi sullo stesso browser e sullo stesso dispositivo. Per l'attribuzione cross-device o cross-browser, il metodo click_id lato server è più affidabile.

Finestre di attribuzione#

Per impostazione predefinita, una conversione è attribuita al clic più recente dello stesso utente entro una finestra di 30 giorni. Se lo stesso utente ha cliccato su più link in quel periodo, la conversione viene attribuita all'ultimo clic (attribuzione last-touch).

La finestra è configurabile per ogni workspace in Settings → Attribution. Le opzioni disponibili includono 1 giorno, 7 giorni, 30 giorni e 90 giorni.

Leggere la dashboard delle conversioni#

Analytics → Conversions suddivide le conversioni per:

• Platform — il campo platform che passate nella chiamata API (stripe, shopify, web, o qualsiasi etichetta scegliate).
• Top links — quali link brevi hanno generato il maggior numero di conversioni.
• Top campaigns — quali campagne hanno convertito meglio.
• Daily revenue — un grafico a barre dei ricavi attribuiti nel tempo.

Il ricavo è mostrato come la somma dei valori revenue_cents passati. Se non monitorate il ricavo (ad esempio per la generazione di lead), potete lasciare revenue_cents a 0 e utilizzare solo il conteggio delle conversioni.

Risoluzione dei problemi#

Le conversioni non appaiono. Controlla la risposta API per la tua chiamata POST /v1/conversions — l'endpoint restituisce l'ID della conversione in caso di successo e un messaggio di errore dettagliato in caso di fallimento. Problemi comuni: ID del workspace mancante, codice valuta non valido (deve essere ISO 4217, ad esempio EUR non €), o una chiave API senza il permesso conversions:write.

L'attribuzione non corrisponde ai clic previsti. Se stai usando il pixel (basato sui cookie), verifica che il browser dell'utente non stia bloccando i cookie di terze parti. L'ITP di Safari e alcuni ad blocker elimineranno il cookie prima che la pagina di conversione venga attivata. Usa il metodo click_id lato server per un'attribuzione affidabile.

I numeri dei ricavi non corrispondono al mio processore di pagamento. I numeri in Elido sono esattamente quelli che ci invii — non estraiamo dati direttamente da Stripe o da qualsiasi altro processore. In caso di discrepanza, confronta i valori revenue_cents nelle tue chiamate API di conversione con i tuoi record di pagamento.

Una conversione appare sotto il link sbagliato. L'attribuzione utilizza il last-touch per impostazione predefinita. Se un utente ha cliccato su diversi link prima di convertire, la conversione viene assegnata al clic più recente. Se l'ultimo clic proveniva da una campagna diversa, questo è il comportamento previsto. Regola la finestra di attribuzione o passa all'attribuzione first-touch nelle impostazioni se il last-touch non soddisfa le tue esigenze di reportistica.