Blog / Tracking

Configurazione del Postback S2S: Una Guida in 5 Minuti per Affiliati

Da zero al tracking di conversioni reali: niente SDK, niente pixel, solo un URL postback server-to-server e le macro giuste.

Cos'è un postback S2S

Un postback server-to-server è una semplice richiesta HTTP che la tua rete affiliata invia al tracker quando avviene una conversione. Nessun JavaScript viene eseguito nel browser del visitatore, quindi ad blocker, regole sui cookie e velocità della pagina non lo influenzano. Per questo è il metodo predefinito per contare le conversioni nell'affiliate marketing.

Come viaggia il click ID

  1. Un visitatore clicca sul tuo annuncio e atterra sul tuo link di tracciamento. Il tracker registra il click e gli assegna un click ID univoco.
  2. Il tracker reindirizza il visitatore all'offerta e trasmette il click ID, ad esempio come ?sub_id=….
  3. La rete memorizza quel valore insieme al visitatore. Quando il visitatore converte, la rete chiama il tuo postback URL con lo stesso valore.
  4. Il tracker abbina il click ID al click originale e aggiunge la conversione e il payout alla campagna, allo stream, alla landing page e all'offerta che l'hanno generata.
Se il click ID non raggiunge mai la rete, nessun postback può essere abbinato. Nove volte su dieci, i ticket per «conversioni mancanti» dipendono proprio da questo passaggio.

Configurazione in XPNSR Tracker

1. Passa il click ID all'offerta

Imposta il parametro di inoltro del click ID della campagna (ad esempio clickid) e il tracker lo aggiunge automaticamente a ogni URL dell'offerta, oppure inserisci la macro nell'URL dell'offerta manualmente:

https://offer.example/landing?sub_id={click_id}&country={country_code}

Usa il nome del parametro che la tua rete si aspetta: sub_id, aff_sub, s2 e così via. I 331 preset di reti affiliate presenti nel tracker li conoscono già.

2. Fornisci alla rete il tuo postback URL

https://your-tracking-domain/api/postback?click_id={clickid}&revenue={payout}&status=lead

Sostituisci i valori tra parentesi graffe con le macro della tua rete. Nella dashboard della rete, questo campo si chiama di solito Postback, S2S o Server callback.

ParametroSignificato
click_id o subidIl click ID generato dal tracker (obbligatorio)
revenue o payoutPayout per la conversione
statuslead, sale o rejected, mappati sui tuoi tipi di conversione
currencyValuta del payout, se diversa da USD
tidTransaction ID, per più conversioni su un singolo click

Mettere in sicurezza il postback

Chiunque conosca l'URL potrebbe inviare conversioni false. Ogni campagna ha un segreto postback: aggiungi &token=YOUR_SECRET all'URL (oppure invialo come header X-Postback-Token) e attiva Richiedi token. Puoi anche limitare i postback agli indirizzi IP della rete. I postback duplicati per la stessa conversione vengono ignorati.

Test e risoluzione dei problemi

  1. Apri tu stesso il tuo link di tracciamento e completa una conversione di test, oppure usa il postback di test della rete.
  2. Apri il Log Click nel tracker e trova il tuo click: la conversione vi appare in pochi secondi.
  • Non arriva nulla: controlla l'URL nella rete per eventuali errori di battitura e verifica che i nomi delle macro corrispondano esattamente alla documentazione della rete.
  • Arriva ma non corrisponde: il click ID non è stato passato all'offerta. Apri l'URL dell'offerta da un click di test e cercalo.
  • Importi errati: invia il payout come numero semplice, senza il simbolo della valuta; usa currency per i payout non in USD.
  • Errori 401: il token è assente o errato mentre Richiedi token è attivo.

Provalo sul tuo traffico.

XPNSR Tracker: click illimitati su ogni piano, 7 giorni di prova su Start e Pro.