Il tracciamento tramite postback consente a HilltopAds di inviare notifiche sugli eventi direttamente al tuo sistema di tracciamento. In questo modo puoi associare impressioni, clic e conversioni ai tuoi dati e visualizzare gli importi dei guadagni, se questa opzione è configurata.
Che cos’è un postback per i publisher e come si utilizza su HilltopAds?
Un postback è una richiesta da server a server che HilltopAds invia al tuo endpoint di tracciamento ogni volta che si verifica un evento che soddisfa i criteri di notifica.
A seconda della configurazione, un postback può notificarti:
Un’impressione conteggiata per il traffico popunder o un clic conteggiato su un annuncio display.
Una conversione.
Il guadagno generato da un evento, se includi il relativo segnaposto.
Quando ricevi un postback relativo a un’impressione o a un clic, significa che quell’evento è stato conteggiato. I dati sui guadagni mostrano le tue entrate derivanti dalle impressioni CPM o dalle conversioni CPA.
Nota: I postback non segnalano le impressioni perse o filtrate. Le notifiche che ricevi dipendono dagli eventi selezionati e dalla percentuale di invio concordata con il tuo account manager.
Come configurare il tracciamento tramite postback
Il tuo account manager di HilltopAds configurerà l’integrazione per te. Prima di iniziare, prepara il tuo endpoint di postback e decidi quali eventi vuoi monitorare.
1. Invia l’URL di postback al tuo account manager
Condividi l’endpoint sul quale il tuo sistema di tracciamento riceve le notifiche degli eventi. Ad esempio:
https://website.com/postback?click_uuid={externalid}&payout={payout}&uid=uidIn questo esempio:
click_uuidè il parametro utilizzato dal tuo sistema di tracciamento per ricevere l’identificativo.{{clickId}}viene sostituito con l’identificativo univoco trasmesso tramite il link di monetizzazione di HilltopAds.{{payout}}viene sostituito con l’importo del guadagno associato all’evento segnalato.uidè l’ID del tuo account publisher. Puoi trovarlo nella dashboard.
Il tuo endpoint potrebbe utilizzare nomi di parametri diversi. Invia al tuo account manager l’URL esatto richiesto dal tuo sistema di tracciamento, affinché possa verificare la corrispondenza tra parametri e valori.
Se il tuo endpoint richiede valori aggiuntivi, come un ID utente, concorda con il tuo account manager come associarli prima della configurazione.
2. Scegli quali eventi ricevere
HilltopAds offre le seguenti opzioni di notifica:
Impressioni o clic
Viene inviato un postback quando viene conteggiata un’impressione popunder o un clic su un annuncio display.
Il postback conferma che l’evento è stato conteggiato.
Esempio:
https://website.com/postback?click_uuid={{clickId}}Solo conversioni
Viene inviato un postback quando si verifica una conversione. Questa opzione è utile per i publisher che utilizzano un link diretto.
Esempio:
https://website.com/postback?click_uuid={{clickId}}Tutti gli eventi che generano guadagni
I postback vengono inviati solo per gli eventi che generano guadagni per te.
Ad esempio, se un’impressione in una campagna CPA non genera alcun guadagno, non attiverà un postback. Se successivamente una conversione genera un guadagno, riceverai un postback per quell’evento.
Esempio:
https://website.com/postback?click_uuid={{clickId}}&payout={{payout}}Nota: Puoi utilizzare il segnaposto {{payout}} con qualsiasi opzione di notifica. L’opzione «Tutti gli eventi che generano guadagni» invia notifiche esclusivamente per gli eventi che generano un guadagno.
Tutti gli eventi
I postback vengono inviati sia per le impressioni o i clic conteggiati sia per le conversioni.
Se un’impressione o un clic porta successivamente a una conversione, riceverai due postback con lo stesso clickId: uno per l’impressione o il clic e uno per la conversione.
Esempio:
https://website.com/postback?click_uuid={{clickId}}Verifica che il tuo sistema di tracciamento possa gestire più di una notifica per lo stesso identificativo.
3. Concorda la percentuale di invio
Concorda con il tuo account manager quale percentuale degli eventi che soddisfano i criteri di notifica deve essere inviata al tuo endpoint.
L’invio può essere configurato per una parte degli eventi, ad esempio il 10% o il 100%. Il valore predefinito è solitamente il 10%, per mantenere basso il carico sul sistema.
La selezione degli eventi e la percentuale di invio sono due impostazioni separate. Scegliere «Tutti gli eventi» non significa ricevere il 100% delle notifiche. Se il campionamento è attivo, il tuo sistema di tracciamento riceverà solo la quota concordata.
Tieni conto di questa percentuale quando confronti i dati dei postback con le tue statistiche HilltopAds.
4. Aggiungi i parametri di tracciamento al tuo link di monetizzazione
Una volta configurato il postback, il tuo account manager ti fornirà un link di monetizzazione di HilltopAds e ti spiegherà quali valori di tracciamento utilizzare.
https://dengd.com/bC3aV/0.Pf3hp/vpb/m_VLJiZtD/0/3/N/T/QvwrNmTMQ/5kLbTvcJ1WNYDFAx1/NdT-Mf?clickId=PARAM_NAME&sId=PARAM_NAME
I parametri di tracciamento includono:
clickId: il tuo ID univoco dell’impressione o del clic, utilizzato per associare le notifiche di postback ai tuoi dati di tracciamento.sId: l’ID della zona pubblicitaria.
Sostituisci i valori di esempio o i segnaposto nel link di monetizzazione con i valori corretti o con le macro dinamiche del tuo sistema, seguendo le istruzioni del tuo account manager.
Il link di monetizzazione e l’URL di postback svolgono funzioni diverse:
Il link di monetizzazione invia traffico a HilltopAds.
L’URL di postback riceve le notifiche degli eventi da HilltopAds.
Utilizza sempre il link di monetizzazione fornito dal tuo account manager. Non utilizzare il tuo endpoint di postback come destinazione del traffico.
5. Verifica l’integrazione
Testa la configurazione con il tuo account manager prima di applicarla a tutto il tuo traffico. Assicurati che:
Il tuo endpoint riceva le notifiche degli eventi selezionati.
Gli identificativi ricevuti corrispondano ai tuoi dati di tracciamento.
Gli importi dei guadagni vengano ricevuti quando questa opzione è configurata.
Il tuo sistema di tracciamento possa gestire più di una notifica per lo stesso
clickIdquando utilizzi l’opzione «Tutti gli eventi».La percentuale di invio corrisponda alle impostazioni concordate.
Se hai bisogno di aiuto per configurare il postback del tuo account publisher o risolvere eventuali problemi, contatta il tuo account manager di HilltopAds.