Conversioni e ricavi

Il tracciamento delle conversioni chiude il cerchio tra un clic e il denaro che ha prodotto. Il redirector rilascia un identificatore firmato a ogni reindirizzamento; il tuo server o la tua pagina di ringraziamento lo rimanda indietro insieme a un ordine; ogni dettaglio che già leggi guadagna una colonna dei ricavi.

Le conversioni sono una funzione a pagamento. Quando il piano non le include, il redirector smette del tutto di rilasciare identificatori, ed entrambe le vie di ingresso rifiutano le conversioni con una limitazione di piano.

L'identificatore di clic

A ogni reindirizzamento il worker rilascia un token e:

• lo aggiunge all'indirizzo di destinazione sotto un nome di parametro che scegli tu (lp_cid per impostazione predefinita);
• lo scrive in un cookie di prima parte sul tuo dominio di reindirizzamento, valido per 90 giorni.

È il cookie a far sopravvivere l'attribuzione nei browser che non accettano più nulla di terze parti: lo imposta il tuo dominio, non il nostro.

Il token è firmato e legato al tenant: gli identificatori dell'area di lavoro e del partner fanno parte del payload firmato, quindi un token rilasciato sul link di un cliente viene respinto nell'area di lavoro di un altro cliente esattamente come un falso. Non porta alcun dato personale: il momento del clic, il link, la variante di split, il paese, la classe di dispositivo, la sorgente di traffico e un contrassegno per il traffico sospetto.

Sia il nome del parametro sia l'interruttore di attivazione stanno in Conversioni → Impostazioni. Cambiare l'uno o l'altro riscrive immediatamente la configurazione in cache di ogni link.

La finestra di attribuzione

Una conversione che arriva oltre la finestra viene rifiutata con attribution_expired, un codice distinto da invalid_click_id, così un'integrazione distingue «troppo tardi» da «identificatore rotto» senza tirare a indovinare. La finestra è un'impostazione della singola area di lavoro.

Obiettivi

Un obiettivo è un esito con un nome: purchase, signup, trial. Gli obiettivi possono portare un valore predefinito e una valuta, usati quando una conversione arriva senza importo. Un obiettivo richiamato da una conversione ma non ancora esistente viene creato al primo utilizzo, così un'integrazione non deve essere configurata in due posti.

Inviare le conversioni

Dal tuo server

curl -X POST https://api.linkprofit.com/v1/conversions \
  -H "Authorization: Bearer lp_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-10241" \
  -d '{
    "click_id": "1.eyJ1aWQiOiJ...",
    "goal": "purchase",
    "order_id": "10241",
    "amount_cents": 4999,
    "currency": "usd"
  }'

La chiave deve avere l'ambito conversions:write. Gli importi sono unità minime intere: centesimi, penny, copechi. Un importo di 49.99 viene rifiutato indicando il campo, invece di essere arrotondato in silenzio, perché una regola di arrotondamento inventata in mezzo a un percorso di pagamento è esattamente il modo in cui i report dei ricavi smettono di combaciare con le fatture.

Dal browser

Il worker serve un piccolo script dal tuo stesso dominio di reindirizzamento:

<script src="https://go.example.com/cv.js" defer></script>
<script>
  window.lpConversion({ goal: 'purchase', orderId: '10241', amountCents: 4999, currency: 'usd' });
</script>

Lo script legge l'identificatore dall'URL oppure dal cookie di prima parte. In tutta la catena non c'è nessun host di terze parti, il che è insieme una proprietà di privacy e una proprietà white-label: la pagina del tuo cliente non carica nulla che nomini la piattaforma.

Duplicati

La deduplicazione è un singolo inserimento atomico, non una lettura seguita da una scrittura. Consegne ripetute dello stesso order_id creano una sola conversione e la restituiscono contrassegnata come duplicato: è esattamente questo che rende sicuro, e non pericoloso, ripetere un webhook fallito.

Conversioni sospette

Il verdetto del classificatore viaggia dentro il token, quindi una conversione attribuita a un datacenter o a un proxy viene contrassegnata come sospetta nel momento in cui viene registrata. Nei report compare come segmento a sé, invece di essere eliminata o mescolata in silenzio. «Duecento conversioni» e «duecento conversioni, quaranta delle quali da un unico intervallo di hosting nell'arco di un'ora» sono fatti diversi.

Dove vanno poi le conversioni

• Viene emesso un evento webhook firmato conversion.created attraverso la normale macchina dei webhook: coda, firma, calendario dei nuovi tentativi, cron di recupero.
• Le integrazioni pubblicitarie configurate ricevono la conversione tramite una coda di consegna con un contatore di tentativi incrementato prima della chiamata in uscita, un backoff documentato e un contrassegno di rinuncia al posto di tentativi infiniti.

Quota mensile

Un piano può limitare il numero di conversioni accettate per mese di calendario, contate in UTC. Superato il tetto, l'ingresso risponde quota_exceeded, un codice distinto da una limitazione di piano, così la differenza tra «non è nel tuo piano» e «esaurita questo mese» si vede senza aprire un ticket al supporto.