Attribuire conversioni e vendite

Una conversione è una vendita o un pagamento di un sostenitore che LinkHarbor può attribuire a un clic sulla tua pagina. Così vedi non solo quante volte è stato cliccato un link, ma anche cosa ne è risultato. Questo articolo è per i creator con un proprio shop e per gli sviluppatori che collegano lo shop. Puoi analizzare le conversioni e creare secret di callback a partire da Creator Pro.

#Da dove arrivano le conversioni

• Vendite che il tuo shop o il tuo server segnala tramite un callback di vendita
• Pagamenti dei sostenitori tramite Stripe; un rimborso rimuove di nuovo la conversione, vedi Pagamenti dei sostenitori con Stripe

Ogni conversione eredita i dati del clic a cui appartiene: pagina, link, paese, dispositivo, referrer e parametri UTM. Per questo compare nelle statistiche esattamente dove è nato il clic.

#Come funziona l’attribuzione

1. Un visitatore clicca su un link della tua pagina
2. LinkHarbor conta il clic e, durante il reindirizzamento, aggiunge all’URL di destinazione il parametro lt_click_id con un click ID univoco
3. La tua pagina di destinazione (per esempio lo shop) legge lt_click_id dall’indirizzo e lo conserva fino all’acquisto
4. Dopo l’acquisto, il tuo server invia a LinkHarbor un callback di vendita con questo click ID
5. La conversione compare nella dashboard e nelle statistiche della pagina

Il click ID viene aggiunto solo alle destinazioni che iniziano con http:// o https://. I link a mailto: o tel: non lo ricevono, perché lì il parametro altererebbe l’oggetto o il numero di telefono. Nemmeno i clic dei bot ricevono un click ID.

#Creare un secret di callback

Un callback di vendita deve identificarsi con un secret di callback. Proprietari e admin gestiscono i secret a partire da Creator Pro in «Callback e API», nella sezione account del menu.

1. Apri «Callback e API»
2. Nella scheda «Secret di callback», clicca su «+ Crea nuovo secret»
3. Facoltativamente inserisci un nome, per esempio «Callback negozio»
4. Clicca su «Crea secret»
5. Copia subito il secret: viene mostrato una sola volta

«Modifica»

Cambia il nome e lo stato («Attivo» o «Inattivo»). Un secret inattivo viene rifiutato.

«↺ Rigenera»

Crea un nuovo secret. Quello vecchio smette subito di funzionare – quindi inserisci immediatamente quello nuovo nel tuo shop.

«Elimina»

Rimuove il secret dopo una richiesta di conferma.

«Ultimo callback:»

Mostra quando il secret è stato usato l’ultima volta, altrimenti «Non ancora utilizzato».

Puoi creare fino a 5 secret di callback per workspace.

#Inviare il callback di vendita

Il tuo server invia una richiesta POST all’API di LinkHarbor. Il secret va nell’header X-Callback-Secret.

curl -X POST https://dock.at-harbor.com/v1/callbacks/sale \
  -H "Content-Type: application/json" \
  -H "X-Callback-Secret: YOUR_CALLBACK_SECRET" \
  -d '{
    "click_id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a23",
    "order_id": "B-10042",
    "amount": "49.90",
    "currency": "EUR"
  }'

click_id

Obbligatorio. Il click ID da lt_click_id (10–36 caratteri).

order_id

Obbligatorio. Il tuo numero d’ordine (1–128 caratteri). Per ogni numero d’ordine viene contata una sola conversione, quindi un callback ripetuto non ne crea una seconda.

amount

Obbligatorio. L’importo come numero decimale.

currency

Obbligatorio. Un codice valuta di 3 lettere, per esempio EUR.

occurred_at, meta

Facoltativi. Il momento dell’acquisto e fino a 50 chiavi personalizzate (1–64 caratteri ciascuna) con informazioni aggiuntive. Un valore è un testo di al massimo 500 caratteri, un numero, true/false o null; l’API rifiuta gli oggetti annidati.

Risposte

Tutti i campi e i codici di errore per gli sviluppatori si trovano in Inviare vendite e dati propri.

#Analizzare le conversioni

• Dashboard: i riquadri «Conversioni» e «CVR» e la scheda «Conversioni» per sorgente e medium UTM
• Statistiche della pagina: la scheda «Conversioni» con «CVR totale», «CVR univoco» e «Ripartizione»
• CVR totale = conversioni divise per clic; CVR univoco = conversioni divise per clic univoci